这个 Skill 能做什么，适合哪些场景？
global-stock-data 是作者 Simon Lin 开发的 Agent Skill，以单个自包含的 SKILL.md（内嵌 Python 代码）形式分发，把散落在新浪、腾讯、东财、Yahoo、SEC EDGAR、FINRA、CBOE、Treasury、CFTC、Nasdaq 共 11 个数据源的市场数据整合成 AI 助手可直接调用的工具包。架构分 13 层、30+ 端点，仅依赖 requests，无任何 API key 要求。V2.0 主打「官方源优先」：新增 CBOE 官方期权链（完整希腊字母 + IV + 0DTE + 异动识别）、FINRA 全市场每日空头成交量（实测 12,112 只标的）、SEC EDGAR 申报事件流与免费全市场横截面筛选器。每个数据源都标注了 S/B/C 合规级别并引用条款原文，且只分发代码、不分发市场数据；作者还主动移除了违反 HKEX 条款的 CCASS 席位持股层。
- 拉取美股/港股实时行情（新浪 36/25 字段、腾讯 71/78 字段、东财 push2 统一 secid 接口）
- 获取日/周/月/分钟 K 线（美股可回溯至 1984 年）并本地计算 MA/EMA/MACD/RSI/KDJ/布林带
- 读取财报三表、关键指标（美股 49 / 港股 75 字段）、分析师预期、机构持仓，以及 SEC XBRL 的 503 个 GAAP 指标
- 查询 CBOE 官方期权链（delta/gamma/vega/theta/rho + IV + 0DTE 筛选 + 异动 flow）与 FINRA 全市场每日空头成交量
- 检索 EDGAR 当日申报流（Form 4 / 8-K / 13F）、2001 年至今全文检索，并用 EDGAR frames 做全市场 XBRL 横截面筛选
- 附带美债收益率曲线、CFTC COT 持仓、Nasdaq 财报日历等宏观数据
- 个人投资者用自然语言查个股：让助手报出 AAPL 的现价、PE/PB/ROE、目标价与机构持仓
- 期权交易者追踪 0DTE：查看 NVDA 当日到期的期权链、希腊字母与 vol/OI > 1 的异动 flow
- 做空数据分析：查询 TSLA 本周空头成交量占比趋势（FINRA Reg SHO）
- 量化研究批量取数：用 EDGAR frames 一次拉取全市场某 XBRL 标签（如 CY2025Q1 净利润，覆盖 5,309 家公司）做免费筛选
- 合规/事件监控：查观察名单今日的 Form 4 内部人申报，或全文检索哪些 8-K 最先提到某关键词
- 港股用户查腾讯 00700 的行情、K线与中文财报科目
- 需要商用或再分发 B/C 级源数据（如 CBOE 期权、Yahoo、东财）的用户——项目明确要求商用只依赖 S 级源，CBOE 须事先取得 Cboe 书面授权
- 需要港股期权或港股席位持股（CCASS/南向资金）数据的用户——期权层仅支持美股，HKEX 抓取代码因条款禁止已被主动移除
- 不用 AI 编程助手、也不想复制 Python 代码的传统用户——本项目是 SKILL.md + 内嵌代码，不是现成的应用或 API 服务
如何安装这个 Skill？
- 使用 SEC 层前必须将 SEC_CONTACT 改为真实姓名与邮箱，否则会被 SEC 拒绝。
- C 级源（CBOE/Yahoo/东财/新浪/腾讯）仅限个人研究；商用只依赖 S 级源，B 级（FINRA）商用前自行确认条款。
- 国内网络访问 SEC/FINRA/CBOE/Yahoo 可能不稳定，建议配置代理或优先使用东财/新浪/腾讯源。
- 静态审查未验证任何端点实际可用性；外部接口变更可能导致部分函数失效，使用前建议自行小规模验证。
- 各源合规分级结论基于 2026-07-24 的条款阅读，条款可能已变更，商用前请复核。
- Shell / 命令行
- 网络访问
- 本地文件系统
Python 3.9+requests
Claude Code 用户按 README 的三步安装：
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 requestsCodex / OpenClaw 等其他助手：源文档说明可把 SKILL.md 粘贴进 system prompt 或项目上下文文件，无需额外安装命令。
注意：使用 SEC 相关层前，必须把 SKILL.md 中的 SEC_CONTACT 改成你的真实姓名与邮箱，否则代码会主动报错。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 看看 NVDA 今天的 0DTE 期权流，有没有异动
- TSLA 本周的空头成交量占比趋势如何
- 查一下我的观察名单今天有哪些 Form 4 内部人申报
- AAPL 的 MACD 和 RSI 有没有金叉？顺便看看最新利润表
安装后启动 Claude Code，直接用中文或英文谈论美股/港股话题即会自动激活（SKILL.md 的 When to Activate 列出了行情、K线、财报、期权、SEC、资金流、技术指标等触发关键词与场景）。核心流程：助手阅读 SKILL.md 中的端点路由速查表定位到对应层，运行内嵌的 Python 函数（仅依赖 requests）。值得了解的机制：Yahoo 的 cookie+crumb 自动获取并缓存；V2.0 新增层统一走 official_get() 出口，内置线程安全限流（SEC 8 req/s、FINRA/CBOE 4 req/s）；异常语义区分 DataNotAvailable（可回退下一候选日）与 RuntimeError（配置/限流错误必须冒泡）；Layer 6.1/9/10/11 仅支持美股，传入港股代码会抛出明确提示。中国大陆服务器直连 Yahoo/SEC 可能不稳，可改用东财/新浪/腾讯源或配代理。
这个 Skill 有哪些优点和局限？
- 零鉴权、零 API key，唯一依赖是 requests，安装门槛极低
- CBOE 希腊字母/0DTE、FINRA 空头成交量、EDGAR 全文检索与全市场筛选器是 yfinance 和多数开源方案不具备的能力
- 合规分级认真：逐家实读条款原文并引用，主动移除了违反 HKEX 条款的 CCASS 层，商用边界清晰
- 工程细节扎实：SEC User-Agent 校验、S3 403 AccessDenied 的正向识别、字段对照表经实测校准并公开复现命令
- C 级源（Yahoo/东财/新浪/腾讯/CBOE）仅限个人研究，商业使用受限或需授权
- Nasdaq 财报日历条款标注「未核实」，Treasury/CFTC 分级按惯例归类而非逐条核验
- 无独立测试套件，数据源为非官方前端接口，字段下标随站点改版可能失效（腾讯字段表需靠 issue 修订就是例证）
- 港股 K 线只剩 Yahoo 一个可用源（新浪港股 K 线已失效），单点依赖
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Global Stock Data — 美股港股全栈数据工具包 本页 | 62 · 推荐 | ★ 1.7k | 13 天前 | Apache-2.0 |
| TradingView MCP 智能交易助手 | 50 · 谨慎使用 | ★ 5.1k | 11 天前 | MIT |
| Claw-Screener 股票筛选器 | 51 · 谨慎使用 | ★ 10 | 4 个月前 | MIT |
| 美股市场情绪监控系统 | 54 · 谨慎使用 | ★ 1.1k | 6 个月前 | MIT |
| 个人财务 Skill（AI 个人 CFO） | 50 · 谨慎使用 | ★ 25 | 8 个月前 | MIT |
README 明确称 [a-stock-data](https://github.com/simonlin1212/a-stock-data) 为姊妹项目：后者覆盖中国 A 股，本项目覆盖美股与港股，两者可同时安装互不冲突。
FollowSkills 如何评估这个 Skill？
安全实践较为突出：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 工作流可交叉验证，静态审查无法确认复现性。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →