yrzhe/claude-skills/akshare-a-shares

A股数据查询（akshare）

本Skill指导如何基于本地 akshare 源码目录的数据接口完成 A 股数据查询，并提供一个可直接运行的脚本以便快速拉取数据。

目录约定：本地 akshare 源位于 Recents/akshare（相对当前工作目录）。如不一致，请在执行脚本前修改脚本内 AK_PATH。

快速开始

• 方式一（推荐）脚本直取：使用 scripts/akshare_fetch.py 拉取数据，支持 CSV 或 JSON 输出。
• 示例见 references/examples.md
• 方式二 内联Python：在任务中按“接口映射”选定函数与参数，直接编写最小可运行代码。

核心流程

1) 识别用户意图与来源

• 行情总览（实时行情）、历史K线（日/周/月）、分钟分时、复权、股东户数、公告检索等
• 来源优先级：未指定则默认 EastMoney(EM)；用户指明“新浪”则用 Sina 接口

2) 选择接口与参数

• 查 references/endpoints.md 的“意图→接口”映射与参数说明

3) 拉取与校验

• 使用脚本或内联Python调用；如返回为空，检查代码格式（是否需交易所前缀、日期格式、是否退市等）

4) 返回结果

• 表格/CSV/JSON；必要时附带参数回显与数据来源

接口映射总览（最常用）

• 实时全市场 A 股：stock_feature.stock_hist_em.stock_zh_a_spot_em()
• 历史K线（日/周/月，支持复权）：stock_feature.stock_hist_em.stock_zh_a_hist(symbol, period, start_date, end_date, adjust)
• 分钟分时（1/5/15/30/60，支持复权）：stock_feature.stock_hist_em.stock_zh_a_hist_min_em(symbol, start_date, end_date, period, adjust)
• 股东户数（批量/季度末）：stock_feature.stock_gdhs.stock_zh_a_gdhs(symbol)；详情：stock_feature.stock_gdhs.stock_zh_a_gdhs_detail_em(symbol)
• 公告披露（巨潮资讯）：stock_feature.stock_disclosure_cninfo.stock_zh_a_disclosure_report_cninfo(...)、stock_zh_a_disclosure_relation_cninfo(...)
• 新浪来源（如指定）：实时报价 stock.stock_zh_a_sina.stock_zh_a_spot()、日线/复权 stock.stock_zh_a_sina.stock_zh_a_daily(...)、分钟线 stock.stock_zh_a_sina.stock_zh_a_minute(...)

详细参数、示例与注意事项见 references/endpoints.md 与 references/examples.md。

使用内置脚本

脚本路径：scripts/akshare_fetch.py

• 基本用法（CSV）：
• python3 scripts/akshare_fetch.py spot --source em --format csv
• python3 scripts/akshare_fetch.py hist --symbol 600519 --period daily --start 20200101 --end 20251231 --adjust qfq --format csv
• 更多示例见 references/examples.md

脚本特性：

• 自动将 Recents/akshare 加入 sys.path，直接导入本地 akshare 源
• 默认输出到标准输出；--format json 输出JSON
• 依赖：python3、pandas、requests（Sina 接口还需 py_mini_racer）
• 若依赖缺失，会给出友好错误提示

符号与日期规范

• EM 接口通常使用纯数字代码：沪市以 6 开头（如 600519），深市以 0/3 开头（如 000001）
• Sina 接口部分函数使用带交易所前缀的代码（如 sh600519、sz000001）
• 日期：YYYYMMDD（日/周/月K）；分钟分时使用 YYYY-MM-DD HH:MM:SS
• 复权：adjust 取值 { "": 不复权, "qfq": 前复权, "hfq": 后复权 }

仅在需要时阅读的参考

• references/endpoints.md：接口清单、参数与返回字段概述
• references/examples.md：常见请求的可直接运行示例及脚本命令

请按需加载参考文件，避免无关内容占用上下文。