用途:在 Claude Code 中激活后,用于查询美股、港股行情、K 线、财报、财务指标、分析师预期、机构持仓、资金流、期权链、SEC Filing、做空数据、申报事件、全市场筛选与技术指标计算。
主要能力按层划分:Layer 1 行情(新浪、腾讯、东财);Layer 2 K 线(新浪、Yahoo);Layer 3 技术指标(MA/EMA、MACD、RSI、KDJ、布林带,本地纯 Python 计算);Layer 4 基本面(东财 datacenter、Yahoo crumb、SEC EDGAR XBRL);Layer 5 资金流(东财 push2his);Layer 6 期权(CBOE 官方含希腊字母/IV/0DTE/异动流,Yahoo 为后备);Layer 7 SEC Filing;Layer 8 搜索/新闻/CIK 映射/全市场列表;V2.0 新增 Layer 9 FINRA 每日空头成交量、Layer 10 EDGAR 每日索引与全文检索、Layer 11 EDGAR frames 全市场横截面、Layer 12 Treasury/CFTC/Nasdaq 宏观日历。
使用方式:将 SKILL.md 放入 ~/.claude/skills/global-stock-data/,Claude Code 自动识别激活;安装依赖 pip install requests;调用 SEC 相关层前必须把 SEC_CONTACT 改为真实姓名与邮箱,否则返回 403。各层有市场代码格式差异,如东财 secid 前缀 105/106/107/116、Yahoo 港股用 0700.HK、东财 SECUCODE 用 TICKER.O/.N 或 CODE.HK,可用 stock_search() 获取 MktNum 自动映射。新增层统一走 official_get 出口做限速与 UA 声明。
适用场景:美股港股多源行情与量化初筛、财报与 SEC 申报分析、期权与做空数据研究、宏观日历查询。
限制:官方源不等于可自由使用。SEC EDGAR、Treasury、CFTC 为 S 级,SEC 硬性限速 10 请求/秒且须声明 User-Agent;FINRA 为 B 级,站点条款限制批量抓取,商用前需自行确认;CBOE、Nasdaq、Yahoo、东财、新浪、腾讯为 C 级,CBOE 商用或再分发须事先获得授权,其余仅供个人研究。工具只分发代码,不分发或转售任何市场数据。已排除 HKEX CCASS 抓取代码。部分层仅支持美股,传入港股代码会报错。Nasdaq 条款本次未核实,港股期权不在 Yahoo 覆盖范围。