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 助手中直接用自然语言提问,助手会自己查找接口、填写参数并取回数据。
两种方式背后是同一套接口目录、缓存和错误处理,按需选用即可。
第一次使用?
- 通过网址或程序获取数据:请从快速入门开始,约 10 分钟完成从安装到下载 Excel 的完整流程。
- 在 AI 助手中使用:请看在 AI 助手中使用,约 3 分钟完成配置。
适合谁用¶
- 使用 R、MATLAB、Stata、Excel 等软件,想直接获取 AKShare 财经数据的研究人员
- 使用 Java、Go、JavaScript 等语言开发应用,需要一个财经数据服务的开发者
- 希望把数据获取集中在一台服务器上,供团队成员共同使用的团队
- 使用 WorkBuddy、Codex、Cursor、Claude 等 AI 助手做研究或写代码,想让助手直接查询财经数据的用户
什么情况下不必用 AKTools¶
AKTools 是 AKShare 外面的一层 HTTP 转发,并不改变 AKShare 本身的特点。以下情况可以考虑其他方式:
- 个人在 R、Stata 中使用:R 的 reticulate、Stata 16 及以上的
python代码块都能直接调用 AKShare,不需要额外运行一个服务。AKTools 同样需要安装 Python,它省去的是编写 Python 代码,而不是安装 Python。 - 生产或商业用途:AKShare 的数据来自公开网页,网站改版时接口可能失效,数据仅供学术研究使用。对稳定性和授权有要求时,请使用有授权的商业数据源。
- 需要长期、可复现的历史数据:每次请求都会实时访问上游网站。做研究时,更稳妥的做法是定期把数据保存到本地文件或数据库,研究时读取本地数据。
- 部署到公网供不特定的人使用:AKTools 只提供共享的访问令牌,不提供用户登录和限流;所有请求都从服务器的同一个 IP 访问上游网站,请求量大时容易被封 IP,转发数据也可能违反数据源的使用条款。
特性¶
- 两种方式:同一份数据既可以通过 HTTP API 获取,也可以在 WorkBuddy、Codex、Cursor、Claude 等 AI 助手中用自然语言获取,详见AI 助手(MCP);与 AKQuant 联用时,AI 还能接着写策略、跑回测并解读结果
- 零配置:
python -m aktools一行命令启动服务,无需编写任何代码 - 接口全覆盖:AKShare 的每个数据接口都可以通过
/api/public/<接口名>直接访问,AKShare 新增接口后升级即可使用 - 跨语言:返回标准 JSON,任何能发送 HTTP 请求的语言或软件都可以调用
- 接口自查:通过
/api/interfaces按关键词搜索接口,直接查看每个参数的默认值和说明,详见接口目录 - 表格下载:加上
_format=csv或_format=xlsx,即可把数据下载为 CSV 或 Excel 文件,详见下载 CSV 与 Excel - 结果缓存:同一接口、同样参数在 60 秒内直接返回上次的数据,减少对上游网站的重复请求,详见数据缓存
- 自带文档:基于 FastAPI,启动后访问
/docs即可在线查看和调试接口 - 便于部署:提供 Dockerfile,支持 Gunicorn + Uvicorn 多进程部署,详见部署
工作原理¶
AKTools 把每个 HTTP 请求翻译成一次同名的 AKShare 接口调用,再把返回的表格数据转成 JSON:
浏览器或程序发出请求:GET /api/public/stock_zh_a_hist_sina?symbol=sh600519
↓
AKTools 调用同名接口:akshare.stock_zh_a_hist_sina(symbol="sh600519")
↓
AKShare 从新浪财经等网站获取数据,AKTools 以 JSON、CSV 或 Excel 格式返回
因此接口有哪些、参数怎么填、数据是什么含义,都以 AKShare 为准。您可以通过 AKTools 的接口目录查询,也可以查阅 AKShare 数据字典。
3 步快速体验¶
HTTP API¶
已经安装了 Python 3.11.5 及以上版本?只需 3 步:
- 在命令行运行
python -m aktools启动服务 - 浏览器打开
http://127.0.0.1:8080/api/public/calendar_trade_date_hist_sina,看到交易日历数据即表示成功 - 浏览器打开
http://127.0.0.1:8080/api/interfaces?q=历史行情,搜索您需要的接口
AI 助手¶
- 安装 uv
-
把以下配置加入 WorkBuddy、Cursor、Claude Desktop 等 AI 助手的 MCP 配置文件,然后重启助手:
-
直接提问,例如“帮我查一下贵州茅台 2024 年 10 月 8 日到 11 日的前复权日线行情”
使用 WorkBuddy 时,也可以直接说“安装 AKShare 的官方 MCP”,由它自己完成配置。各客户端的配置方法见AI 助手(MCP)。
文档导航¶
| 页面 | 内容 |
|---|---|
| 快速入门 | 从安装到下载 Excel 的完整教程,新手请从这里开始 |
| 调用规则 | 网址怎么写、参数怎么传、返回什么格式、出错了怎么看 |
| 接口目录 | 搜索接口、查看参数说明 |
| 多语言调用 | curl、Python、JavaScript、R、MATLAB、Rust 示例代码 |
| AI 助手(MCP) | 在 WorkBuddy、Codex、Cursor、Claude 等 AI 助手中用自然语言获取数据,与 AKQuant 联用自动回测 |
| 部署 | 启动参数、局域网访问、生产环境与 Docker 部署 |
| 常见问题 | 502、404、无法访问、版本升级等问题的排查方法 |
| 版本说明 | 每个版本的更新内容 |
相关链接¶
- AKTools GitHub 仓库:提交 Issue 或 Pull Request 前请阅读贡献指南
- AKShare 文档
- FastAPI 文档