Repolode
akfamily

akfamily/aktools

把 AKShare 财经数据接口封装为 HTTP API 和 MCP 服务,供任意语言及 Claude、Cursor 等 AI 助手调用。

Star
1,557
Fork
250
未关闭 Issue
0
最近提交
21小时前

本页只介绍开源项目,不构成投资建议。交易和投资可能造成亏损,使用前请自行评估风险,并遵守当地法律法规。

这是什么?

AKTools 把 AKShare 提供的一千多个财经数据接口封装成 HTTP 服务。每个 AKShare 接口都可以通过 /api/public/接口名 直接访问,参数用查询字符串传递,返回标准 JSON,也可以直接下载为 CSV 或 Excel 文件。

项目同时提供 MCP 服务,Claude Desktop、Claude Code、Cursor 等 AI 助手可以用自然语言搜索接口、查看参数并获取数据。安装只需 pip install aktools,之后执行 python -m aktools 即可启动,MCP 配置也可以通过 uvx 直接运行。

服务默认对相同请求缓存 60 秒以减少对上游网站的访问,支持通过 --token 设置访问令牌,并提供 Dockerfile 用于 Gunicorn + Uvicorn 部署,启动后可在 /docs 调试接口。

核心功能

  • 01将 AKShare 的每个数据接口暴露为返回 JSON 的 HTTP GET 地址。
  • 02为 Claude、Cursor 等支持 MCP 的 AI 助手提供 MCP 服务。
  • 03通过 _format 参数把结果下载为 CSV 或 Excel 文件。
  • 04支持搜索接口,并查看每个接口的参数和默认值。
  • 05默认缓存相同请求 60 秒,减少对上游网站的重复访问。
  • 06支持可选访问令牌、代理配置,并提供 Dockerfile 部署。

适用场景

  • 把 A 股历史行情拉取到 Python、R 或 MATLAB 分析脚本中。
  • 让 AI 助手通过实时数据回答股票、可转债等相关问题。
  • 无需编写爬虫,直接把财经表格导出为 Excel 用于报告。
  • 为团队部署带访问令牌的共享内部数据服务。

快速上手

  1. 1

    从 PyPI 安装 AKTools

    pip install aktools
  2. 2

    启动 HTTP 服务

    python -m aktools
  3. 3

    在浏览器中打开测试地址,确认交易日历数据能正常返回

使用前须知

  • 数据来自公开的上游网站,网站改版或限制访问时部分接口可能失效。
  • 需要 Python 3.11 及以上的 64 位版本。

收录于专题

标签

常见问题

aktools 是什么?
把 AKShare 财经数据接口封装为 HTTP API 和 MCP 服务,供任意语言及 Claude、Cursor 等 AI 助手调用。 AKTools 把 AKShare 提供的一千多个财经数据接口封装成 HTTP 服务。每个 AKShare 接口都可以通过 /api/public/接口名 直接访问,参数用查询字符串传递,返回标准 JSON,也可以直接下载为 CSV 或 Excel 文件。
aktools 可以免费使用吗?用的什么许可证?
aktools 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
aktools 还在维护吗?
活跃维护中。aktools 最近一次提交是在 2026年11月6日。
aktools 适合用来做什么?
把 A 股历史行情拉取到 Python、R 或 MATLAB 分析脚本中。 让 AI 助手通过实时数据回答股票、可转债等相关问题。 无需编写爬虫,直接把财经表格导出为 Excel 用于报告。 为团队部署带访问令牌的共享内部数据服务。
aktools 怎么安装和运行?
从 PyPI 安装 AKTools: pip install aktools 启动 HTTP 服务: python -m aktools 在浏览器中打开测试地址,确认交易日历数据能正常返回
在哪里获取 aktools?
源代码和安装说明在 GitHub 上:https://github.com/akfamily/aktools

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目