| name | stock-data-fetcher |
| description | 获取A股数据(baostock)并缓存到本地CSV文件,避免MCP返回大量数据占用上下文。触发场景:(1)获取超过100条的K线数据 (2)需要多次查询同一股票数据 (3)需要用grep/awk分析数据 (4)用户提到"保存数据"或"缓存数据" |
Stock Data Fetcher
获取A股数据并保存到本地CSV,通过grep/read按需查看,避免上下文膨胀。
快速开始
# 获取K线数据(默认1年,前复权,保存到 ./data/cache)
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138
# 获取近2年数据
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138 --days 730
# 指定日期范围
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.600000 --start 2024-01-01 --end 2024-12-31
# 获取财务数据
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138 --type profit --year 2024 --quarter 3
# 指定缓存目录
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138 --cache-dir ./my_data
# 或通过环境变量设置缓存目录
STOCK_CACHE_DIR=./my_data uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138
缓存目录
优先级: --cache-dir > STOCK_CACHE_DIR 环境变量 > ./data/cache
{cache_dir}/
sh_601138/
daily_2024-01-01_2024-12-31.csv # K线
profit_2024Q3.csv # 盈利
growth_2024Q3.csv # 成长
数据类型
| 类型 | 参数 | 说明 |
|---|---|---|
| kline | --freq d/w/m |
K线,支持日/周/月/分钟 |
| profit | --year --quarter |
盈利能力(ROE/净利率等) |
| growth | --year --quarter |
成长能力(YOY增长率) |
| balance | --year --quarter |
偿债能力(资产负债率等) |
| cashflow | --year --quarter |
现金流 |
| dupont | --year --quarter |
杜邦分析 |
| dividend | --year |
分红数据 |
查看缓存数据
# 列出所有缓存
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py --list
# 列出指定股票缓存
uv run python .claude/skills/stock-data-fetcher/scripts/fetch_stock_data.py sh.601138 --list
# 查看最近10条
tail -10 data/cache/sh_601138/daily_*.csv
# 搜索特定月份
grep "2024-09" data/cache/sh_601138/daily_*.csv
# 筛选涨幅>5%的日期
awk -F',' 'NR==1 || $13>5' data/cache/sh_601138/daily_*.csv
K线字段
| 字段 | 说明 |
|---|---|
| date | 日期 |
| open/high/low/close | 开高低收 |
| volume | 成交量(股) |
| amount | 成交额(元) |
| turn | 换手率(%) |
| pctChg | 涨跌幅(%) |
| peTTM | 滚动市盈率 |
| pbMRQ | 市净率 |
依赖
首次使用需安装: uv add baostock pandas