baostock - SKILL.md Agent Skill

name: baostock description: BaoStock 免费开源 A 股数据平台，无需注册、无需 API Key，支持股票行情、K线、财务数据、行业分类、指数成分股查询。当用户提及 baostock、需要获取A股历史行情、财务报表、交易日历，或需要免费、免注册的A股数据时使用。与 tushare（数据更全但需注册）和 jqdatasdk（聚宽数据）不同，baostock 完全免费无限制，适合快速入门和低成本数据需求。 metadata: {"openclaw":{"emoji":"📈","requires":{"bins":["python3"]}}}

baostock A股数据获取

任务目标

本 Skill 用于：通过 BaoStock 接口获取 A 股市场数据、财务指标和股票信息
能力包含：历史 K 线、财务数据、股票信息、行业分类、指数成分股、交易日历
触发条件：用户提及 baostock 或需要获取 A 股免费数据、历史行情、财务信息时

前置准备

依赖说明：安装 baostock 库（已包含在 dependency 中）
凭证配置：BaoStock 无需注册或 API Key，直接调用即可使用
可选配置：支持通过环境变量自定义服务器地址（用于代理场景）
- BAOSTOCK_SERVER_IP：自定义服务器 IP（用于 nginx 代理等场景）
- BAOSTOCK_SERVER_PORT：服务器端口，默认 10030

操作步骤

标准流程：
1. 确定数据需求 — 智能体理解用户意图（行情/K线/财务/股票信息等）
2. 调用对应脚本 — 根据数据类型选择脚本
3. 解析结果 — 智能体分析返回的 JSON 格式数据
脚本调用映射：
- K线/行情数据 → python scripts/market_data.py --type kline --code sh.600000 --start 2024-01-01 --end 2024-01-31
- 财务数据 → python scripts/financial_data.py --type profit --code sh.600000 --year 2023 --quarter 4
- 股票列表/信息 → python scripts/stock_info.py --type all_stocks --date 2024-01-02
- 指数成分股 → python scripts/stock_info.py --type index_stocks --index hs300
- 行业分类 → python scripts/stock_info.py --type industry
- 交易日历 → python scripts/stock_info.py --type trade_dates --start 2024-01-01 --end 2024-12-31
可选分支：
- 当需要多只股票数据：使用逗号分隔多个代码，或使用 --file 指定代码列表文件
- 当需要指定频率：使用 --frequency 参数（d/w/m/5/15/30/60）
- 当需要调整复权类型：使用 --adjust 参数（1=后复权，2=前复权，3=不复权）

使用示例

示例1：获取股票日K线数据
- 场景/输入：用户说"查看贵州茅台最近一个月的K线数据"
- 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等 OHLCV 数据
- 关键要点：调用 python scripts/market_data.py --type kline --code sh.600519 --start 2024-03-01 --end 2024-03-31 --frequency d --adjust 2
示例2：查询财务指标
- 场景/输入：用户说"获取工商银行2023年的盈利能力指标"
- 预期产出：返回 ROE、净利润率、毛利率等财务指标
- 关键要点：调用 python scripts/financial_data.py --type profit --code sh.601398 --year 2023 --quarter 4
示例3：获取沪深300成分股
- 场景/输入：用户说"查询沪深300指数的成分股列表"
- 预期产出：返回沪深300指数的所有成分股代码和名称
- 关键要点：调用 python scripts/stock_info.py --type index_stocks --index hs300
示例4：批量下载多只股票数据
- 场景/输入：用户说"下载茅台、平安、招行的2024年日K线数据"
- 预期产出：返回多只股票的 K 线数据并保存为 CSV
- 关键要点：调用 python scripts/market_data.py --type kline --code sh.600519,sz.000001,sh.600036 --start 2024-01-01 --end 2024-12-31 --output stocks.csv

快速参考

常用代码示例

import baostock as bs
import pandas as pd

# 登录系统
lg = bs.login()

# 获取日K线数据
rs = bs.query_history_k_data_plus(
    "sh.600519",
    "date,code,open,high,low,close,volume,amount",
    start_date='2024-01-01', end_date='2024-12-31',
    frequency="d", adjustflag="2"
)

# 转换为 DataFrame
data_list = []
while (rs.error_code == '0') & rs.next():
    data_list.append(rs.get_row_data())
df = pd.DataFrame(data_list, columns=rs.fields)

# 登出系统
bs.logout()

与其他数据源对比

特性	baostock	tushare	jqdatasdk	akshare
费用	免费	免费/付费	需注册积分	免费
注册要求	❌ 不需要	✅ 需要	✅ 需要	❌ 不需要
数据范围	A股为主	全面（含宏观）	A股+因子	全面（含加密货币）
K线数据	✅	✅	✅	✅
财务数据	✅	✅	✅	✅
分钟线	✅	✅	✅	✅
实时行情	❌	❌	❌	✅
特色数据	交易日历	宏观/Shibor	因子数据	龙虎榜/北向/加密货币

资源索引

脚本：

scripts/market_data.py（用途与参数：获取 K 线/行情数据，支持 --type/--code/--start/--end/--frequency/--adjust/--fields/--output）
scripts/financial_data.py（用途与参数：获取财务数据，支持 --type/--code/--year/--quarter/--output）
scripts/stock_info.py（用途与参数：获取股票列表/信息/行业/指数成分股，支持 --type/--date/--code/--index/--output）
scripts/auth.py（用途与参数：认证模块，支持自定义服务器配置）

参考文档

常用API文档（何时读取：需要使用 BaoStock Python API、查看详细 API 参数说明时）
知识库文档目录（何时读取：需要查看更为全面详细 API 参数说明时）

注意事项

BaoStock 无需注册或 API Key，直接调用 bs.login() 即可使用
BaoStock 股票代码格式：sh.600000（上海）、sz.000001（深圳）、bj.430047（北京）
部分数据（如财务数据）可能有延迟，建议在交易日 9:30-15:00 之外获取
脚本返回 JSON 格式数据，智能体负责解析并转换为用户友好的展示
每个会话必须以 bs.login() 开始、bs.logout() 结束
K 线数据默认返回字符串类型，数值计算前需用 .astype(float) 转换
非线程安全，并行下载请使用多进程而非多线程
财务数据按季度提供，报告期结束后约有 2 个月的延迟