通达信MCP插件

🚀 快速开始（工具 + 技能 一键安装）

⚡ 三步启动（自动安装工具 + 44个技能）

1️⃣ 安装插件

```bash

方式B: 一键安装脚本（推荐！自动配置 Token + 安装 Skills）

方式C: 从 npm 安装（如果已发布）

npm install @tdx/tdx-finance-mcp

#### 2️⃣ 配置 API Token

**如果使用了 install.sh / install.ps1，此步已自动完成！**

手动创建配置文件 `config.json`：

或设置环境变量：

📦 安装指南

方法二：npm 全局安装

```bash npm install -g @tdx/tdx-finance-mcp

方法三：Docker 部署

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
ENV TDX_API_KEY=your-token-here
CMD ["node", "index.js"]

---

输出示例:

✅ 替代方案：使用 F10 数据模块

通过 tdx_api_data 工具调用已验证可用的 F10 Entry，可以获取部分等效数据：

使用示例（替代方案）

// 示例1: 获取事件驱动数据（替代新闻搜索）
const events = await tdx_api_data({
  entry: "TdxSharePCCW.tdxf10_gg_rdtc",
  params: ["000001", "sjcd"]  // 平安银行的近期催化事件
});
// 返回: ResultSets 包含事件名称、发生时间、影响程度等

// 示例2: 获取盈利预测数据（替代研报搜索）
const forecast = await tdx_api_data({
  entry: "TdxSharePCCW.tdxf10_gg_ybpj",
  params: ["000001", "yzyq"]  // 分析师一致预期
});
// 返回: 4张表 - EPS预测概览、历史预测记录、复权因子等

// 示例3: 获取业绩预告（替代公告搜索）
const warning = await tdx_api_data({
  entry: "TdxSharePCCW.tdxf10_gg_ybpj",
  params: ["000001", "yjyg"]  // 业绩预警/预告
});
// 返回: 业绩预告类型(预增/预减/扭亏等)、预告期间等信息

Node.js 示例:

const cookieJar = new CookieJar(); cookieJar.setCookie("session_id=YOUR_COOKIE_VALUE", "https://www.tdx.com.cn"); const resp = await fetch("https://www.tdx.com.cn/wenda/api/tools/zx_query", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ query: "低空经济" }), cookies: cookieJar }); ```

📖 详细诊断过程和更多技术细节请参考： - wenda-auth-helper.py — Python 完整诊断脚本（4种认证方法） - wenda-auth-node.js — Node.js 版诊断（无代理依赖） - wenda-deep-analyzer.py — 登录页面深度分析器

完整配置示例

查看 config.example.json

{
  "plugins": {
    "tdx-finance-mcp": {
      "enabled": true,
      "config": {
        "tdxApiToken": "TDX-your-token-here",
        "apiEndpoint": "http://tdxhub.icfqs.com:7615/TQLEX"
      }
    }
  },
  "env": {
    "TDX_API_KEY": "fallback-token"
  }
}

---

💬 快速上手示例

```bash

在 OpenClaw 对话中直接使用自然语言：

"今天A股市场的交易主线是什么？" → 自动触发 tdx-agzxsb (市场主线识别)

"查一下000001平安银行的基本信息" → 自动触发 tdx-company-info (公司信息查询)

"帮我选出今天涨幅超过5%的小盘低价股" → 自动触发 tdx-wxd-a (智能选股)

"宁德时代最近的龙虎榜数据" → 自动触发 tdx-dragon-tiger (龙虎榜查询) ```

更多提示词示例请查看 SKILLS.md → 使用提示词速查

---

在 OpenClaw 配置中启用并配置 token

```

⚙️ 配置说明

必填配置

tdxApiToken（必填）

通达信 API 授权令牌。联系通达信官方申请获取。

配置示例：

{ "tdxApiToken": "TDX-xxxxxxxxxxxxxxxx" }

可选配置

apiEndpoint（可选）

仅对服务器1的工具生效（tdx_api_data, tdx_quotes, tdx_kline, tdx_screener, tdx_indicator_select）。

默认值: http://tdxhub.icfqs.com:7615/TQLEX

优先级： 1. 参数中指定的 apiEndpoint 2. 插件配置中的 apiEndpoint 3. 环境变量 TDX_API_DATA_ENDPOINT 4. 环境变量 TDX_API_DATE_ENDPOINT 5. 环境变量 TDX_API_ENDPOINT 6. 硬编码默认值

环境变量汇总

📡 三大 API 服务器速查表

⚠️ 重要提示: 不同工具使用不同的 Entry 名称和请求体格式，详见下方 API 文档。不要根据工具名猜测 Entry 名称！

---

⚠️ API 权限说明（重要！）

最后更新: 2026-05-24 | 测试 Token: TDX-3d84119f... 测试环境: Node.js v25.2.1 | 所有接口均通过实际调用验证

🔍 自测权限方法

你可以使用插件自带的权限检查工具：

```bash

方法1: 快速检查（9个核心接口）

node check-api-status.js

方法2: 深度权限验证（27个Entry）

node deep-permission-test.js

方法3: F10 Entry 完整扫描（35个）

node scan-f10-v3.js

方法4: Wenda 认证诊断

node wenda-auth-node.js

🔄 Wenda 接口替代方案

问题: wenda_news_query、wenda_report_query、wenda_notice_query 返回 {"code":401,"msg":"need login"} 原因: Wenda 问达平台 (www.tdx.com.cn/wenda) 使用独立的认证系统，与 TDX Hub 的 Token 不互通。 诊断时间: 2026-05-25 | 诊断工具: wenda-auth-node.js

❌ Wenda 接口当前状态

已测试的认证方式（全部失败）: - ❌ Token Header (token: TDX-xxx) - ❌ Bearer Token (Authorization: Bearer TDX-xxx) - ❌ X-TDX-Token / X-Auth-Token / access_token / apikey - ❌ TDX Hub SSO Exchange Entry（5种尝试，均返回 E|-7202 未注册）

方法一：本地开发模式

```bash git clone https://github.com/adambbhe/tdx-finance-mcp-plugin.git cd tdx-finance-mcp-plugin npm install

