simonlin1212/a-stock-data

解决的问题

提供一个全面的、无需认证的A股（中国股市）数据工具包。它消除了开发者和AI代理手动处理数十个分散的金融数据源中复杂的API参数、认证头和速率限制逻辑的需求，将这些数据整合到一个单一的、AI就绪的接口中。

如何工作

该项目以"技能文件"（包含嵌入式Python的结构化Markdown）形式构建，可直接注入Claude Code、Codex或OpenClaw等AI编程助手。它实现了11层架构，通过TCP和HTTP请求从19个不同来源（包括mootdx、腾讯、东方财富和官方交易所API）获取数据。为防止IP被封禁，优先使用非阻塞源（如mootdx和腾讯），并对限制更严格的来源（如东方财富）使用内置的速率限制包装器（em_get()）。

适用人群

• AI开发者：需要可靠A股数据但无需管理多个API密钥的金融代理或投资研究工具开发者。
• AI编程助手用户：使用Claude Code或类似工具，希望其代理能够执行实时股票估值、主题研究和宏观分析的用户。
• 量化研究人员：需要一种简化方式来提取中国市场的K线、报告和资金流向数据的研究人员。

主要亮点

• 全面覆盖：11个数据层共54个端点，涵盖从实时行情、K线到研究报告、资金流向和宏观指标（PMI、社会融资）的全部内容。
• 零认证：大多数数据源完全免费，无需注册或API密钥（仅iwencai语义搜索除外）。
• 高容错架构：包含"备用源"策略，当主数据源被屏蔽时，可自动降级至替代数据提供商。
• AI原生设计：专为与基于LLM的编码代理无缝集成而格式化为技能文件。
• 广泛数据范围：包含ETF期权（希腊字母/IV）、股东人数、以及自2016年以来的历史估值（PE/PB/PS）等专业数据。