# Akshare A Shares

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

- **Type:** Skill
- **Install:** `agentstack add skill-yrzhe-claude-skills-akshare-a-shares`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Yrzhe](https://agentstack.voostack.com/s/yrzhe)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Yrzhe](https://github.com/Yrzhe)
- **Source:** https://github.com/Yrzhe/claude-skills/tree/main/plugins/akshare-a-shares/skills/akshare-a-shares

## Install

```sh
agentstack add skill-yrzhe-claude-skills-akshare-a-shares
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Yrzhe](https://github.com/Yrzhe)
- **Source:** [Yrzhe/claude-skills](https://github.com/Yrzhe/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yrzhe-claude-skills-akshare-a-shares
- Seller: https://agentstack.voostack.com/s/yrzhe
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.