AKTools

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 服务：在 WorkBuddy、Codex、Cursor、Claude 等 AI 助手中直接用自然语言提问，助手会自己查找接口、填写参数并取回数据。

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

[AKTools 中文文档](https://aktools.akfamily.xyz/) | [AKShare 数据字典](https://akshare.akfamily.xyz/data/index.html) | [版本说明](https://aktools.akfamily.xyz/aktools_version/)

第一次使用？ 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 中实际提问的过程（根据真实会话记录回放）：

与 AKQuant 联用，一句话体验 AI 量化回测：在 WorkBuddy 中输入“安装 AKShare 和 AKQuant 各自的官方 MCP，运行一个示例策略并报告结果”，AI 会自动下载数据、运行回测、解读结果，并给出改进策略的建议。详见与 AKQuant 联用。

WorkBuddy

直接对 WorkBuddy 说“安装 AKShare 的官方 MCP”，它会自己完成配置。也可以手动把上面的配置加入 WorkBuddy 的连接器（MCP）设置，或用户级配置文件 ~/.workbuddy/mcp.json；国内网络可以在 aktools 下加上 "env": {"UV_INDEX_URL": "https://mirrors.aliyun.com/pypi/simple/"} 使用镜像源。

Codex

codex mcp add aktools -- uvx --from aktools aktools-mcp

Cursor

点击按钮一键添加：

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

Claude Code

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

Claude Desktop

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

连接已经运行的 AKTools 服务（HTTP 方式）

已经用 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 获取，也可以在 WorkBuddy、Codex、Cursor、Claude 等 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. 启动服务：

shell python -m aktools

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

启动参数：

例如：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

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"

Python

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)

R

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

MATLAB

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 无法显示中文字段名，可自行改为英文字段

Rust

依赖：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 > { 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()?; println!("{data:#?}"); } else { eprintln!("请求失败，状态码为：{}", resp.status()); } Ok(()) }

更多示例及运行结果，请见 多语言调用。

部署

Docker

使用仓库中的 Dockerfile 构建镜像，镜像默认以 Gunicorn + Uvicorn worker 运行，worker 数量可用 -e WEB_CONCURRENCY=4 调整：

docker build -t aktools .

docker run -d -p 8080:8080 aktools

国内网络通常无法访问 Docker Hub 与官方 PyPI，可以分别指定镜像：

docker build --build-arg BASE_IMAGE=docker.m.daocloud.io/library/python:3.14-slim-trixie --build-arg PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ -t aktools .

镜像升级等更多说明，请见 部署文档。

生产环境

python -m aktools 适合本地使用。生产环境建议直接用 Gunicorn 启动 aktools.main:app：

pip install gunicorn uvicorn-worker

AKTOOLS_HOST=0.0.0.0 gunicorn aktools.main:app --bind 0.0.0.0:8080 --workers 4 --worker-class uvicorn_worker.UvicornWorker

多人或多台电脑共用服务时，可以用 --token 设置访问令牌，详见 访问令牌。AKTools 不提供用户登录，需要按人管理权限时，请在前面加一层带认证的反向代理。

常见问题

返回 502，提示“访问上游数据源失败”

运行 AKTools 的机器无法访问东方财富、新浪财经等上游网站，通常是代理配置导致的。报错中如果出现 ProxyError 或 Unable to connect to proxy，请检查或清除代理相关的环境变量后重启服务：

# Linux / macOS

unset HTTP_PROXY HTTPS_PROXY ALL_PROXY

Windows PowerShell

Remove-Item Env:HTTP_PROXY, Env: