baostock

English | 中文

baostock-skill

Claude Code skill for BaoStock — free A-share market data API with 23 endpoints, 9 documented pitfalls, and pandas 2.0+ compatibility fixes.

What It Does

Gives Claude Code complete knowledge of the BaoStock Python API for China A-share securities data. When you ask Claude to fetch stock data, write a data pipeline, or debug BaoStock code, it knows every API, parameter, return field, and common pitfall.

23 APIs covered across 5 categories:

Category	APIs	Examples
Market Data	3	K-line (daily/weekly/monthly/minute), index, all securities
Basic Info	5	Stock info, industry classification, SSE 50/CSI 300/CSI 500 constituents
Dividends	2	Dividend data, adjustment factors
Quarterly Financial	8	Profitability, growth, solvency, cash flow, DuPont, express/forecast reports
Macroeconomic	5	Deposit/loan rates, reserve ratio, money supply (monthly/annual)

9 documented pitfalls including pandas 2.0+ crash fix, stdout pollution suppression, and string-to-numeric conversion patterns.

Installation

Method 1: Claude Code Plugin (Recommended)

# Add as marketplace
/plugin marketplace add atompilot/baostock-skill

# Install the plugin
/plugin install baostock@baostock-skill

Method 2: Manual Skill Install

# Clone and symlink
git clone https://github.com/atompilot/baostock-skill.git ~/.claude/skills/baostock-skill

# Or copy the skill file directly
mkdir -p ~/.claude/skills/baostock
curl -o ~/.claude/skills/baostock/SKILL.md \
  https://raw.githubusercontent.com/atompilot/baostock-skill/master/skills/baostock/SKILL.md

Method 3: OpenClaw / Playbooks

# Install via playbooks registry
npx playbooks add skill atompilot/baostock-skill --skill baostock

# Or install via clawhub
npx clawhub install baostock

Restart Claude Code / OpenClaw to activate.

Usage

Once installed, Claude Code automatically uses this skill when working with BaoStock. Examples:

> Help me fetch daily K-line data for sh.600000 from 2024
> Write a script to download quarterly financial data for all CSI 300 stocks
> Why is my BaoStock code crashing with pandas 2.0?
> Get dividend history for Kweichow Moutai

What Claude Learns

• Every API signature with all parameters and return fields
• Code patterns that work with pandas 2.0+ (avoiding the DataFrame.append() crash)
• 9 common pitfalls — string return types, empty turnover rates, stdout pollution, minute bar time parsing, adjustment method differences, connection recovery, index minute bar limitations, ETF coverage gaps
• Correct frequency/adjustflag values — no guessing "d" vs "daily" or "3" vs "none"

Project Structure

baostock-skill/
├── .claude-plugin/
│   ├── marketplace.json       # Plugin marketplace registration
│   └── plugin.json            # Plugin metadata
├── plugins/
│   └── baostock/
│       └── skills/
│           └── baostock/
│               └── SKILL.md   # Skill file (plugin path)
├── skills/
│   └── baostock/
│       └── SKILL.md           # Skill file (manual install path)
├── playbook.md                # OpenClaw playbook entry
├── README.md
├── README.zh-CN.md
└── LICENSE

Compatibility

Platform	Supported	Install Method
Claude Code	Yes	Plugin or manual skill
OpenClaw	Yes	Playbook
Claude Code (Codex mode)	Yes	Plugin
Any MCP-compatible agent	Yes	Read SKILL.md as context

Related

• BaoStock Official — The data platform
• baostock on PyPI — pip install baostock
• atompilot/claude-code-plugins — More Claude Code plugins

License

MIT © atompilot