核心用法
Stocks Skill 是一款集成 Yahoo Finance 数据源的金融数据获取工具，提供 56 个以上的异步 API 方法，涵盖全球股票市场、加密货币、外汇汇率、大宗商品价格及衍生品数据。用户通过 Python 虚拟环境调用预封装模块，无需直接处理 Yahoo Finance API 的复杂性。
典型调用模式：进入 scripts/ 目录后，通过 venv 中的 Python 解释器执行内联脚本或独立文件，使用 asyncio.run() 包装异步方法。支持单次查询（如 get_stock_price）和深度分析（如 get_complete_analysis），并提供股票对比 (compare_stocks)、期权链 (get_options_chain)、市场情绪 (get_analyst_recommendations) 等高级功能。
显著优点
1. 数据覆盖全面：从实时报价、财务报表（三大表）、关键估值比率（P/E、ROE、利润率）到分析师评级、机构持仓、内部人交易，形成完整投研数据链。
2. 跨资产类别：统一接口处理股票、加密资产（BTC/ETH 等）、外汇对（EURUSD 等）、大宗商品（黄金/原油）。
3. 跨平台兼容：显式支持 Linux、macOS、Windows，通过虚拟环境隔离依赖。
4. 可靠执行设计：采用 here-doc 或独立脚本模式规避 shell 引号转义问题，提升自动化场景下的稳定性。
5. 即用型 Agent 模板：提供可直接嵌入 TOOLS.md 的标准化调用模板，降低集成成本。
潜在缺点与局限性
- 数据源延迟：Yahoo Finance 免费数据存在 15-20 分钟延迟，不适合高频交易或实时套利场景。
- 数据可靠性：Yahoo Finance 为非官方交易所直连，极端行情下可能出现数据缺失或异常值，需交叉验证。
- 速率限制：未明确说明调用频次上限，大规模批量查询可能触发 IP 限制。
- 无回测框架：仅提供原始数据获取，不包含策略回测或交易执行功能。
- 依赖外部服务：Yahoo Finance API 变更可能导致工具失效，存在维护风险。
适合人群
- 个人投资者与财务分析师：快速获取多维度公司基本面数据。
- 量化研究员：需要标准化数据接口进行因子挖掘与策略预研。
- 金融科技开发者：构建投研工具、监控机器人或教育演示系统。
- 不适合：专业高频交易员、需要交易所 Level 2 订单簿数据的用户。
常规风险
- 数据决策风险：延迟数据可能导致交易决策偏差，不建议作为唯一依据。
- 隐私合规：Yahoo Finance 服务受美国法律管辖，敏感行业数据查询需注意合规边界。
- 技术故障：网络波动或 API 变更时，异步调用可能抛出未捕获异常，需完善错误处理。
- 虚拟环境安全：
requirements.txt依赖链未审计，建议隔离运行环境。