About this project

a-stock-data is a self-contained Skill file that consolidates raw A-share data scattered across 22 data sources into a ready-to-use toolkit for AI coding assistants (Claude Code / Codex / OpenClaw). Users need not handle mootdx K-line parameters, East Money PDF Referer headers, or iwencai X-Claw authentication, as all are pre-packaged. The twelve-layer architecture covers market quotes, research reports, signals, capital flows/chip distribution, news, fundamental data, announcements, limit-up trading, ETF options, sentiment interactions, macro data, and index calendars, totaling 60 capability entry points. Primary sources are ranked by IP-blocking risk: mootdx and Tencent are prioritized (no IP blocking), East Money is used only for exclusive data and uniformly accessed via em_get() with serial rate limiting to prevent blocking; others like Hithink RoyalFlush, Baidu, Sina, CNINFO, baostock, Shenwan, People's Bank of China, National Bureau of Statistics, CSI, China Securities Index, and Shanghai/Shenzhen/Beijing Stock Exchanges are directly connected via HTTP APIs without third-party wrappers. Except for iwencai semantic search requiring an API Key, all other data sources require zero authentication. Built-in fallback source quick-reference and degradation strategies include official dragon-tiger lists, capital flows, announcements, margin trading, and Beijing Stock Exchange market backups. Quick start takes 3 steps: deploy SKILL.md under ~/.claude/skills/a-stock-data/ and install dependencies, then say "Help me check the valuation of 688017" in Claude Code to auto-activate. The FAQ details non-current index weights, margin and Beijing Stock Exchange backup usage, mootdx httpx version conflict workarounds, overseas server timeout recommendations, East Money 403 rate-limit and network-switching countermeasures, CLS v1 interface zero-key signature revival, and Beijing Stock Exchange old-to-new code migration notes. Verification passes via python3 -m unittest discover, which auto-extracts the current version's code from SKILL.md for testing.