yahooquery

yahooquery 是一项基于 Python 生态的专业金融数据访问技能，通过封装 yahooquery 开源库为用户提供 Yahoo Finance 全维度数据接口。该技能不涉及本地代码执行，而是以纯文档形式提供完整的 API 使用指南，涵盖股票实时行情、财务报表、期权链、分析师评级、ESG 评分及市场新闻等核心金融数据模块。

核心用法围绕三个主类展开：Ticker 类用于获取特定证券的深度数据，支持单股或多股异步查询，可提取资产负债表、利润表、现金流量表等财务报表，以及技术指标、内部人交易、机构持仓等治理数据；Screener 类提供预置股票筛选器，支持按日涨幅、活跃度等条件发现投资机会；Research 类则为 Yahoo Finance Premium 订阅用户提供专有研究报告和交易建议。所有数据均通过 Yahoo Finance 官方 API 获取，支持多种时间周期（1分钟至10年）和价格调整选项。

显著优点在于数据覆盖的全面性与查询的灵活性。用户可通过异步模式（asynchronous=True）高效批量获取多只股票数据，利用 pandas DataFrame 直接进行数据分析。技能文档详尽列出了 50 余种数据属性，从基础价格信息到复杂的期权链数据，满足基本面分析、技术分析和量化策略开发的多元需求。此外，内置的重试机制和退避策略（retry、backoff_factor）增强了在网络不稳定环境下的可靠性。

潜在缺点与局限性主要源于外部依赖。首先，该技能仅为使用文档，实际功能完全依赖用户自行安装的 yahooquery 第三方库，版本兼容性和库维护状态不受控制。其次，Yahoo Finance 对 API 请求设有严格的频率限制，高频调用可能触发封禁，尽管文档提供了错误处理建议，但在生产环境中仍面临数据获取中断风险。更重要的是，数据准确性和时效性取决于 Yahoo Finance 的上游供应商，不应用于实时交易决策或合规性要求严格的金融场景。

适合的目标群体包括量化投资研究员、金融数据分析师、Python 开发者以及需要自动化获取市场数据的投资爱好者。对于需要构建投资组合监控系统、进行历史回测或学术研究的个人和团队，该技能提供了便捷的接入方案。然而，对数据延迟敏感的高频交易员、需要官方数据许可的机构投资者，以及处于封闭网络环境无法访问互联网的用户则不适合使用。

使用风险主要包括：网络依赖风险，所有数据获取均需连接 Yahoo Finance 服务器，离线环境无法使用；API 限制风险，频繁请求可能导致 IP 被临时封禁；账号安全风险，使用 Premium 功能时需明文存储 Yahoo Finance 登录凭据，存在潜在泄露隐患；以及数据可靠性风险，Yahoo Finance 数据可能存在延迟或错误，不应用于关键性财务决策。