baostock A股数据获取

任务目标

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

前置准备

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

- BAOSTOCKSERVERIP：自定义服务器 IP（用于 nginx 代理等场景） - BAOSTOCKSERVERPORT：服务器端口，默认 10030

操作步骤

• 标准流程：

1. 确定数据需求 — 智能体理解用户意图（行情/K线/财务/股票信息等） 2. 调用对应脚本 — 根据数据类型选择脚本 3. 解析结果 — 智能体分析返回的 JSON 格式数据

• 脚本调用映射：

- K线/行情数据 → python scripts/marketdata.py --type kline --code sh.600000 --start 2024-01-01 --end 2024-01-31 - 财务数据 → python scripts/financialdata.py --type profit --code sh.600000 --year 2023 --quarter 4 - 股票列表/信息 → python scripts/stockinfo.py --type allstocks --date 2024-01-02 - 指数成分股 → python scripts/stockinfo.py --type indexstocks --index hs300 - 行业分类 → python scripts/stockinfo.py --type industry - 交易日历 → python scripts/stockinfo.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/stockinfo.py --type indexstocks --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()

与其他数据源对比

资源索引

脚本：

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

参考文档

• [常用API文档](references/api.md)（何时读取：需要使用 BaoStock Python API、查看详细 API 参数说明时）
• [知识库文档目录](references/markdown/index.md)（何时读取：需要查看更为全面详细 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 个月的延迟