悟道数据 / 把 A股数据接入 WorkBuddy

WorkBuddy 接入指南 · 从配置到首次成功

把 A股数据接入 WorkBuddy

创建悟道 API Key,添加远程 MCP,先完成一次交易日查询,再生成有数据出处的复盘报告。

悟道数据官方维护 · 更新于

01 / 连接数据源

在 WorkBuddy 添加悟道 MCP

  1. 创建悟道 API Key。打开 开发者控制台,登录后创建密钥。该控制台与连板天梯共用账号,服务提供方为杭州瞬微网络科技有限公司。
  2. 打开 WorkBuddy 的 MCP 配置。根据官方指南进入“设置 → MCP → 添加 MCP Server”,填写下面的服务地址和认证信息。界面名称随版本可能不同。
  3. 保存并检查连接。确认悟道服务器已启用,可以发现 trading_calendar 和 market_replay_workflow 等工具;随后运行下面的首次查询。
连接信息
服务名称wudao-stock-data
服务地址https://stock.quicktiny.cn/api/mcp
连接方式远程 HTTP / Streamable HTTP
认证请求头Authorization: Bearer YOUR_API_KEY

如果当前版本提供 JSON 配置入口,可以参考以下配置。替换 YOUR_API_KEY;已有其他 MCP 时只合并 wudao-stock-data 项,不覆盖整个文件。

WorkBuddy MCP 配置示例
{
  "mcpServers": {
    "wudao-stock-data": {
      "type": "streamableHttp",
      "url": "https://stock.quicktiny.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

入口与协议参考:WorkBuddy 官方 MCP 指南、官方连接器配置说明。核对日期:2026-09-07。本轮接口已实测,未宣称特定 WorkBuddy 版本已端到端验证。

02 / 先确认一次成功

先查一个交易日,确认真正拿到了数据

把下面的指令发给 WorkBuddy。这个查询不需要行情数据就绪,适合检查配置、认证和工具调用是否畅通。

首次查询指令
请调用悟道 MCP 的 trading_calendar,查询 date="2026-09-04"。请展示实际调用的工具名、返回日期和 isTradingDay;如果调用失败,原样说明错误码,不用网页搜索结果替代。
成功标准:看得到 trading_calendar 的实际工具调用,返回 date 为 2026-09-04、isTradingDay 为 true。只有聊天里说“已连接”,或只列出工具名称,还不算完成数据查询。
03 / 再跑完整场景

查询成功后,生成一份盘后复盘

沿用同一日期,核对市场宽度、涨跌停、梯队和题材数据。完整指令及实测返回值已经放在案例页。

2026-09-04 实测案例

从 39 只涨停明细到完整报告:一次 A股收盘复盘

查看完整报告、复制复盘指令,对照本次 JSON 数据摘录。

先完成单次复盘,再在 WorkBuddy 支持的任务功能中设置定时执行。每天的日期、数据就绪状态和实际交易日都需要重新核对。

04 / 遇到问题

按实际错误处理,避免反复试错

接入与查询常见状态
实际结果下一步
认证失败 / HTTP 401检查悟道 Key 是否有效、Authorization 是否包含 Bearer 和一个空格。
FREE_TIER_MARKET_OPEN_RESTRICTED免费 Key 的开盘时段限制;北京时间 10:30 后重试,或查看额度套餐。
DAILY_LIMIT_EXCEEDED检查当日额度,等待重置或按需要升级。
RATE_LIMIT_EXCEEDED降低并发并按服务返回的等待时间重试。
INVALID_ARGUMENTS按工具 schema 修正日期、股票代码等参数。
数据未就绪 / 空结果检查实际日期与质量提示;不要用另一交易日冒充目标日。

更多状态说明见 股票 Agent 空数据与错误处理。

常见问题

用模型 API Key 还是悟道 API Key?

使用悟道开发者控制台创建的 API Key,填写 Authorization: Bearer YOUR_API_KEY。模型服务商的 Key 用于模型配置,不能代替悟道的数据访问密钥。

WorkBuddy 的配置入口在哪里?

按 WorkBuddy 官方 MCP 指南,在设置中找到 MCP,添加服务器并填写 URL 与认证信息;不同版本可能以“插件 / 连接器”展示相关入口,以客户端当前界面为准。

为什么能看到工具,但查询失败?

发现工具与成功取得数据是两步。检查实际错误码,区分密钥、额度、限流、参数和数据未就绪;第一次先查 trading_calendar,成功后再跑复盘。

免费额度有什么时段限制?

当前免费 API Key 在北京时间 09:15–10:30 暂停 MCP 服务。只有实际收到 FREE_TIER_MARKET_OPEN_RESTRICTED 才按这个原因处理;一般超时或 RATE_LIMIT_EXCEEDED 不能据此认定需要购买。额度以控制台当前展示为准。

先跑通一次,再决定是否长期使用

在开发者控制台创建 API Key,完成一个交易日查询,再尝试完整复盘。免费额度、可用时段与套餐以控制台当前展示为准。