yfinance-data
使用 yfinance Python 库获取金融和市场数据。当用户询问股票价格、历史数据、财务报表、期权链、股息、业绩、分析师建议或任何市场数据时，使用此技能。触发条件包括：提及股票价格、股票代码（AAPL、MSFT、TSLA 等），“获取财务数据”“显示业绩”“……的价格是多少”“下载股票数据”“期权链”“股息历史”“资产负债表”“损益表”“现金流”“分析师目标价”“机构持股”“比较股票”“筛选股票”，或任何涉及雅虎财经数据的请求。即使用户只提供一个股票代码，也始终使用此技能——根据上下文推断其意图。
yfinance Data 技能 - 用 Python 获取雅虎财经股票数据
技能概述
yfinance Data 技能让 AI 智能体直接调用 Python 的 yfinance 库，从 Yahoo Finance 抓取股票行情、历史 K 线、财务报表、期权链、股息拆股、盈利数据与分析师评级，无需申请 API Key，只要给一个股票代码就能取数。
适用场景
- 投资研究与财报分析：输入 AAPL、MSFT、TSLA 等代码，一次性取回利润表、资产负债表、现金流量表（含季度数据），用于对比营收、毛利率与现金流变化，快速完成一份尽调用的财务底稿。
- 量化回测的数据准备：按 period 与 interval 参数下载日线、周线或分钟级 OHLCV 数据，支持一次批量下载多只标的并对齐时间轴，直接喂给回测或因子脚本。
- 给智能体接入实时行情：当你问「某只股票现在多少钱」「最近有什么评级变动」「机构在加仓还是减仓」时，技能会自动补齐当前价格、分析师目标价、机构持仓与内部交易，让回答基于真实数据而不是记忆。
核心功能
- 行情与历史数据：当前报价走
ticker.info/ticker.fast_info，历史 K 线走ticker.history()或yf.download()；前者适合单只标的精细取数，后者用多线程批量下载多只股票更快。可用周期覆盖1d到max，可用粒度从1m到3mo。 - 财务与公司行动数据：
income_stmt、balance_sheet、cashflow提供三大报表，加quarterly_前缀即可取季度口径；dividends与splits还原分红和拆股历史，适合计算复权收益与股息率。 - 衍生品、评级与筛选：
option_chain()按到期日拉取看涨 / 看跌期权链；analyst_price_targets、recommendations、upgrades_downgrades、institutional_holders、insider_transactions覆盖卖方观点与资金动向；yf.Screener配合yf.EquityQuery可按条件筛选股票，yf.Sector/yf.Industry用于板块与行业层面取数。
常见问题
yfinance 需要 API Key 吗？收费吗？
不需要 API Key，也不收费，安装 Python 包后即可直接调用。正因如此，Yahoo 侧没有配额承诺，技能在实现上会对每个请求做异常捕获：遇到限流或返回空数据时降级处理，而不是直接崩溃。若你需要商用或高频调用，应先自行确认 Yahoo 的使用条款。
拿到的是实时行情还是延迟数据？
报价与行情来自 Yahoo Finance 公开接口，通常有不同程度的延迟，不适合作为交易执行依据，定位是研究与教育用途。技能本身也标注了数据的真实边界：yfinance 与 Yahoo, Inc. 没有隶属关系，数据仅用于研究和学习。
分钟级历史数据最多能回溯多久？
受上游限制，1m 粒度大约只能取最近 7 天，1h 粒度约 730 天，日线及以上则可以用 max 取全量历史。如果你要跑长周期回测，应使用日线或周线数据；需要日内数据时，最好在每次运行时就近拉取并落盘缓存，而不是依赖长期回溯。
取数时有哪些容易踩的坑？
三个最常见的：一是时区，yfinance 返回的是带时区的 DatetimeIndex（如 America/New_York），跨日期比较前要统一时区或用 tz_localize(None) 去掉；二是期权必须先读 ticker.options 拿到到期日列表，再用 option_chain(date) 取具体链；三是季度财务数据要用 quarterly_ 前缀的接口，直接取默认接口拿到的会是年度口径。
怎么触发这个技能？
不需要记接口名，直接用自然语言提问即可，例如「帮我看下 NVDA 的最新财报」「TSLA 的期权链」「对比一下 AAPL 和 MSFT 最近一年的走势」「有哪些股票符合我的筛选条件」。技能会根据你的意图自动匹配到对应的取数方法；即使你只给了一个股票代码，也会从上下文推断你想要的是行情、财报还是评级。