📚 API 文档

⚠️ 每个工具的 Entry 名称、请求体格式和目标服务器都不同。以下信息均从源码 index.js 中提取验证，请勿自行猜测。

---

工具1: `tdx_api_data` — F10 基本面数据统一接口

服务器: http://tdxhub.icfqs.com:7615/TQLEX Entry 格式: 动态，以 TdxSharePCCW. 或 TdxShareCW. 为前缀 请求体格式: { Params: [...] }

常用 Entry 列表

使用示例

// 查询盈利预测
{ "entry": "TdxSharePCCW.tdxf10_gg_ybpj", "code": "000001", "fixedTag": "yzyq" }

// 查询热点题材
{ "entry": "TdxSharePCCW.tdxf10_gg_rdtc", "code": "000001", "fixedTag": "zttzbkz" }

// 查询事件驱动
{ "entry": "TdxSharePCCW.tdxf10_gg_rdtc", "code": "000001", "fixedTag": "sjcd" }

参数模板（18种）

---

Q1: 如何获取 TDX API Token？

A: 联系通达信官方客服或销售团队，申请开通数据服务权限。Token 格式通常为 TDX-xxxx...（32位十六进制字符串）。

Q2: 所有接口都返回 503 或 S14042 错误？

A: 这通常是以下原因之一：

1. Token 权限不足：不同 Token 可能对应不同模块的访问权限。请联系通达信确认你的 Token 是否包含全部所需权限。
2. 服务端维护：部分模块可能临时不可用。建议等待后重试。
3. 网络问题：确保能访问 tdxhub.icfqs.com:7615 和 ai.icfqs.com:8965。

诊断命令（Node.js 环境）：

node -e "
const t='YOUR_TOKEN';
const h={'Content-Type':'application/json','token':t};
const ep='http://tdxhub.icfqs.com:7615/TQLEX';
(async()=>{
  const r=await fetch(ep+'?Entry=TdxShare.PBHQInfo',{method:'POST',headers:h,body:JSON.stringify({Head:{Target:'0',CharSet:'UTF8'},Code:'000001',Setcode:'0'})});
  console.log('quotes:',r.status);
  const d=await r.json();
  console.log('data:',JSON.stringify(d).substring(0,200));
})()
"

Q3: tdx_api_data 能用但 tdx_quotes/kline 返回错误？

A: 这是正常现象！不同工具使用完全不同的 Entry 名称：

• tdx_api_data → Entry 以 TdxSharePCCW. 开头（F10数据）
• tdx_quotes → Entry 是 TdxShare.PBHQInfo（行情数据）
• tdx_kline → Entry 是 TdxShare.PBFXT（K线数据）

不要根据工具名猜测 Entry！ 务必参考本文档 API 文档 中的实际定义。

TDX Finance MCP Plugin

🎯请转移到新版本V3版仓库，原有仓库的可用性进行了再次升级。

🎯https://github.com/adambbhe/TDX-finance-mcp-plugin-v3.git

🎯TDX Finance MCP Plugin v3 是一个为 OpenClaw 平台设计的金融数据服务插件，提供通达信（TDX）A 股金融数据接口的统一访问能力。 本插件封装了 6 个经过验证的核心工具，并内置 45 个专业投资分析技能，覆盖 A 股实时行情、K线、F10 基本面、智能选股、指标筛选与代码检索等需求。

🎯v3 与旧版的区别

v3 是在 v2 基础上的清理与精简版本，主要变更（详见 CHANGELOG.md）： 移除了 4 个依赖问达（Wenda）平台、长期返回 401 need login 的失效工具（wenda_news_query / wenda_report_query / wenda_notice_query / wenda_macro_query）。这些功能已在技能层迁移至 F10 模块，旧工具不再需要。 清除了此前散落在多个脚本与文档中的硬编码 API Token 与认证密钥。 删除了仓库内的调试 / 抓取 Cookie / 重复扫描脚本，只保留可发布的插件资产。 统一了版本号、仓库地址与技能数量等元数据。

现在工具层、清单（openclaw.plugin.json）与文档三者完全一致：6 个工具，全部可用。

<p align="center"> <strong>通达信金融数据服务 MCP 插件</strong><br> <em>TDX (TongDaXin) Finance Data Service Model Context Protocol Plugin</em> </p>

<p align="center"> <a href="#功能特性">功能特性</a> • <a href="#架构总览">架构总览</a> • <a href="#快速开始">快速开始</a> • <a href="#api文档">API文档</a> • <a href="#故障排查">故障排查</a> </p>

---

Q7: 插件加载成功但工具调用超时？

A: 默认超时时间为 45 秒。检查项：

1. 网络连通性：ping tdxhub.icfqs.com
2. DNS 解析是否正常
3. 是否有防火墙/代理拦截出站 7615/8965 端口
4. 尝试设置自定义 apiEndpoint 使用备用节点

---

行业对比

tdx_indicator_select message="银行业估值对比" ```

---

❓ 故障排查 & 常见问题