通达信 MCP Skill

当用户提到「通达信」「股票行情」「选股」「个股分析」「研报」「公告」「宏观数据」「同行业对比」「条件选股」「通达信指标」时，读取本 Skill。

通过 1 个原生 HTTP MCP server 提供能力，覆盖全球股票行情、研报、公告、宏观数据等全维度查询，由 mcporter 统一驱动调用。

⚡ 强制初始化（每次加载 Skill 必须执行）

进入本 Skill 后，在执行任何用户操作之前，必须完成以下初始化流程。不得跳过此步骤。

执行步骤

Step 1：获取最新 Token

• macOS / Linux：
  bash api_key=$(bash "${SKILL_DIR}/get-token.sh")
• Windows (PowerShell)：
  powershell $apiKey = & "${SKILL_DIR}\get-token.ps1"

> 若脚本执行失败（exit code ≠ 0），提示用户在集成面板中完成通达信授权，终止后续步骤。

Step 2：检查 mcporter 是否已配置过 tdx-finance_qclaw

• macOS / Linux：
  bash existing_config=$(mcporter config get tdx-finance_qclaw 2>/dev/null)
• Windows (PowerShell)：
  powershell $existingConfig = mcporter config get tdx-finance_qclaw 2>$null

Step 3：判断并决定操作

• 已配置且 token 一致（existing_config 中的 Authorization header 包含当前 $api_key）→ 跳过配置，直接进入业务调用
• 已配置但 token 不一致（token 已轮换）→ 刷新配置：
  bash mcporter config remove tdx-finance_qclaw 2>/dev/null mcporter config add tdx-finance_qclaw "https://testmcp.tdx.com.cn:3001/qclawmcp" \ --header "Authorization=Bearer $api_key" \ --header "Accept=application/json, text/event-stream" \ --transport http --scope home
• 未配置（existing_config 为空）→ 新建配置：
  bash mcporter config add tdx-finance_qclaw "https://testmcp.tdx.com.cn:3001/qclawmcp" \ --header "Authorization=Bearer $api_key" \ --header "Accept=application/json, text/event-stream" \ --transport http --scope home

Windows (PowerShell) 等价命令：

# 刷新或新建
mcporter config remove tdx-finance_qclaw 2>$null
mcporter config add tdx-finance_qclaw "https://testmcp.tdx.com.cn:3001/qclawmcp" `
  --header "Authorization=Bearer $apiKey" `
  --header "Accept=application/json, text/event-stream" `
  --transport http --scope home

Step 4：进入业务调用

mcporter list tdx-finance_qclaw --schema           # 查看通达信服务的工具列表
mcporter call tdx-finance_qclaw.<tool> --args '{...}'

错误恢复

• mcporter call 返回 401/403 → 重新从 Step 1 开始执行完整流程
• 脚本执行失败 → 提示用户在集成面板中完成通达信授权

首次连接成功提示

Token 注入成功后，向用户展示以下提示（每次会话仅首次展示）：

> ✅ 通达信已连接成功！
>
> 💡 需要更多能力，可以前往通达信官网或者 通达信 MCP 产品页 购买配置。

能力边界提示

当遇到以下情况时，必须输出能力提示：

• 用户的问题超出当前 10 个工具的覆盖范围
• 工具返回"无权限"或"未开通该功能"
• 用户需要更高级的数据服务（如 Level-2 行情、实时资金流等）

输出模板：

> 当前通达信连接暂不支持该功能。需要更多能力，可以前往通达信官网或者 通达信 MCP 产品页 购买配置。

🚫 禁止行为

• ❌ 禁止跳过 get-token.sh 直接询问用户手动输入 Token（除非脚本失败）
• ❌ 禁止使用之前会话中缓存的 Token 值
• ❌ 禁止将 Token 明文输出到终端
• ❌ 禁止直接 curl 调用 https://testmcp.tdx.com.cn — 必须通过 mcporter

⛔ 必须遵守的规则

1. 遇到 401 / 连接失败：引导用户到集成面板重新完成通达信授权
2. 数据准确性：通达信返回的行情数据可能有延迟，向用户说明数据时间戳
3. 投资建议免责：所有分析结果仅供参考，不构成投资建议，需向用户声明

🛠️ 功能全览

通过通达信连接器，目前可以用 4 大类、10 个工具 完成以下所有操作：

1️⃣ 行情与 K 线

2️⃣ 基本面与财务分析

3️⃣ 选股与检索

4️⃣ 资讯与研究

📋 意图路由表

五、工具参数规范

> ⚠️ 以下参数基于 mcporter list tdx-finance_qclaw --schema 实时 schema 输出，参数名以工具实际接受的 JSON Schema 为准。

1. tdx_quotes — 实时行情

2. tdx_kline — K 线数据

3. tdx_api_data — 基本面/财务数据

4. tdx_indicator_select — 自然语言指标查询

5. tdx_lookup_stock — 证券代码检索

6. tdx_screener — 自然语言条件选股 🔥

> ⚠️ 注意：tdx_screener 的主参数是 message 不是 query！

7. wenda_notice_query — 公司公告

8. wenda_report_query — 券商研报

参数与 wenda_notice_query 完全相同。

9. wenda_news_query — 新闻资讯

参数与 wenda_notice_query 完全相同。

10. wenda_macro_query — 宏观数据

六、调用方式

所有工具调用统一通过 mcporter call tdx-finance_qclaw.<tool> 完成；先用 mcporter list tdx-finance_qclaw --schema 获取工具列表与参数规范，再按规范填参数。

调用示例：

# 查看可用工具列表
mcporter list tdx-finance_qclaw --schema

# 调用实时行情查询（setcode 必填！1=沪市，0=深市）
mcporter call tdx-finance_qclaw.tdx_quotes --args '{"code": "600519", "setcode": "1"}'
mcporter call tdx-finance_qclaw.tdx_quotes --args '{"code": "300750", "setcode": "0"}'

# 调用 K 线数据（日线，60根）
mcporter call tdx-finance_qclaw.tdx_kline --args '{"code": "600519", "setcode": "1", "period": "4", "wantNum": "60"}'

# 调用基本面数据（资产负债表）
mcporter call tdx-finance_qclaw.tdx_api_data --args '{"entry": "TdxShareCW.ph_agf10_cw_zcfzb", "code": "600519"}'

# 调用自然语言指标查询
mcporter call tdx-finance_qclaw.tdx_indicator_select --args '{"message": "贵州茅台的市盈率和市净率"}'

# 调用证券代码检索
mcporter call tdx-finance_qclaw.tdx_lookup_stock --args '{"query": "宁德时代"}'

# 调用条件选股（参数名是 message 不是 query！）
mcporter call tdx-finance_qclaw.tdx_screener --args '{"message": "今天涨停", "rang": "AG", "pageSize": "50"}'

# 调用公司公告查询
mcporter call tdx-finance_qclaw.wenda_notice_query --args '{"name": "贵州茅台", "bdate": "20260101", "edate": "20260612", "keywords": "分红,董事会"}'

# 调用券商研报查询
mcporter call tdx-finance_qclaw.wenda_report_query --args '{"name": "中际旭创", "bdate": "20260301", "edate": "20260612", "keywords": "评级,目标价"}'

# 调用新闻资讯查询
mcporter call tdx-finance_qclaw.wenda_news_query --args '{"name": "寒武纪", "keywords": "芯片,AI"}'

# 调用宏观数据查询（管道格式：主体|开始日期|结束日期|关键词|补充说明）
mcporter call tdx-finance_qclaw.wenda_macro_query --args '{"query": "中国|20210101|20251231||年度GDP总量"}'

七、错误处理