悟道数据接入文档

认证

悟道数据使用 API Key 认证。请在开发者控制台创建密钥，并在请求头中携带：

Authorization: Bearer YOUR_API_KEY

如果所在平台把 Authorization 请求头留作自用（例如 Smithery），改用 X-API-Key: YOUR_API_KEY，两种写法用的是同一个 Key。

MCP Server

悟道数据主入口是股票数据 MCP Server：https://stock.quicktiny.cn/api/mcp，远程 HTTP（Streamable HTTP，无状态），不提供 stdio。支持 MCP 的智能体可以通过 tools/list 动态发现工具，再用 tools/call 查询行情、涨停板、资金分析和市场情报。全部工具见 工具清单。

{
  "mcpServers": {
    "wudao": {
      "url": "https://stock.quicktiny.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

客户端配置

所有客户端填的都是同一个地址和同一个请求头：https://stock.quicktiny.cn/api/mcp 和 Authorization: Bearer YOUR_API_KEY，区别只在配置写在哪里。把 YOUR_API_KEY 换成在 开发者控制台 创建的悟道 Key，不是模型服务商的 Key。

Claude Code

在终端执行下面的命令；加 --scope user 可以在所有项目里使用：

claude mcp add --transport http wudao https://stock.quicktiny.cn/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

实测记录：2026-10-06 用 Claude Code 2.1.284 连接后能发现工具；trading_calendar 查询 2026-10-06 返回“非交易日”，limit_up_ladder 查询 2026-09-30 返回涨停 52 只、最高 7 板，梯队为 7 板 1 只、4 板 1 只、3 板 4 只、2 板 6 只、首板 40 只。

Cursor

在全局的 ~/.cursor/mcp.json 或项目里的 .cursor/mcp.json 加入下面这段；已有其他服务时只合并 wudao 这一项：

{
  "mcpServers": {
    "wudao": {
      "url": "https://stock.quicktiny.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex

用 Codex CLI 添加远程服务，Key 放在环境变量里，不写进配置文件：

export WUDAO_API_KEY=YOUR_API_KEY
codex mcp add wudao --url https://stock.quicktiny.cn/api/mcp \
  --bearer-token-env-var WUDAO_API_KEY

写法按 Codex CLI 0.130.0 的 codex mcp add --help 核对。连上以后，可以先让 Codex 写一个复盘脚本：

请使用悟道 A股股票数据 MCP 设计一个盘后复盘脚本。

要求：
1. 先调用 trading_calendar 确认交易日，再调用 market_overview 获取涨跌家数和成交额。
2. 调用 limit_up_ladder 和 theme_intraday_capital，整理主线和连板高度。
3. 调用 capital_flow，观察资金是否和题材方向一致。
4. 输出 Markdown 复盘摘要，写明数据日期和缺失字段。
5. 不输出买卖建议，不生成自动交易动作。

WorkBuddy

在 WorkBuddy 的设置里添加远程 HTTP MCP，再用 trading_calendar 做一次查询确认拿到了数据。完整步骤和排错见 WorkBuddy 接入指南。

OpenClaw、Hermes 等其他客户端

支持远程 HTTP MCP 的客户端，按各自的 MCP 配置方式添加远程服务即可。多数客户端接受上面 Cursor 那种 url + headers 的 JSON 写法，字段名以客户端官方文档为准。OpenClaw、Hermes 这类长期运行的 Agent 适合做每天固定时间的复盘：先查交易日，再调用 market_replay_workflow，返回日期和目标日期不一致时停下来报告，不要用前一交易日的数据代替。完整的五步复盘见 实测案例。

豆包、扣子

扣子支持 MCP 类型插件：资源库 → 新建插件，类型选 MCP，插件 URL 填 https://stock.quicktiny.cn/api/mcp；授权方式选 Service token / API key，位置 Header，Parameter name 填 X-API-Key，值填你的 API Key。确认后会自动导入工具，发布后即可在自己的智能体里使用，逐步说明见 扣子接入。

豆包等不支持远程 MCP 的平台，用 HTTP 工具调用下文的 REST 兼容入口，见 豆包接入。

配好之后的第一次查询

先让 Agent 查一个交易日，确认真的拿到了数据，再跑复盘：

请调用悟道 MCP 的 trading_calendar，查询 date="2026-09-04"。展示实际调用的工具名、返回日期和 isTradingDay；如果调用失败，原样说明错误码，不要用网页搜索结果替代。

额度与错误码

免费 Key 每天 50 次工具调用、每分钟 30 次，北京时间 09:15–10:30 暂停 MCP 调用；付费套餐 ¥1,000–5,000/年，每天 2,000–20,000 次。每次 tools/call 计 1 次，initialize 和 tools/list 不计次，同一账号下的 Key 共用额度。完整说明和额度错误码见 价格与限制；空结果、日期不一致和数据未就绪见 空数据与错误处理。

REST API

脚本、内部服务和自动化任务可以使用 REST 兼容入口。默认推荐 MCP；当客户端暂时不支持 MCP 时，可以通过 OpenClaw REST API 调用同一批 A股数据能力。

REST 兼容入口:
https://stock.quicktiny.cn/api/openclaw

核心数据集

SKILL.md 兼容文档

不支持 MCP 的客户端可以继续使用 SKILL.md 作为说明文档。MCP manifest 是工具定义主入口，SKILL.md 用于兼容旧工作流和人工阅读：

https://stock.quicktiny.cn/api/openclaw/skills/wudao-market/skill.md
https://stock.quicktiny.cn/api/openclaw/skills/wudao-limitup/skill.md
https://stock.quicktiny.cn/api/openclaw/skills/wudao-analysis/skill.md
https://stock.quicktiny.cn/api/openclaw/skills/wudao-intel/skill.md

AI 查询示例