README.zh-CN.md

English | 中文

baostock-skill

Claude Code 技能：BaoStock A 股数据 API 完整参考，覆盖 23 个接口、9 个常见陷阱、pandas 2.0+ 兼容方案。

功能

让 Claude Code 完整掌握 BaoStock Python API。当你请求获取股票数据、编写数据管道、调试 BaoStock 代码时，Claude 了解每个 API、参数、返回字段和常见陷阱。

覆盖 5 大类 23 个 API：

分类	接口数	示例
行情数据	3	K 线（日/周/月/分钟线）、指数、全部证券
基础信息	5	证券资料、行业分类、上证 50/沪深 300/中证 500 成分股
除权除息	2	分红信息、复权因子
季频财务	8	盈利、成长、偿债、现金流、杜邦、业绩快报/预告
宏观经济	5	存贷款利率、准备金率、货币供应量

9 个已文档化的陷阱：包括 pandas 2.0+ 崩溃修复、stdout 污染抑制、字符串转数值等。

安装

方式一：Claude Code Plugin（推荐）

# 添加 marketplace
/plugin marketplace add atompilot/baostock-skill

# 安装插件
/plugin install baostock@baostock-skill

方式二：手动安装 Skill

# 克隆仓库
git clone https://github.com/atompilot/baostock-skill.git ~/.claude/skills/baostock-skill

# 或直接下载 skill 文件
mkdir -p ~/.claude/skills/baostock
curl -o ~/.claude/skills/baostock/SKILL.md \
  https://raw.githubusercontent.com/atompilot/baostock-skill/master/skills/baostock/SKILL.md

方式三：OpenClaw / Playbooks

# 通过 playbooks 注册表安装
npx playbooks add skill atompilot/baostock-skill --skill baostock

# 或通过 clawhub 安装
npx clawhub install baostock

重启 Claude Code / OpenClaw 即可生效。

使用

安装后，Claude Code 在处理 BaoStock 相关工作时会自动引用此技能。示例：

> 帮我获取浦发银行 2024 年日线数据
> 写个脚本下载沪深 300 所有成分股的季度财务数据
> 为什么我的 BaoStock 代码在 pandas 2.0 下崩溃了？
> 获取贵州茅台的分红历史

Claude 学到了什么

• 每个 API 的完整签名，包含所有参数和返回字段
• 兼容 pandas 2.0+ 的代码模式（避免 DataFrame.append() 崩溃）
• 9 个常见陷阱：字符串返回类型、停牌时换手率为空、stdout 污染、分钟线时间解析、复权方式差异、连接恢复、指数不支持分钟线、ETF 覆盖不完整
• 正确的 frequency/adjustflag 取值：不再猜测 "d" 还是 "daily"、"3" 还是 "none"

项目结构

baostock-skill/
├── .claude-plugin/
│   ├── marketplace.json       # Plugin marketplace 注册
│   └── plugin.json            # Plugin 元数据
├── plugins/
│   └── baostock/
│       └── skills/
│           └── baostock/
│               └── SKILL.md   # Skill 文件（plugin 路径）
├── skills/
│   └── baostock/
│       └── SKILL.md           # Skill 文件（手动安装路径）
├── playbook.md                # OpenClaw playbook 入口
├── README.md                  # 英文 README
├── README.zh-CN.md            # 本文件
└── LICENSE                    # MIT

兼容性

平台	支持	安装方式
Claude Code	是	Plugin 或手动 skill
OpenClaw	是	Playbook
Claude Code (Codex 模式)	是	Plugin
任何 MCP 兼容 Agent	是	将 SKILL.md 作为上下文读取

相关链接

• BaoStock 官网 — 数据平台
• baostock on PyPI — pip install baostock
• atompilot/claude-code-plugins — 更多 Claude Code 插件

许可证

MIT © atompilot