china-market-data · 中国市场数据

English · 技能入口 · 来源与修改说明 · Apache-2.0

clawyi-com/china-market-data 是面向中国用户的 中国市场数据 / 中国股票市场数据 Skill：让 Cursor、Claude Code、Codex 等 AI Agent 直接调用可运行的 Python CLI，取到 A 股行情、研报、资金、公告、打板、期权、期货与宏观等真实数据，并标明时间戳、覆盖范围和失败降级方式。

15 层能力 · 87 个端点（含 5 个备用入口）· 34 个数据来源 · 除 iwencai 外全部免 API Key

这不是投顾建议，也不是付费数据商 SDK。

目录

• 30 秒开始
• 直接这样问 AI
• 为什么用它
• 15 层能力一览
• 数据来源
• 安装
• 命令行使用
• 数据边界
• 开发与验证
• 许可证与致谢

30 秒开始

# 自动识别 Cursor、Claude Code、Codex 等宿主并安装
npx --yes skills@latest add clawyi-com/china-market-data -g

装好后直接向 AI 助手提问即可。腾讯报价等入口只用 Python 标准库；需要完整数据能力时，再按安装 Python 依赖执行一次初始化脚本。

直接这样问 AI

只讨论概念或投资观点、不需要实际取数时，技能不会被加载。

为什么用它

• 为 Agent 设计：数据端点都提供 CLI 和 --help，SKILL.md 内置端点路由表，AI 按需读取对应章节，不必把全部文档塞进上下文。
• 免 Key 开箱即用：除 iwencai 语义搜索外，全部接口不需要注册或 API Key。
• 优先官方与稳定来源：优先腾讯、交易所、中债、人民银行等来源；东财接口内置节流，主源不可用时按“备用源速查”降级。
• 结果可核对：保留报价来源、行情时间和抓取时间，区分缺失值与真实的 0，失败时明确报错，不用空数据冒充成功。
• 本地运行：数据直接从来源取回本机，写入 JSON 文件，不经过第三方中转服务。

与 akshare、tushare 等 Python 数据库相比，本项目的定位是让 AI Agent 直接调用的技能包：路由说明、参数、数据边界与降级方式都写给 Agent 读。

15 层能力一览

另有证券代码归一化、聚宽代码转换和估值计算等本地工具。完整端点、参数和市场限制见 SKILL.md 路由表；能取到某类数据不代表覆盖所有市场或所有日期。

数据来源

腾讯财经 · 东方财富 · 同花顺 · 新浪财经 · 百度股市通 · 通达信 · 巨潮资讯 · 财联社 · 华尔街见闻 · 央视网 · baostock · 申万 · iwencai · 上交所 · 深交所 · 上期所 · 上期能源 · 郑商所 · 广期所 · 中金所 · 上海黄金交易所 · 中证指数 · 国证指数 · 中债 · 中国货币网 · 人民银行 · 国家统计局

各接口的用途、限制和备用关系见 来源与降级说明。

安装

1. 安装 Skill（推荐）

需要 Node.js 22.20+ / npm。Skills CLI 直接以 GitHub 仓库为来源，不需要 npm 包；显式使用 skills@latest 可避开旧版全局目录兼容问题：

# 交互式全局安装，自动识别已安装的 Agent
npx --yes skills@latest add clawyi-com/china-market-data -g

# 指定宿主并跳过确认
npx --yes skills@latest add clawyi-com/china-market-data -g -y --agent cursor

# 只查看仓库中可安装的技能
npx --yes skills@latest add clawyi-com/china-market-data --list

也可在 skills.sh 查看。不加 -g 时安装到当前项目，加 -g 后全局可用。Skills CLI 会复制仓库中除 .git 外的文件（包括 tools/setup_env.py），但不会安装 Python 依赖。

2. 安装 Python 依赖

需要 Python 3.9+。初始化脚本会在技能目录内创建 .venv、安装依赖并执行离线检查；全局安装的副本默认位于 ~/.agents/skills/china-market-data。

macOS / Linux：

SKILL_DIR="$HOME/.agents/skills/china-market-data"
python3 "$SKILL_DIR/tools/setup_env.py"

Windows PowerShell：

$SkillDir = "$env:USERPROFILE\.agents\skills\china-market-data"
py -3 "$SkillDir\tools\setup_env.py"

更新后需重新初始化：npx skills update 或重新安装会整体替换技能目录，目录内的 .venv 也会被删除。更新后请再运行一次上面的 setup_env.py，或者按下文把虚拟环境放在技能目录外。

--check 检查全部依赖，不请求行情。腾讯报价等入口只用标准库，可以不装全部依赖直接运行。依赖使用版本范围，没有为所有系统锁定完整组合；Windows 命令未经过完整平台实测。

