# Akshare Data

使用 akshare-cli 获取中国及全球金融市场数据（1090+...

- Repository: https://github.com/TencentCloud/Octop (11420 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add TencentCloud/Octop --skill akshare-data -g -a claude-code -y`
Codex: `npx skills add TencentCloud/Octop --skill akshare-data -g -a codex -y`
Cursor: `npx skills add TencentCloud/Octop --skill akshare-data -g -a cursor -y`
Gemini CLI: `npx skills add TencentCloud/Octop --skill akshare-data -g -a gemini-cli -y`

## Description

使用 akshare-cli 获取中国及全球金融市场数据（1090+ 个函数）。覆盖股票、基金、期货、债券、外汇、宏观经济、指数、期权、新闻等全领域。当用户需要以下任何一种数据时触发此 skill：股票行情、历史K线、实时报价、涨停跌停池、龙虎榜、板块资金流向、基金/ETF净值、期货行情、债券/可转债、外汇汇率、宏观经济指标（GDP/CPI/PMI）、指数数据、期权数据、财经新闻。关键词触发：akshare、股票、行情、K线、基金、期货、外汇、宏观、国债、可转债、涨停、龙虎榜、板块、资金流向、stock data、market data、financial data、A股、港股、美股。即使用户只是随口提到"看看某个股票"或"最近市场怎么样"，也应触发。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AKShare 金融数据获取

`akshare-cli` 封装了 AKShare（1090+ 个函数），覆盖中国几乎所有金融数据及部分全球数据。

## 核心原则

1. **轻量优先**, 查单只股票用 `stock_individual_info_em`(0.1s)，不要用 `stock_zh_a_spot_em`(59s)。详见 `references/known-issues.md`。
2. **先查后调**, 不熟悉的函数先 `--full-help` 看参数，再 call。
3. **失败必降级**, 不要在第一次失败后就告诉用户"查不到"，走完三级降级。
4. **控制输出量**, 全量接口加 `--limit N --sort desc`，确保拿到最新数据而非最旧数据。

---

## 工作流程：发现 → 查看 → 调用 → 降级

严格按以下步骤顺序执行，不要跳步。

### 第一步：发现函数

三种方式，按场景选一种：

**A. 快捷命令**（常用场景直接用，不需要搜索）：
```bash
akshare-cli stock hist <代码> [--period daily|weekly|monthly] [--adjust qfq|hfq]
akshare-cli stock spot [--market all|sh|sz|bj|hk|us]
akshare-cli fund etf [代码]
akshare-cli futures hist <合约>
akshare-cli bond convertible
akshare-cli macro gdp | macro cpi
akshare-cli forex spot | forex hist [货币对]
akshare-cli index spot [--market global|cn]
```

**B. 关键词搜索**（知道大致方向时用）：
```bash
akshare-cli search <关键词>    # 支持中英文
```
英文匹配函数名（结果更全），中文匹配描述和分类路径。

| 用户意图 | 英文关键词（推荐） | 中文关键词 |
|---------|-------------------|-----------|
| 新闻 | `news` | `新闻` |
| 股票 | `stock` | `股票` |
| 涨停/跌停 | `stock_zt` | `涨停` |
| 龙虎榜 | `stock_lhb` | `龙虎榜` |
| 板块/概念 | `stock_board` | `板块` |
| 资金流向 | `fund_flow` | `资金流向` |
| 基金/ETF | `fund` | `基金` |
| 期货 | `futures` | `期货` |
| 债券 | `bond` | `债券` |
| 外汇 | `forex` | `外汇` |
| 宏观 | `macro` | `宏观` |
| 指数 | `index` | `指数` |

**C. 按分类浏览**（不确定关键词时用，按中文目录逐级查找）：
```bash
akshare-cli browse                                # 30 个顶级分类
akshare-cli browse 股票数据/A股/历史行情数据          # 逐级深入
akshare-cli browse --func stock_zh_a_hist         # 反查函数归属
```

### 第二步：查看参数（用快捷命令时可跳过）

```bash
akshare-cli call --full-help <函数名>
akshare-cli call --full-help fn1,fn2,fn3       # 批量查询
```

输出包括：说明、数据源、目标地址、参数（含可选值枚举）、用法示例。

仔细看参数：不同函数参数名不同（`symbol`/`code`/`indicator`），有些有枚举约束，日期一般是 `YYYYMMDD`。

### 第三步：调用

```bash
akshare-cli call <函数名> [--参数 值 ...] [--json] [--limit N] [--sort desc]
```

查最新数据时加 `--sort desc --limit N`，否则 `--limit` 会截取最旧的数据。

### 第四步：失败时三级降级

AKShare 底层爬取第三方网站，上游随时可能挂。失败后必须依次尝试：

The rest: https://github.com/TencentCloud/Octop/blob/HEAD/src/octop/infra/agents/experts/library/stock-assistant/skills/stock-info/SKILL.md