global-stock-data

在 AI 辅助编程日益普及的今天，获取高质量、实时的金融数据往往受限于昂贵的 API 费用或复杂的鉴权流程。global-stock-data 是一个专为 AI 编程助手（如 Claude Code, Codex, OpenClaw）设计的自包含 Skill 文件。它通过巧妙的封装，将分散在 5 个主流数据源的美股/港股全栈数据整合为一套零鉴权、仅依赖 requests 的工具集，让 AI 助手瞬间具备专业级的金融数据分析能力。

核心亮点：零门槛，全覆盖

1. 完全免费，零鉴权

• 无 API Key：所有数据源（新浪、腾讯、东财、Yahoo、SEC EDGAR）均无需注册或申请密钥。
• 自动处理鉴权：内置 Yahoo Crumb 自动获取逻辑及 SEC User-Agent 标准配置，开箱即用。
• 轻量依赖：仅依赖 Python 标准库及 requests，无复杂环境配置负担。

2. 8 层架构，18 个端点

global-stock-data 采用模块化设计，覆盖从实时行情到深层基本面的全方位数据：

3. AI 原生集成

• Skill 文件格式：本质为结构化 Markdown + 内嵌 Python 代码，任何支持上下文注入的 AI 助手均可直接识别并执行。
• 自然语言交互：用户只需说出需求（如“看看 AAPL 的财报”），AI 即可自动调用相应端点并解析数据。

快速开始：2 分钟部署

1. 安装 Skill (以 Claude Code 为例)

# 1. 创建目录
mkdir -p ~/.claude/skills/global-stock-data

# 2. 下载 SKILL.md
curl -o ~/.claude/skills/global-stock-data/SKILL.md \
  https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md

# 3. 安装依赖
pip install requests

2. 其他平台

• Codex / OpenClaw：将 SKILL.md 内容复制至系统 Prompt 或项目上下文文件中即可。

使用示例：自然语言驱动金融分析

只需向 AI 助手发送以下指令，即可激活对应功能：

• 📈 实时行情：“AAPL 现在什么价，PE 多少？” / “腾讯 00700 今天行情怎么样？”
• 📉 技术分析：“拉一下 TSLA 最近半年日 K 线，计算 MACD 和 RSI，有没有金叉？”
• 💰 基本面解读：“看看苹果最新一季的利润表。” / “BABA 的 PE/PB/ROE 和分析师目标价是多少？”
• 🏦 资金与持仓：“AAPL 最近资金是流入还是流出？” / “哪些机构持有 NVDA，持股比例多少？”
• 📜 SEC 档案：“苹果最近的 10-K 年报什么时候发的？” / “从 SEC XBRL 拉 MSFT 近 5 年营收和净利趋势。”
• 🔍 市场筛选：“今天美股涨幅最大的 20 只股票。” / “遍历港股全市场，找出换手率最高的。”

适用场景

• 个人投资者：快速获取实时行情、技术指标及资金流向，辅助投资决策。
• 量化开发者：低成本获取历史 K 线及基本面数据，用于策略回测与分析。
• AI Agent 构建者：为金融垂直领域的 AI 助手提供稳定、免费的数据底层支持。
• 财经内容创作者：快速检索公司财报、机构持仓及新闻舆情，提高研究效率。