AKTools

AKTools exposes AKShare's financial data as an HTTP API and an MCP server, so you can fetch it from any programming language or AI assistant.

AKTools 把开源财经数据接口库 AKShare 的一千多个接口变成两种开箱即用的服务：

• HTTP API：一行命令启动服务，C/C++、Java、Go、Rust、JavaScript、R、MATLAB、Stata、Excel 等任何编程语言或软件都能通过网址获取数据。
• MCP 服务：在 Claude、Cursor 等 AI 助手中直接用自然语言提问，助手会自己查找接口、填写参数并取回数据。

两种方式背后是同一套接口目录、缓存和错误处理，按需选用即可。

AKTools 中文文档 | AKShare 数据字典 | 版本说明

第一次使用？ HTTP API 请从 快速入门教程 开始，约 10 分钟即可完成从安装到下载 Excel 的完整流程；AI 助手请直接看下面的 在 AI 助手中使用。

目录

• 两种使用方式
• 特性
• 安装
• 快速开始
• 调用规则
• 多语言调用示例
• 部署
• 常见问题
• 参与贡献
• 免责声明
• 许可证

两种使用方式

通过 HTTP API 获取数据

pip install aktools
python -m aktools

然后在浏览器打开 http://127.0.0.1:8080/api/public/tool_trade_date_hist_sina，看到交易日历数据即表示成功。更多用法见下文的快速开始与调用规则。

在 AI 助手中使用

先安装 uv，再把下面的配置加入 AI 助手的 MCP 配置文件，不需要事先安装 AKTools，也不需要手动启动服务：

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": ["--from", "aktools", "aktools-mcp"]
    }
  }
}

重启助手后，就可以直接提问，例如：

• “帮我查一下贵州茅台 2024 年 10 月 8 日到 11 日的前复权日线行情”
• “AKShare 里有哪些和可转债相关的接口？”
• “stock_zh_a_hist 这个接口有哪些参数，复权方式怎么填？”

助手会通过 AKTools 提供的 3 个工具完成查询：search_interfaces 搜索接口、describe_interface 查看参数、get_data 获取数据。下面是在 Claude Code 中实际提问的过程（根据真实会话记录回放）：

打开设置中的“开发者 → 编辑配置”，把上面的配置加入 claude_desktop_config.json，保存后重启 Claude Desktop。

claude mcp add aktools -- uvx --from aktools aktools-mcp

点击按钮一键添加：

也可以手动把上面的配置加入项目的 .cursor/mcp.json，或全局的 ~/.cursor/mcp.json。

已经用 python -m aktools 启动了服务，或者想让多台电脑共用一个服务时，可以让助手直接连接 http://127.0.0.1:8080/mcp，例如：

claude mcp add --transport http aktools http://127.0.0.1:8080/mcp

第一次启动时 uvx 需要下载 AKShare 等依赖（约 150 MB），可能需要几分钟。配置、局域网访问与排障详见 AI 助手（MCP）文档。

特性

• 两种方式：同一份数据既可以通过 HTTP API 获取，也可以在 Claude、Cursor 等 AI 助手中用自然语言获取
• 零配置：python -m aktools 一行命令启动服务，无需编写任何代码
• 接口全覆盖：AKShare 的每个数据接口都可以通过 /api/public/<接口名> 直接访问，AKShare 新增接口后升级即可使用
• 跨语言：返回标准 JSON，任何能发送 HTTP 请求的语言或软件都可以调用
• 接口自查：/api/interfaces 列出全部接口并支持按关键词搜索，每个接口的参数、默认值和说明都能直接查询
• 表格下载：加上 _format=csv 或 _format=xlsx 即可把数据下载为 CSV 或 Excel 文件
• 结果缓存：同一接口、同样参数在 60 秒内直接返回上次的数据，减少对上游网站的重复请求，降低被封 IP 的风险
• 自带文档：基于 FastAPI，启动后访问 /docs 即可在线查看和调试接口
• 便于部署：提供 Dockerfile，支持 Gunicorn + Uvicorn 多进程部署

安装

AKTools 要求 Python 3.11 及以上（64 位），运行环境要求与 AKShare 安装指导 一致。

pip install aktools

AKShare 的数据接口会随上游网站的变化频繁更新，遇到问题时请先把两者都升级到最新版：

pip install akshare aktools --upgrade -i https://pypi.org/simple

快速开始

1. 启动服务：

   python -m aktools
   

