simonlin1212/global-stock-data

解决的问题

该项目提供了一个全面的工具包，用于访问美国和香港股票市场数据，消除了开发者手动处理复杂认证流程、股票代码映射和碎片化数据源的需要。它特别设计为可集成到AI编程助手（如Claude Code、Codex或OpenClaw）中作为“技能”，使AI能够通过Python代码直接获取实时报价、财务数据和文件。

如何工作

该项目以单一自包含的“技能”文件（SKILL.md）形式组织，包含Markdown和嵌入的Python代码。它使用requests库从11个不同来源获取数据，包括官方政府数据源（SEC EDGAR、美国财政部、CFTC）和金融平台（Yahoo Finance、CBOE、FINRA、Eastmoney、Sina、Tencent）。它内置了线程安全的速率限制器，以确保遵守各数据源的限制，例如SEC的每秒10次请求上限。

适用人群

希望自动化金融分析、追踪期权流动或基于SEC文件筛选公司的开发者和AI用户，且使用AI编程助手来执行这些任务。

主要亮点

• 全面的数据覆盖：可访问实时报价、K线图（回溯至1984年）、基本面数据和宏观数据（国债收益率曲线、COT报告）。
• 官方来源优先：包含来自CBOE（期权希腊值和0DTE流动）、FINRA（市场整体空头持仓量）和SEC EDGAR（文件及XBRL指标）的高保真数据。
• AI原生集成：专为AI助手设计为“技能”，允许其调用端点执行如“显示NVDA的0DTE期权流动”等任务。
• 合规分级：明确按商业和再分发条款对数据源进行分级（S、B、C级）。
• 零认证：大多数端点无需API密钥，Yahoo的Cookie/Crumb认证由系统自动处理。