Stocks and Financial Data Pull Crypto Finance Cryptocurrency Price Earnings Dividends

核心功能

Stocks Skill 是一套基于 Yahoo Finance 的金融数据工具集，提供 56+ 个异步函数，覆盖全球股票、加密货币、外汇、大宗商品等多类资产。核心功能包括：

• 实时行情与历史数据：股价查询、历史走势、快速信息获取
• 基本面分析：财务报表（损益表、资产负债表、现金流量表）、关键估值比率（P/E、ROE、利润率等）
• 公司研究：公司概览、高管信息、机构持仓、内幕交易
• 盈利与分红：盈利历史、预测、分析师预期、股息与拆股信息
• 期权数据：期权链、到期日查询
• 市场宏观：市场指数、行业表现、市场开闭状态
• 另类资产：加密货币、外汇汇率、大宗商品价格
• 新闻与公告：股票新闻、SEC文件
• 对比工具：多股票对比、同业比较、历史对比

显著优点

1. 数据全面：依托 Yahoo Finance，覆盖全球主要市场，数据种类丰富
2. 异步设计：全异步架构，支持高效并发查询
3. 跨平台：支持 Linux、macOS、Windows，venv 隔离确保环境一致性
4. 开箱即用：提供详细的 TOOLS.md 模板，降低接入门槛
5. 持续维护：开源项目，GitHub 活跃，支持 OpenWebUI

潜在局限

1. 数据延迟：Yahoo Finance 数据存在轻微延迟，非实时 Level 1/2 行情
2. 依赖外部：完全依赖 Yahoo Finance API，服务稳定性受其制约
3. 无交易功能：仅提供数据查询，不支持下单交易
4. 环境配置：需正确配置 venv 路径，新手可能遇到 ModuleNotFoundError
5. 无中文支持：输出内容为英文，需自行处理本地化

适合人群

• 个人投资者进行基本面分析与选股研究
• 金融分析师获取标准化财务数据
• 量化研究者构建数据获取管道
• 开发者集成金融数据到 AI 工作流
• 教育工作者演示金融市场数据结构

常规风险

• 数据准确性：Yahoo Finance 为免费数据源，可能存在数据错误或延迟，不适合高频交易决策
• 合规风险：部分市场数据使用需遵守 Yahoo Finance 服务条款，商业用途需谨慎评估
• 环境安全：需在隔离 venv 中运行，避免依赖冲突；执行路径需绝对化，防止路径注入
• 网络依赖：所有功能需联网，离线无法使用
• API 限制：未提及速率限制，但大规模抓取可能触发 Yahoo 反爬机制

核心功能

stocks（yfinance-ai） 是一款基于Python开发的金融数据聚合Skill，通过Yahoo Finance API提供56+种专业级金融工具。核心能力涵盖四大维度：

实时市场数据：股票报价（get_stock_price）、加密货币（get_crypto_price）、外汇汇率（get_forex_rate）、大宗商品价格（get_commodity_price）及全球指数（get_market_indices）。

基本面深度分析：关键财务比率（P/E、ROE、毛利率）、三大报表（利润表/资产负债表/现金流）、完整公司画像（get_complete_analysis）及同行对比（compare_stocks）。

市场情绪与预期：分析师评级（get_analyst_recommendations）、目标价预测、盈利历史与预期（get_earnings_history）、期权链数据（get_options_chain）。

辅助信息：实时新闻（get_stock_news）、SEC文件、股息记录、内幕交易（get_insider_transactions）及机构持仓。

显著优点

数据来源权威：Yahoo Finance为全球顶级免费金融数据平台，覆盖美股、A股ADR、港股等主流市场，数据延迟通常在15分钟内。

架构设计精良：采用OS无关设计，虚拟环境隔离依赖；单次交互模式（one-shot）确保执行可靠性；全异步架构支持高效并发。

安全认证优异：静态分析95分、依赖审计90分，无危险函数、无硬编码密钥、无恶意依赖，获S级安全评级。

隐私友好：仅处理用户主动提供的股票代码，不采集敏感信息，符合GDPR/CCPA规范。

潜在局限

数据依赖风险：完全依赖Yahoo Finance API，若其服务变更或限制访问，功能将受影响；Yahoo非专业金融终端，数据精度与机构级服务（Bloomberg、FactSet）存在差距。

实时性限制：免费API存在15-20分钟延迟，无法满足高频交易需求；极端行情下可能出现数据刷新滞后。

地域覆盖不均：对新兴市场（如印度、巴西本地交易所）支持较弱，主要覆盖美股及主要国际资产。

无交易执行能力：纯数据查询工具，不支持实盘交易、模拟下单或投资组合管理。

适合人群

• 个人投资者进行日常研究与估值分析
• 财经内容创作者快速获取数据素材
• 开发者构建金融类AI Agent/聊天机器人
• 学术研究者获取免费历史数据

常规风险提示

1. 数据延迟：非实时行情，重大市场波动时请以券商数据为准
2. API稳定性：Yahoo可能调整API策略，建议关注依赖库更新
3. 投资决策：工具输出不构成投资建议，需结合专业判断
4. 虚拟环境管理：务必使用Skill专属venv的Python解释器执行，避免模块冲突

技术亮点

文档提供robust执行模式（here-doc脚本）、完整Agent集成模板（TOOLS.md）、Windows/Linux/macOS三端兼容方案，降低部署门槛。