Global Stock Data 美股港股全栈数据工具包
把散落在新浪、腾讯、东财、Yahoo、SEC、FINRA、CBOE 的行情与申报数据，装进一个零鉴权、自包含的 SKILL.md，AI 助手可直接调用。
安全实践较为突出：SEC 强制 UA 声明并在未配置时 fail-fast、内置线程安全限流（SEC 8 req/s 留余量）、逐源标注合规级别并引用条款原文、主动排除违规的 HKEX 抓取层、明确『只分发代码不分发数据』。扣分点：仍包含对 C 级源（新浪/腾讯/东财/Yahoo 前端接口）的自动化访问，合规上属灰色地带；数据流依赖多个未签名的第三方端点，外部行为变化无隔离层。
代码自包含、异常语义清晰（DataNotAvailable/RuntimeError/ValueError 三分）、403 正向识别 S3 AccessDenied、限流器带锁。但静态审查下未见仓库内测试套件或 CI 覆盖关键路径；多个函数（如 Layer 6.1 CBOE、Layer 9-12 完整代码）在提供的 SKILL.md 片段中被截断，无法确认全部端点代码完整；大量『实测』结论无法独立复现。
触发条件明确（When to Activate 清单+关键词表）、非适用边界清晰（仅美股的层有 assert_us_ticker 拦截港股代码、港股期权明示不支持）、中文支持好。扣分：核心新增层依赖 SEC/FINRA/CBOE/Yahoo 等境外服务，README 自己承认国内直连可能不稳，需代理，部分功能在国内环境可用性打折。
分层文档架构好、有路由速查表、语义化版本 v2.0.3、详尽 CHANGELOG、Apache-2.0 许可、致谢社区贡献。扣分：无 CI/测试目录证据、维护责任为个人、条款分级结论有时效性（源条款可能变化但未给出复核计划）、Nasdaq 财报日历条款未核实仍作为功能提供。
声称覆盖 30+ 端点、11 源，零鉴权低依赖（仅 requests），差异化价值（CBOE 希腊字母、FINRA 空头量、EDGAR screener）高于 yfinance 等替代方案。但静态审查无法验证输出可直接使用；此前版本曾出现多个函数 100% 崩溃（v2.0.2 修复记录），说明端点脆弱性真实存在，外部 API 变更即可使部分功能失效。
CHANGELOG 含具体修复前后对照、数值自洽验证（PE=价格/EPS、市值与总股本反算）、附自行复现 curl 命令、社区 issue 致谢提供第三方佐证。但均为作者自述的『实测』，仓库中无独立测试套件或 CI 工作流可交叉验证，静态审查无法确认复现性。
- 使用 SEC 层前必须将 SEC_CONTACT 改为真实姓名与邮箱，否则会被 SEC 拒绝。
- C 级源（CBOE/Yahoo/东财/新浪/腾讯）仅限个人研究；商用只依赖 S 级源，B 级（FINRA）商用前自行确认条款。
- 国内网络访问 SEC/FINRA/CBOE/Yahoo 可能不稳定，建议配置代理或优先使用东财/新浪/腾讯源。
- 静态审查未验证任何端点实际可用性；外部接口变更可能导致部分函数失效，使用前建议自行小规模验证。
- 各源合规分级结论基于 2026-07-24 的条款阅读，条款可能已变更，商用前请复核。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 AI 编程助手的单文件 Skill（SKILL.md + 内嵌 Python），覆盖美股与港股的行情、K线、技术指标、基本面、资金面、期权、SEC 申报等场景。V2.0 采用十三层架构、30+ 端点、11 个数据源，全部零鉴权，仅依赖 requests。其最大特色是逐家实读各数据源条款并标注 S/B/C 三级合规分级，且明确只分发代码、不分发市场数据。作者称已于 2026-07-24 做全量回归验证，但仓库本身未提供自动化测试。
提供可直接调用的 Python 代码：实时/延时行情（新浪 36 字段、腾讯美股 71 字段/港股 78 字段、东财 push2）；日/周/月/分钟 K 线（美股可回溯至 1984 年）；本地计算 MA/EMA/MACD/RSI/KDJ/布林带；财报三表、中英文关键指标、分析师预期、机构持仓；CBOE 官方期权链（完整希腊字母、IV、0DTE 筛选、异动 flow）；FINRA Reg SHO 全市场每日空头成交量（实测 12,112 只）；SEC EDGAR 每日申报流（Form 4/8-K/13F）、2001 年至今全文检索、XBRL frames 全市场横截面筛选（实测单标签覆盖 1,842~5,309 家）；美债收益率曲线、CFTC COT、财报日历。内嵌线程安全限流器与官方源统一出口（SEC 限 8 req/s 并要求声明 UA）。
- 个人投资者让 Claude Code 直接查询个股行情、财报、估值与分析师预期，如「看 AAPL 的 PE/PB/ROE 和目标价」。
- 期权交易者做 0DTE 与异动监控，如「显示 NVDA 今天的 0DTE 期权异常流」。
- 做空研究者追踪 FINRA 全市场空头成交量占比与个股时序，如「TSLA 本周空头比例趋势」。
- 量化/研究用户用 EDGAR frames 做免费全市场基本面筛选，如「按 CY2025Q1 研发费用给全部申报公司排名」。
- 合规敏感的商用团队只想依赖 S 级源（SEC EDGAR/Treasury/CFTC），并需要了解每个源的条款边界。
- 跟踪内部人与机构动向：当日 Form 4/13F 申报流，或全文检索「哪家公司在 8-K 中首次提到 HBM4」。
这个 Skill 有哪些优点和局限？
- 十三层 30+ 端点覆盖面广，从行情到期权 Greeks 到 SEC 申报一站式，且全部零鉴权、仅依赖 requests
- 合规分级是亮点：逐家引用条款原文（S/B/C 级），并因此主动移除了违反 HKEX 条款的 CCASS 层
- 工程细节扎实：内置线程安全限流、SEC UA 声明检查、S3 403 AccessDenied 的正向识别与 DataNotAvailable 异常语义
- 腾讯美股/港股字段对照表经过逐下标实测校准，并附自行复现命令
- 合规分级结论基于作者 2026-07-24 单次实读，Treasury/CFTC 与 Nasdaq 条款自称未逐条核验；CBOE 层商用前需另行取得授权
- 无自动化测试套件，主要靠作者声明的手动回归验证
- 数据时效依赖第三方前端接口（新浪/腾讯/东财），接口变更风险由使用者承担
- 港股期权、港股席位持股明确不支持；中国大陆服务器直连 Yahoo/SEC 可能不稳定
- V2.0 新增层（CBOE/FINRA/EDGAR/Treasury 等）仅覆盖美股，港股能力集中在行情与基本面
如何安装这个 Skill？
mkdir -p ~/.claude/skills/global-stock-data && curl -o ~/.claude/skills/global-stock-data/SKILL.md https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md && pip install requests。使用 SEC 层之前，必须把文件中的 SEC_CONTACT 改成你的真实姓名和邮箱，否则 SEC 会以 Undeclared Automated Tool 拒绝请求（代码会主动报错提醒）。
如何使用这个 Skill？
在 Claude Code 中直接用自然语言触发，如「查一下 AAPL 的最新财报」「NVDA 的 0DTE 期权异动」「美债 10Y-2Y 利差现在多少」，Skill 会自动在相关对话中激活。Codex/OpenClaw 用户可把 SKILL.md 粘贴进系统提示或项目上下文，内嵌 Python 可原样运行。Layer 6.1/9/10/11 仅支持美股，传港股代码会收到明确报错。
这个 Skill 与同类方案有什么区别？
作者称这是 a-stock-data 的姊妹项目：a-stock-data 覆盖中国 A 股，本项目覆盖美股与港股，两者可同时安装互不冲突。文中还提到 yfinance 与多数开源方案不具备其 V2.0 新增层（CBOE Greeks+0DTE、FINRA 空头量、EDGAR 申报流与全市场筛选）的能力。