Skip to content

atompilot/baostock-skill

Repository files navigation

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.

License: MIT

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

License

MIT © atompilot

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors