Tdx Connector

TDX Finance Skill

本 Skill 提供通达信 MCP 的完整金融数据查询能力，覆盖全球股票行情、条件选股、研究报告、公告资讯和宏观数据。

可用工具总览

实时行情优先用 tdx_quotes，K 线优先用 tdx_kline，代码查询优先用 tdx_lookup_stock，自然语言选股优先用 tdx_screener。tdx_api_data 作为统一底层入口，适合已知上游 API 名称的高级场景。

tdx_quotes - 查询实时行情

查询股票、指数、板块等的实时行情数据。

参数说明：

使用示例：

• 查询单只股票行情：调用 tdx_quotes，设置 codes 参数
• 批量查询多只股票：在 codes 中传入多个证券代码

tdx_kline - 查询 K 线数据

查询股票、指数、板块等的 K 线历史数据。

参数说明：

使用示例：

• 查询日 K 线：调用 tdx_kline，设置 period 为 day
• 查询分钟级 K 线：设置 period 为 1m 或 5m

tdx_lookup_stock - 检索证券代码

根据名称、简称或别名检索证券代码和市场代码。

参数说明：

使用示例：

• 搜索"茅台"：调用 tdx_lookup_stock，设置 keyword 为 "茅台"
• 按市场筛选：同时传入 market 参数限定交易所

tdx_screener - 自然语言条件选股

使用自然语言描述筛选条件进行选股。

参数说明：

使用示例：

• 多因子选股：调用 tdx_screener，设置 query 参数
• 行业主题筛选：在 query 中加入行业或主题关键词

tdx_indicator_select - 查询结构化指标

查询股票、指数、基金的结构化指标和资料数据。

参数说明：

使用示例：

• 查询财务指标：调用 tdx_indicator_select，传入 code 和需要的指标名
• 批量查询：一次传入多个指标名称

wenda_report_query - 查询研报

查询券商研报、评级、目标价和观点摘要。

参数说明：

使用示例：

• 查询某股票的最新研报：调用 wenda_report_query，设置 code
• 按关键词筛选：传入 keyword 参数

wenda_notice_query - 查询公告

查询公司公告、临时公告、定期报告等。

参数说明：

使用示例：

• 查询公司公告：调用 wenda_notice_query，设置 code
• 筛选特定公告类型：传入 notice_type 参数

wenda_news_query - 查询资讯

查询新闻、快讯、主题资讯和公司资讯。

参数说明：

使用示例：

• 查询公司相关新闻：调用 wenda_news_query，设置 keyword
• 按分类筛选：传入 category 参数

wenda_macro_query - 查询宏观数据

查询宏观经济、产业景气、价格、利率、货币、社融等数据。

参数说明：

使用示例：

• 查询 CPI 数据：调用 wenda_macro_query，设置 indicator 为 "CPI"
• 查询社融数据：设置 indicator 为 "社融规模"

tdx_api_data - 统一 API 调用

tdx_api_data 是最复杂、最不易被 AI 理解的工具，用于统一调用 TDX/TQLEX 内部金融 API。

适用场景：

• 已知上游 Entry 名称，需要调用对应内部接口
• 希望工具按字段自动组装上游 Params 数组
• 需要把上游 ResultSets 转成结构化结果
• 需要在单次调用中覆盖 API 端点、认证方式或响应转换方式

不适用场景：实时行情用 tdx_quotes，K 线用 tdx_kline，代码查询用 tdx_lookup_stock，自然语言选股用 tdx_screener。

参数说明

常用字段：

调用方式

优先使用自动路由（entry + 判别参数，工具自动推导 mode 和 preset）：

tdx_api_data entry="TdxSharePCCW.tdxf10_gg_ybpj" code="000001" fixedTag="yzyq"
tdx_api_data entry="TdxSharePCCW.tdxf10_gg_gsgk" fixedTag="0" code="000001"
tdx_api_data entry="TdxSharePCCW.tdxf10_gg_gdyj" code="000001" fixedTag="gdrs" pageNo="1" pageSize="20"
tdx_api_data entry="TdxSharePCCW.skef10_bk_cpbd_jczl" branch="003" code="880976" timeType="1m"

常见自动路由查询：

显式指定 mode（自动路由不支持时使用）：

raw 兜底调用（无合适 mode 时直接传 params）：

tdx_api_data mode="raw" entry="Some.Entry" params=["000001","yzyq"]

响应转换

命中自动路由时，默认使用 preset 转换结果。也可手动指定：

使用内置 preset：

tdx_api_data entry="TdxSharePCCW.tdxf10_gg_rdtc" code="000001" fixedTag="zttzbkz" responseTransform={"kind":"preset","preset":"hot_topic_board_family"}

自定义 ResultSets 转换：

tdx_api_data mode="raw" entry="Some.Entry" params=["000001"] responseTransform={"kind":"result-sets","resultSets":[{"name":"overview","index":0,"layout":"table","maxRows":20}]}

自定义转换字段：

返回结果

传了 responseTransform 且转换成功时，优先读取 response.transformed。

使用优先级建议

1. 优先使用自动路由：entry + code/fixedTag/...
2. 自动路由不支持时，显式指定 mode
3. mode 也不适合时，使用 raw 直接传 params
4. 默认转换不满足时，再传 responseTransform

排错建议

注意事项

• 需要确保 MCP 连接器已正确配置并通过授权
• 港股支持代码检索、条件选股、研报资讯，但不支持实时行情和 K 线
• 美股支持有限，主要覆盖 A 股和港股
• 单次查询返回数量建议不超过 100 条，避免数据量过大