a-stock-data

Install

npx skillfoxx add skills/a-stock-data

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a claude-code -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a cursor -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a github-copilot -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a codex -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a gemini-cli -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a cline -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a roo -y

npx skills add simonlin1212/a-stock-data --skill a-stock-data -a opencode -y

mkdir -p ~/.claude/skills/a-stock-data
curl -o ~/.claude/skills/a-stock-data/SKILL.md \
  https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md
pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl

This is third-party code. Review the repository files before installing.

What it does

The skill is a single SKILL.md file with embedded executable Python code that the agent runs directly, without a separate server. It pulls mainland China stock data from 34 sources: quotes and candles, broker research reports, capital flow and sector signals, company announcements, limit-up stock lists, ETF options, macro data and rates, futures and convertible bonds. For each request the skill picks a working source and falls back to an alternate one if the primary is unavailable.

Who it is for. For analysts and developers who need real Chinese A-share market data directly inside their agent chat.

Example request

Check the current valuation of stock 688017 and the latest research reports on it

Limitations

The data sources are Chinese and require no keys except iwencai. Some endpoints have gone down before, as the changelog shows, and the skill falls back to an alternate source. The documentation and the SKILL.md file itself are written in Chinese. Access to the Chinese data sites from outside China is not guaranteed and may be slower than usual.

How to disable. Remove the a-stock-data folder from your skills directory, for example ~/.claude/skills/a-stock-data.

Security check

• The skill runs embedded Python code and reaches out to third-party data sites
• Some sources have gone down before and required switching to a fallback

README in short

The README describes a fifteen-layer data architecture with 87 access points across 34 sources: quotes, research reports, market signals, capital flow, news, financial statements, announcements, limit-up stock lists, ETF options, investor sentiment, macro data, indices, futures, corporate events and convertible bonds. Setup takes three steps: download the SKILL.md file into the skills folder and install the Python dependencies. The author keeps a detailed changelog with verification dates for each source. Apache 2.0 licensed.

SKILL.md

---
name: a-stock-data
description: 当任务需要写代码实际获取A股及相关市场数据时使用——行情/K线/逐笔(腾讯日周月前后复权+分钟线+当日逐笔、通达信官网全市场盘后包、百度)、研报(东财+新浪+同花顺+iwencai)、信号(热点/北向/龙虎榜/解禁/行业/板块资金流)、资金面(融资融券/大宗/股东户数/分红/资金流/ETF份额)、新闻(财联社/东财/华尔街见闻/新闻联播)、财务三表/F10/估值历史/ST名单、公告(巨潮)、打板(涨停池/连板/炸板率/监控池/异动)、ETF期权、舆情互动(互动易/上证e互动/热榜)、筹码分布、复权因子、申万行业变迁、宏观与利率(社融/PMI/中债收益率曲线/回购定盘利率/LPR/全球宏观日历)、指数成分/权重/估值/交易日历、期货与大宗商品(五家期货交易所日行情/商品与股指期权/持仓排名/期货日K含大商所/实时期货/A50/上海金)、事件驱动(业绩预告/机构调研/增减持/回购/股权质押/新股申购)、可转债等真实数据。十五层·87端点(含5备胎)·34个来源·内嵌全部可运行代码，自包含零外部文件；优先用腾讯/交易所官方等不封IP源，东财接口已内置限流防封，主源被封可查「备用源速查」降级。仅在需要调用数据接口取数时使用：A股概念解释、投资观点讨论、策略问答等无需取数的话题不要加载本skill。
origin: custom
version: 3.10.0
---

> 📦 项目主页：https://github.com/simonlin1212/a-stock-data — 更新、反馈、支持作者
> 
> 作者：Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱：simonlin0423@gmail.com

# A股全栈数据工具包 V3.10.0

十五层数据架构，87 个能力端点（82 主端点 + 5 备胎）、34 个来源。V3.10 新增的 2 个入口于 2026-09-22 实测，V3.9 新增的 25 个入口于 2026-09-20 实测；旧端点的验证日期见各章节。覆盖主板/创业板/科创板/ST，北交所覆盖依端点而异；已有备胎的数据可按「备用源速查」降级。

> **V3.10.0（逐笔替代 / 期货日 K / 行情层重排，2026-09-22）：** 85→87 个能力入口（82 主 + 5 备胎），来源数不变（34）。
> - **§1.4 腾讯逐笔 `tencent_ticks()`**：替代 #52 后返回空的 mootdx `transaction()`。最近一个交易日的全部分笔（沪深个股 + ETF），
>   收盘后与行情快照的当日成交额核对，连续竞价段缺笔直接报错；只有当日、不含北交所。
> - **§13.7 新浪期货日 K `futures_kline()`**：单个合约或主力连续的逐日 K 线，六家交易所含大商所（此前大商所只有实时价）；
>   实测价格与交易所官方逐日一致。
> - **行情层重排**：能用的在前，mootdx 行情命令移到 §1.7 留档。新旧编号对照见 Layer 1 开头；下面历史版本说明里写的仍是旧编号。
> - **期货修正**：上期能源在各类数据首日前抛 `ValueError`（此前报成「格式可能已变」的 `RuntimeError`），期权首日更正为 2021-06-21；
>   上期所日行情实测最早 2002-01-07、中金所 2010-04-16，文档原写 2015 年。

> **V3.9.0（期货大宗 / 事件驱动 / 可转债 / 利率 + 四个 issue，2026-09-20）：** 新增 §13 期货与大宗商品、§14 事件驱动、
> §15 可转债三层，并在原有各层补齐 K 线、研报、ETF 份额、新闻、ST 名单、沪市问答、利率曲线等入口。
> 12→15 层，60→85 个能力入口（80 主 + 5 备胎），22→34 个来源（新增通达信官网盘后包、华尔街见闻、央视网、上证e互动、
> 中债、中国货币网、上期所、上期能源、郑商所、中金所、广期所、上金所）；无新增安装依赖，保留 Python 3.9。
> - **#52 mootdx 行情命令失效**：通达信公开服务器的 K 线 / 盘口 / 逐笔返回 0 行，财务与 F10 正常。`tdx_client(check='finance')`
>   让财务 / F10 按财务命令验活；K 线改走 §1.5 腾讯 / §1.6 通达信盘后包，`tdx_client()` 失败时的报错直接指路。
> - **#49 商品期货 / 期权**：§13 接入五家期货交易所官方日行情与商品 / 股指期权、四家（广期所除外）的会员持仓排名，另有新浪实时期货（含大商所）、
>   A50 期指与上海金交所现货。大商所官网有反爬，日行情未接入。
> - **#53 研报来源**：新增 §2.4 新浪研报列表，作为东财之外的第二来源（只有列表，无评级与目标价）。
> - **#55 聚宽代码**：`norm_ticker()` / `get_prefix()` 认 `.XSHG` / `.XSHE`，新增 `to_joinquant()`；FAQ 说明回测能力边界。
> - 新端点统一返回带 `source` / `source_url` / `fetched_at` 的 DataFrame，「确实没有」与「接口坏了」分开报错。
>   25 个新入口于 2026-09-20 用本文件原文代码实测，见 [本次数据源整合记录](docs/source-integration-v3.9.0.md)。

> **V3.8.0（官方指数与交易基础数据，2026-09-05）：** 新增 §12 指数与交易日历层，
> 中证/国证成分与权重、中证 PE/股息率、深交所整月日历，以及沪深官方两融、北交所行情两个备胎。
> 11→12 层，54→60 个能力入口，19→22 个来源（新增中证、国证、北交所）；无新增安装依赖，保留 Python 3.9。

Related