US stock market data for AI coding assistants — zero-auth, official sources. CBOE options with full Greeks + 0DTE flow, FINRA market-wide short volume, SEC EDGAR filing stream, and a free market-wide...
개요
美股港股全栈数据工具包 — 8 层架构 · 18 个端点 · 5 个数据源 · 全部零鉴权 · 仅依赖 requests 一个自包含的 Skill 文件，把分散在 5 个数据源里的美股/港股原始数据整合成 AI 编程助手直接能用的工具集。你不用再背东财 secid 前缀、Yahoo crumb 鉴权流程、SEC EDGAR 的 CIK 映射——全部封装好了。 5 个函数（个股行情/Yahoo K线/日级资金流/搜索/全市场列表）漏传 params=params，请求实际是裸 URL， → 一次性补齐；并修了 market_stock_list 在东财 diff 返回 dict 时 AttributeError 的连带 bug（归一化 dict→list）。强烈建议升级。致谢 @APTX4869-maker。 兼容 Claude Code · Codex · OpenClaw Skill 文件本质是结构化 Markdown + 内嵌 Python，任何支持上下文注入的 AI 编程助手都能用。 把 SKILL.md 的内容贴入你的系统 prompt 或项目上下文文件即可，内嵌的 Python 代码可直接执行。 全部 5 个数据源**。Yahoo crumb 由代码自动获取，SEC EDGAR 仅需标准 User-Agent。 全部直连 HTTP API，零第三方数据封装依赖。Yahoo crumb 由 helper 自动管理，SEC EDGAR 仅需标准 User-Agent。 姊妹项目。a-stock-data 覆盖 A 股（沪深北），global-stock-data 覆盖美股和港股。两个 Skill 可以同时安装，互不冲突。
README
global-stock-data
美股港股全栈数据工具包 — 8 层架构 · 18 个端点 · 5 个数据源 · 全部零鉴权 · 仅依赖 requests
一个自包含的 Skill 文件，把分散在 5 个数据源里的美股/港股原始数据整合成 AI 编程助手直接能用的工具集。你不用再背东财 secid 前缀、Yahoo crumb 鉴权流程、SEC EDGAR 的 CIK 映射——全部封装好了。
V1.0.1 修复（2026-06-20 · PR #1）： 5 个函数（个股行情/Yahoo K线/日级资金流/搜索/全市场列表）漏传
params=params，请求实际是裸 URL，此前始终返回空数据 → 一次性补齐；并修了market_stock_list在东财diff返回 dict 时AttributeError的连带 bug（归一化 dict→list）。强烈建议升级。致谢 @APTX4869-maker。
兼容 Claude Code · Codex · OpenClaw
Skill 文件本质是结构化 Markdown + 内嵌 Python，任何支持上下文注入的 AI 编程助手都能用。
架构
美股港股全栈数据 · 八层架构 · V1.0.1
│
├── 行情层 新浪(gb_/rt_hk) + 腾讯(us/r_hk) + 东财push2 实时报价 25-78 字段
├── K线层 新浪(回溯至1984) + Yahoo chart 日/周/月/分钟 K线
├── 技术指标 MA/EMA + MACD + RSI + KDJ + 布林带 纯Python计算，零额外依赖
├── 基本面 东财datacenter三表+GMAININDICATOR + Yahoo + SEC XBRL 财报+关键指标+估值+机构持仓
├── 资金面 东财push2his 日级主力/大单/中单/小单资金流
├── 期权层 Yahoo crumb 期权链 calls+puts (仅美股)
├── SEC Filing EDGAR submissions + XBRL 10-K/10-Q/8-K + 503个GAAP指标 (仅美股)
└── 工具层 东财search+push2列表 + Yahoo search + SEC CIK映射 搜索+全市场列表+新闻+ticker↔CIK
快速开始
3 步，2 分钟。
# 1. 创建 skill 目录
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
启动 Claude Code，说一句「帮我看看 AAPL 的财报」，自动激活。
Codex / OpenClaw 用户： 把 SKILL.md 的内容贴入你的系统 prompt 或项目上下文文件即可，内嵌的 Python 代码可直接执行。
18 个端点能力清单
行情层（实时/延时）
| 端点 | 数据 |
|---|---|
| 新浪财经 | 美股 36 字段（含中文名/EPS/PE）/ 港股 25 字段 |
| 腾讯财经 | 美股 71 字段 / 港股 78 字段（含 PE/PB/市值/换手率） |
| 东财 push2 | 美股/港股 secid 统一查询，含中文名/涨跌幅/换手率 |
K线层（日/周/月/分钟）
| 端点 | 数据 |
|---|---|
| 新浪 | 美股日K线，回溯至 1984 年 |
| Yahoo chart | 美股 + 港股，v8 API 零 crumb，支持日/周/月/分钟 |
技术指标层（纯计算）
| 端点 | 数据 |
|---|---|
| 技术指标计算 | MA/EMA + MACD(DIF/DEA/柱状图) + RSI(6/12/24) + KDJ(K/D/J) + 布林带(上/中/下轨)，基于K线纯Python计算 |
基本面
| 端点 | 数据 |
|---|---|
| 东财 datacenter 三表 | 美股/港股三表（资产负债 + 利润 + 现金流），中文科目名 |
| 东财 GMAININDICATOR | 关键财务指标概览（美股49字段/港股75字段：ROE/ROA/EPS/毛利率/资产负债率） |
| Yahoo quoteSummary | 23 个模块（财务数据 + 关键指标 + 分析师 + 机构持仓） |
| SEC EDGAR XBRL | 美股 503 个 GAAP 指标（仅美股） |
资金面
| 端点 | 数据 |
|---|---|
| 东财 push2his | 日级主力/大单/中单/小单净流入，美股 + 港股 |
期权层（仅美股）
| 端点 | 数据 |
|---|---|
| Yahoo options | 期权链 calls + puts，所有到期日，含 Greeks |
SEC Filing 层（仅美股）
| 端点 | 数据 |
|---|---|
| EDGAR submissions | 10-K/10-Q/8-K 完整 Filing 列表 |
| EDGAR XBRL | 结构化财务指标（营收/净利/EPS 等） |
工具层
| 端点 | 数据 |
|---|---|
| 东财 search | 股票搜索（中英文，含市场代码映射） |
| 东财 push2 列表 | 全市场股票列表（涨跌幅/成交量排名，美股5925+/港股18000+） |
| Yahoo search | 新闻资讯（按股票代码） |
| SEC CIK mapping | ticker ↔ CIK 映射（仅美股） |
鉴权要求
全部 5 个数据源完全免费无 Key。Yahoo crumb 由代码自动获取，SEC EDGAR 仅需标准 User-Agent。
使用示例
跟你的 AI 助手说这些话就能激活：
| 场景 | 说什么 |
|---|---|
| 美股行情 | 「AAPL 现在什么价，PE 多少」 |
| 港股行情 | 「腾讯 00700 今天行情怎么样」 |
| K线分析 | 「拉一下 TSLA 最近半年日K线」 |
| 财报解读 | 「看看苹果最新一季的利润表」 |
| 估值分析 | 「BABA 的 PE/PB/ROE 和分析师目标价」 |
| 机构持仓 | 「哪些机构持有 NVDA，持股比例多少」 |
| 资金流向 | 「AAPL 最近资金是流入还是流出」 |
| 期权策略 | 「TSLA 下个月到期的期权链，看看 call 和 put」 |
| SEC Filing | 「苹果最近的 10-K 年报什么时候发的」 |
| 量化分析 | 「从 SEC XBRL 拉 MSFT 近 5 年营收和净利趋势」 |
| 搜索股票 | 「搜一下阿里巴巴的股票代码」 |
| 新闻 | 「NVDA 最近有什么新闻」 |
| 涨幅排名 | 「今天美股涨幅最大的 20 只股票」 |
| 全市场筛选 | 「遍历港股全市场，找出换手率最高的」 |
| 关键指标(中文) | 「看看苹果最近几季的 ROE、EPS 和资产负债率」 |
| 技术分析 | 「AAPL 的 MACD 和 RSI 怎么样，有没有金叉」 |
| 批量对比 | 「帮我对比 AAPL MSFT GOOGL 三家的估值」 |
V1.0 亮点
| 特性 | 说明 |
|---|---|
| 全部零鉴权 | 5 个数据源全部免费无 Key，Yahoo crumb 自动管理 |
| 极简依赖 | 仅需 requests，零第三方数据封装 |
| 美股 + 港股双覆盖 | 行情/K线/财报/资金流均支持双市场 |
| 技术指标内置 | MA/EMA/MACD/RSI/KDJ/布林带，纯 Python 计算，拉完 K 线直接算，零额外依赖 |
| 全市场列表 | 东财 push2 一键获取美股 5925+/港股 18000+ 只股票，按涨跌幅/成交量排序 |
| 关键指标中英双版 | 东财 GMAININDICATOR（中文 49/75 字段）+ Yahoo quoteSummary（英文全品类） |
| SEC 深度集成 | EDGAR Filing 列表 + XBRL 503 个 GAAP 指标，量化分析利器 |
| 期权链 | Yahoo 期权数据，含所有到期日和 Greeks |
| 智能代码映射 | 东财 secid 前缀自动判断（105/106/107/116），Yahoo .HK 后缀自动处理 |
数据源优先级
| 场景 | 第一优先 | 备选 | 说明 |
|---|---|---|---|
| 美股行情 | 新浪 gb_XXXX |
腾讯 / 东财 push2 | 新浪有中文名+EPS+PE |
| 港股行情 | 腾讯 r_hkXXXXX |
新浪 / 东财 push2 | 腾讯字段最全(78个) |
| 美股K线 | 新浪 | Yahoo chart | 新浪回溯至1984年；Yahoo支持多周期 |
| 港股K线 | Yahoo chart | — | 新浪港股K线已失效 |
| 财报三表(中文) | 东财 datacenter | — | 中文科目名，按行展开 |
| 财报三表(结构化) | Yahoo quoteSummary | — | 英文，完整报表结构 |
| 关键指标(中文) | 东财 GMAININDICATOR | — | ROE/ROA/EPS/毛利率/资产负债率 |
| 关键指标(英文) | Yahoo quoteSummary | — | PE/PB/EV/利润率/目标价 |
| 分析师预期 | Yahoo quoteSummary | — | EPS预测+评级+升降级 |
| 机构持仓 | Yahoo quoteSummary | — | 前10大机构+内部人 |
| 资金流 | 东财 push2his | — | 日级主力/大单/中单/小单 |
| 期权链 | Yahoo options | — | 仅美股 |
| SEC Filing | EDGAR | — | 官方数据，仅美股 |
| 搜索 | 东财 search | Yahoo search | 东财有 secid 映射 |
| 新闻 | Yahoo search | — | 唯一稳定的新闻源 |
| 全市场列表 | 东财 push2 clist | — | 涨跌幅/成交量排名 |
数据源汇总
| 数据源 | 协议 | 鉴权 | 覆盖 |
|---|---|---|---|
| 东财 push2 | HTTPS | 零 | 美股+港股 实时行情+全市场列表 |
| 东财 push2his | HTTPS | 零 | 美股+港股 资金流 |
| 东财 datacenter | HTTPS | 零 | 美股+港股 财报三表+GMAININDICATOR关键指标 |
| 东财 search API | HTTPS | 零 | 全球股票搜索+secid映射 |
| Yahoo Finance | HTTPS | cookie+crumb(自动) | 美股+港股 全品类 |
| 新浪财经 | HTTP | 零 | 美股+港股 行情、美股K线 |
| 腾讯财经 | HTTPS | 零 | 美股+港股 行情 |
| SEC EDGAR | HTTPS | 零(需UA) | 美股 Filing+XBRL |
架构原则： 全部直连 HTTP API，零第三方数据封装依赖。Yahoo crumb 由 helper 自动管理，SEC EDGAR 仅需标准 User-Agent。
FAQ
Q: 和 a-stock-data 有什么关系？ 姊妹项目。a-stock-data 覆盖 A 股（沪深北），global-stock-data 覆盖美股和港股。两个 Skill 可以同时安装，互不冲突。
Q: Yahoo Finance 需要 API Key 吗？ 不需要。代码自动获取 cookie + crumb，透明处理。如果 crumb 过期会自动刷新。
Q: SEC EDGAR 有访问限制吗？ 有。SEC 要求请求携带 User-Agent 并限制每秒 10 次。代码已内置合规 UA，正常使用不会触发限流。
Q: 港股期权数据有吗？ 没有。港股期权不在 Yahoo Finance 覆盖范围，需要港交所专有接口（付费）。当前期权层仅支持美股。
Q: 在国内服务器跑，Yahoo/SEC 能访问吗？ Yahoo Finance 和 SEC EDGAR 都是境外服务，国内直连可能不稳定。建议走代理，或优先使用东财/新浪/腾讯数据源。
Q: 不用 Claude Code，能用吗？ 能。SKILL.md 本质是 Markdown + 内嵌 Python 代码。Codex、OpenClaw 或任何 AI 编程助手都能读取。你也可以直接把 Python 代码段复制出来在自己的脚本里跑。
更新日志
见 CHANGELOG.md。
Donate
如果这个工具帮到了你的投研工作流，欢迎请作者喝杯咖啡 ☕
爱发电 · Buy Me a Coffee
想要什么数据端点？欢迎开 Issue 提需求，赞助者的 Issue 优先处理。
Disclaimer
本项目仅提供数据获取工具，不构成任何投资建议。股市有风险，投资需谨慎。
License
Apache License 2.0 — 自由使用，注明出处即可。
作者： Simon 林 · 抖音「Simon林」 · 公众号「硅基世纪」
추천 도구
다른 키워드를 입력하거나 필터를 제거해 보세요.
설치
npx skillfish add simonlin1212/global-stock-data