A股数据获取

骨架版（v0.1.0）：核心脚本与单测已就绪，后续按文末「完善清单」逐技能打磨提示词与边界。

概述

把散户/研究员最常用的「抓行情」变成一行命令，结果直接存 CSV 进 Excel 或分析流程。区别于 heavy 金融框架，akshare 是轻量数据接口聚合。

何时使用

• 获取某只 A 股的历史 K 线
• 导出行情数据做分析
• 查板块、指数、宏观等公开数据

快速使用

# 获取 600519（贵州茅台）日线并导出
python3 scripts/akshare_fetch.py 600519 -o 茅台.csv

# 指定区间
python3 scripts/akshare_fetch.py 600519 --start 20240101 --end 20240630 -o 茅台.csv

依赖安装

# 提示：脚本用相对路径 scripts/，请先 cd 到本技能目录再运行
python3 -m pip install akshare

常见错误 / 注意

• 必须联网；接口稳定性随数据源变化，失败可重试或换周期
• akshare 安装体积偏大（依赖较多），但仍为纯 Python 无 torch
• 仅获取公开行情，非投资建议

实测验证（v0.1.0）

• 核心依赖：akshare
• 安装体积：🟡 202.0 MB（依赖闭包实测，中量级）
• 环境要求：必须联网。依赖 mini-racer（内嵌 V8，约 61MB）用于解析部分数据源。
• 单元测试：python3 -m unittest tests.test_...（须 cd 到本技能目录运行）
• CLI 冒烟：已通过端到端实测

已验证行为

• ✅ 离线时优雅降级：明确提示「获取失败（需联网）」，不崩溃

已知边界 / 坑

• ⚠️ 依赖第三方数据源接口，对方改版会导致取数失败
• ⚠️ 国内网络环境更稳，海外服务器可能取不到数据

完善清单（骨架后待补齐）

• [ ] 补充更丰富的示例与边界处理
• [ ] 增加批量 / 多格式模式
• [ ] 写更完整的自测说明与示例文件
• [ ] 打磨触发词与用户引导话术（对齐本生态其他技能风格）