业务 CLI 与 run.py 会自动切换到技能目录内的 .venv，不会自动安装依赖或修改全局 Python。作为 Python 库导入时，由调用方选择解释器。移动目录或换机器后应重新创建 .venv，不要复制已有虚拟环境。Windows 下文中的 python3 换成 py -3（没有 py 启动器时用 python）；输出流不支持中文时脚本自动改用 UTF-8。

3. 开发者安装

需要修改代码或保留完整 Git 历史时：

git clone https://github.com/clawyi-com/china-market-data.git
cd china-market-data
python3 tools/setup_env.py

手动复制或解压时，目标目录必须命名为 china-market-data，并保留 SKILL.md、scripts/、references/、requirements.txt、LICENSE、NOTICE 和 UPSTREAM.md；不能只复制一个 Markdown 文件。

虚拟环境放在技能目录外

技能目录只读，或希望更新技能时不重建环境，可把虚拟环境放在其他位置，之后一律用该解释器运行脚本（技能目录内没有 .venv 时，脚本直接使用调用它的 Python）：

python3 <技能目录>/tools/setup_env.py --venv ~/.venvs/china-market-data
~/.venvs/china-market-data/bin/python <技能目录>/scripts/run.py --check

Windows 对应为 py -3 <技能目录>\tools\setup_env.py --venv $env:USERPROFILE\.venvs\china-market-data，解释器位于其中的 Scripts\python.exe。结果文件写到当前目录，请在可写目录下运行，或用 --output 指定路径。

宿主要求

宿主需要能读取技能文件并执行本地 Python；只能聊天、不能执行脚本的环境无法直接取数。技能不依赖特定 agent ID 或额外的项目指引文件。各 agent 的独立安装副本不会自动同步，更新时脚本与文档一起更新。

命令行使用

以下命令在技能根目录运行；输出文件需使用新文件名。

# 实时行情：裸 000001 是平安银行；上证指数用 sh000001
python3 scripts/tencent_quote.py sh000001 sz000001 510300 --output quotes.json

# 当日强势股与来源给出的题材标签
python3 scripts/run.py ths_hot_reason.py --output hot.json

# 概念板块最近 5 日涨幅；与主力资金流排名不同
python3 scripts/run.py eastmoney_signals.py board-quotes --board-type concept --period 5d --top-n 20 --output boards.json

# 查看某个命令的参数
python3 scripts/run.py eastmoney_signals.py board-quotes --help

默认板块接口失败后，可显式尝试 --source dataapi。它仍属于东财，不是独立供应商，也不保证能绕开同源故障；字段减少和单位转换见 板块排名说明。

大部分 CLI 将完整返回结构写入 JSON，终端只给预览。需要读取实际文件，不能把预览条数当成全部数据。top / bottom 本身仍受 --top-n 限制，并不保存所有中间排名。

iwencai 入口需要用户自己的 IWENCAI_API_KEY；配置方法见 技能前置说明。不要把 Key、Cookie 或会话文件提交到仓库。

数据边界

• 抓取时间不是行情时间；未知时间不能推断为“实时”。题材标签也不是已证实的上涨原因。
• 部分历史数据只有本地已保存记录，不能承诺补齐；复权、市场范围与日期语义按接口说明处理。
• 板块分页取齐不等于同一时刻的原子快照。complete 表示记录覆盖，ranking_complete 表示涨幅是否全部有效；缺失记录保留在 missing。
• 东财节流主要在单个进程内生效，多 agent 并发不会自动获得跨进程全局限流。
• 接口可能出现限流、认证变化、缺失、延迟或下线。失败应明确报告，不用空数据伪装成功。
• 少数继承接口仍使用明文 HTTP（如强势股、部分期货接口），传输内容存在被观察或篡改的风险，不应据此宣称端到端安全或直接驱动交易。
• 本工具提供数据获取与研究辅助，不提供交易执行或收益保证；也不是回测引擎。

代码开源不代表数据开放授权。 行情、新闻、研报、公告及其他返回内容的使用、存储、展示和再分发需遵守对应供应商条款。免费或免 Key 不等于可以自由商用；本项目没有逐项取得这些数据的再分发授权。

开发与验证

开发验证使用当前仓库的 Git 检出；正式技能 ZIP 不含测试套件。

python3 -m compileall -q scripts tools tests
python3 -m unittest discover -s tests -v
python3 tools/build_release.py
npx --yes skills@latest add . --list

这些检查不请求实时行情；离线测试通过不证明上游数据源此刻可用。GitHub Actions 会在 push 和 pull request 上执行编译、smoke tests、Skills CLI 发现与发布包校验。版本变化见 CHANGELOG.md，贡献规则见 CONTRIBUTING.md，发布检查见 docs/PUBLISHING.md。

许可证与致谢

代码按 Apache License 2.0 分发，保留上游 Copyright 2026 Simon Lin。再分发时应保留许可证及相关声明，并为修改文件注明改动；详情见 NOTICE。第三方依赖按各自许可证提供。

感谢 a-stock-data 的原始工作。上游更新历史 保留用于追溯；上游版本号不代表本衍生版本已经发布了同名版本。