AgentSkillsCN

akshare-a-shares

针对中国A股的行情与数据查询（基于本地akshare源代码与API映射）。当用户请求获取A股实时行情、历史K线（日/周/月）、分钟级分时（1/5/15/30/60）、复权数据（前复权/后复权）、股东户数（含详情）、以及巨潮资讯公告披露结果时，可使用此技能。默认优先使用东方财富(EM)接口；如用户指定新浪(Sina)来源或需要特定接口，则按映射调用对应函数。可使用内置脚本输出CSV/JSON，或内联Python调用。

SKILL.md
--- frontmatter
name: akshare-a-shares
description: 针对中国A股的行情与数据查询（基于本地 akshare 源代码与API映射）。当用户请求获取A股实时行情、历史K线（日/周/月）、分钟级分时（1/5/15/30/60）、复权数据（前复权/后复权）、股东户数（含详情）、以及巨潮资讯公告披露结果时使用本Skill。默认优先使用东方财富(EM)接口；如用户指定新浪(Sina)来源或需要特定接口，则按映射调用对应函数。可使用内置脚本输出CSV/JSON，或内联Python调用。

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：常见请求的可直接运行示例及脚本命令

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