2. 浏览器打开以下地址：

   地址	说明
   http://127.0.0.1:8080/	主页，展示简要的使用说明
   http://127.0.0.1:8080/docs	接口导览，可在线调试
   http://127.0.0.1:8080/version	当前与最新的 AKShare、AKTools 版本
   http://127.0.0.1:8080/api/interfaces?q=历史行情	按关键词搜索接口
   http://127.0.0.1:8080/api/interfaces/stock_zh_a_hist	查看接口的参数、默认值和说明
   http://127.0.0.1:8080/api/public/tool_trade_date_hist_sina	连通性测试（新浪交易日历，无需参数且较为稳定）
   http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000	带参数获取数据

启动参数：

例如：python -m aktools --port 8888 --auto 会在 8888 端口启动并自动打开浏览器。需要让局域网内的其他机器访问时，加上 --host 0.0.0.0，其他机器通过 http://<本机 IP>:8888 访问；0.0.0.0 只表示监听所有网卡，不能当作访问地址在浏览器中打开。

调用规则

AKTools 本身不加工数据，只负责把 HTTP 请求翻译成对 AKShare 接口的调用：

GET /api/public/{接口名}?{参数1}={值1}&{参数2}={值2}
        ↓
akshare.{接口名}(参数1="值1", 参数2="值2")

• 接口名与 AKShare 的函数名完全一致。可以通过 /api/interfaces?q=关键词 搜索接口，通过 /api/interfaces/{接口名} 查看参数说明，详细的数据说明请查阅 AKShare 数据字典。
• 参数以查询字符串传递，值不需要加引号，例如 ?symbol=600000&period=weekly；不传的参数使用 AKShare 接口的默认值。
• 返回值默认是由 DataFrame 按行转换得到的 JSON 数组，日期时间字段为 ISO 8601 格式，例如 "2024-01-25T00:00:00.000"。
• 下载表格：加上保留参数 _format=csv 或 _format=xlsx，数据会以 {接口名}.csv 或 {接口名}.xlsx 文件下载，例如 /api/public/stock_zh_a_hist?symbol=000001&_format=xlsx。CSV 为带 BOM 的 UTF-8 编码，可以直接用 Excel 打开。

请求失败时返回 {"error": "错误信息"}，状态码含义如下：

多语言调用示例

以下示例均假设服务运行在 http://127.0.0.1:8080，请按实际地址和端口修改。

curl "http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=000001&period=daily&start_date=20240101&end_date=20240131&adjust=qfq"

import pandas as pd
import requests

url = "http://127.0.0.1:8080/api/public/stock_zh_a_hist"
params = {
    "symbol": "000001",
    "period": "daily",
    "start_date": "20240101",
    "end_date": "20240131",
    "adjust": "qfq",
}
r = requests.get(url, params=params, timeout=30)
r.raise_for_status()
df = pd.DataFrame(r.json())
print(df)

library(RCurl)    # 需要先安装该包
library(jsonlite) # 需要先安装该包
options(warn = -1) # 去掉无参数请求时的 warning 信息

temp_df <- getForm(
  uri = "http://127.0.0.1:8080/api/public/stock_zh_a_hist",
  symbol = "000001",
  period = "daily",
  start_date = "20211109",
  end_date = "20211209",
  adjust = "hfq",
  .encoding = "utf-8"
)
inner_df <- fromJSON(temp_df)
inner_df

api = 'http://127.0.0.1:8080/api/public/';
url = [api 'stock_zh_a_hist'];
options = weboptions('ContentType', 'json', 'CharacterEncoding', 'utf-8');
data = webread(url, 'symbol', '000001', 'period', 'daily', ...
    'start_date', '20211109', 'end_date', '20211209', 'adjust', 'hfq', options);
data % MATLAB 无法显示中文字段名，可自行改为英文字段

依赖：reqwest（启用 blocking 与 json 特性）和 serde_json。

use reqwest::blocking;
use serde_json::Value;

const URL: &str = "http://127.0.0.1:8080/api/public";

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let params = [
        ("symbol", "000001"),
        ("period", "daily"),
        ("start_date", "20240125"),
        ("end_date", "20240126"),
        ("adjust", ""),
    ];
    let resp = blocking::Client::new()
        .get(format!("{URL}/stock_zh_a_hist"))
        .query(&params)
        .send()?;

    if resp.status().is_success() {
        let data: Value = resp.json()?;
        pr