global-stock-data – 面向 AI 编码助手的市场数据技能

是什么

• 一个单一的 技能 文件（Markdown 内嵌 Python），允许 AI 编码助手（Claude Code、OpenAI Codex、OpenClaw 等）即时获取多种美国中心的市场数据。
• 该仓库只包含与公共数据源通信的代码；实际数据由用户在请求时提取。

为什么重要

• AI 助手经常需要最新的金融信息来回答与编码相关的问题（例如，“显示 AAPL 的 0 天到期期权流”）。
• 此技能不是让每个助手开发人员重新实现数十个抓取器，而是提供现成的、零认证、仅 requests 的接口，涵盖 16 个逻辑层（行情、K 线、基本面、期权 Greeks、空头利息、SEC 文件、宏观利率、外汇等）和 50 多个端点。

主要功能（如 README 中所述）

层	主要数据和来源	亮点
市场数据	新浪、腾讯、东方财富（实时美国/香港行情）	每个代码 25-78 个字段
K 线/图表	新浪（至 1984 年）+ Yahoo（全球）	日线、周线、月线、分钟线；适用于美国、日本、台湾、韩国、印度、欧盟市场
技术指标	纯 Python 计算	MA、EMA、MACD、RSI、KDJ、布林带
基本面	东方财富、Yahoo、SEC XBRL	损益表、资产负债表、现金流量表、503 项 GAAP 指标
资金流向	东方财富 push2his	按市值层级统计的每日资金流向
期权	Yahoo crumb（备用）	美国代码的完整链
官方来源期权	CBOE（cdn.cboe.com）	完整链 + 隐含波动率 + Greeks + **0 天到期（0DTE）**流检测
空头成交量	FINRA Reg SHO	约 12k 个代码的市场范围每日空头成交量
空头利息	FINRA（每月两次）	未平仓空头头寸、回补天数、约 22k 个代码的排名
SEC 文件	EDGAR 每日索引 + XBRL	当日 Form 4、8-K、13F；可全文搜索至 2001 年
内幕交易 / 13F	SEC Form 4 和 13F 解析器	逐行内幕交易详情、季度机构持股
宏观/日历	美国财政部、CFTC、纳斯达克盈利日历	收益率曲线（1 个月至 30 年）、COT 头寸、盈利日期
全球利率与外汇（V2.1）	BIS、ECB、纽约联储、美联储委员会、财政部	38 家央行的政策利率、欧元/美元、SOFR/EFFR、欧元区收益率曲线
台湾市场（V2.2）	TWSE 和 TPEx 开放 API	最新报价、市盈率、股息收益率、月度营收、融资融券数据
能源（V2.2）	美国 EIA	每周原油/汽油库存、WTI、布伦特、亨利中心的每日现货价格
工具	多种	代码搜索、全市场股票列表、新闻、代码↔CIK 映射

合规层级

• README 将每个数据源从 S（免费、商业友好）到 D（仅个人使用）进行分级，并标记那些 B（需要商业重用许可）或 C/D（禁止自动抓取）的数据源。这有助于开发人员决定哪些端点可以安全用于生产。

如何开始

1. 创建 ~/.claude/skills/global-stock-data 目录。
2. 从仓库下载单个 SKILL.md 文件。
3. 安装唯一的运行时依赖：pip install requests（Windows 还需要 tzdata）。
4. （可选）在 SEC_CONTACT 中填写您的姓名/电子邮件，以满足 SEC 要求的用户代理。
5. 通过 AI 助手调用技能，例如：“Claude，显示 AAPL 的财务信息”。

典型用例提示（来自 README）

• “显示 NVDA 的 0DTE 期权流——异常活动。”
• “本周 TSLA 的空头成交量比率趋势。”
• “主要央行的当前政策利率。”
• “过去一年的 WTI 价格图表。”
• “伯克希尔最新 13F 中的前 10 大持仓。”

适用人群

• 构建 AI 助手驱动的金融工具的开发者。
• 希望仅通过代码快速获取公开市场数据而无需处理大量 API 的量化研究人员。
• 需要零认证、纯 Python 包装器来访问公开金融源的人。

限制

• 仓库仅提供代码；您必须遵守每个来源的条款（尤其是层级 C/D）。商业项目应使用层级 S 来源。
• 某些数据（例如 Yahoo、Nasdaq）技术上不允许自动抓取；该技能包含代码但警告用户。

底线 global-stock-data 是一个文档齐全的开源“技能”，将广泛的公开美国及全球市场数据源聚合到单一的 AI 助手友好 Python 接口中，并附有清晰的合规指导。