🚀 TianAPI AI 能力开放平台

为 AI Agent 提供 安全、稳定、开箱即用 的真实世界连接能力 —— 全面涵盖标准化 MCP 服务、OpenAPI 3.0 文档与 ClawHub 生态技能,一站式赋能智能体开发。

三大核心接入方式

无论你是低代码用户、专业开发者还是生态构建者,我们都能提供最适合的连接方案。

MCP 服务

面向 AI Agent 的“开箱即用”工具。自动处理鉴权和参数解析,让大模型直接调用真实世界数据,无需编写代码。

了解详情 ↓

OpenAPI 3.0

面向开发者的标准接口规范。提供完整的 JSON 文档,支持一键导入 Postman/Apifox,适合深度定制与调试。

查看文档 ↓

ClawHub 技能

面向生态的云端技能。遵循 OpenClaw 标准,无需手动封装 HTTP,即可在各类 AI 平台中跨平台调用复杂编排。

探索生态 ↓

什么是 MCP?

TianAPI MCP(Model Calling Protocol) 是天聚数行基于标准 MCP 协议实现的工具调用服务。我们将复杂的API调用过程封装为语义清晰、参数规范的“工具函数”,使大语言模型(LLM)驱动的智能体能够在推理过程中安全、可靠地调用服务。开发者或普通用户无需编程即可轻松实现在支持MCP协议的AI客户端(如 GitHub Copilot、Cherry Studio 等)中直接调用接口,实现智能上下文感知数据查询。

核心优势:
  • 自动鉴权:API Key 由服务端注入,前端/提示词中永不暴露;
  • 结构化输出:返回字段已清洗、命名规范,LLM 可直接理解;
  • 统一错误处理:网络异常、参数错误、配额超限均有标准响应;
  • 零代码适配:Cherry Studio、Dify、Coze等平台原生支持 MCP 协议;
  • 多工具聚合:可将多个 API 封装为一个 MCP 服务,统一管理、一键调用。
天气预报API接口

MCP vs 传统 API 调用

维度 传统方式 MCP 方式
API Key 管理 需写入提示词或环境变量,易泄露 服务端自动注入,绝对安全
参数传递 需手动拼接 URL 或 JSON 直接传业务参数(如 {"city": "上海"}
也可自然对话(上海今天哪些地方限行?
结果解析 LLM 需理解原始 JSON 结构 返回扁平化字段(如 aqi, quality
平台兼容性 需为每个平台单独开发插件 一次配置,多平台通用
能力组合 单个 API 独立调用,难以协同 可将多个 API 封装为一个 MCP 服务,实现统一调用与流程编排

如何在 Agent 平台中配置 MCP?

所有支持 MCP 协议的平台(如 Cherry Studio、Dify、Coze、百炼)均使用相同的 mcpServers 配置格式:

1. 获取您的专属 MCP 地址

a,访问接口文档如 天气查询 → 点击「MCP 服务」→ 复制服务地址。(单一工具存在一定局限性,非特殊情况不建议)

b,(强烈推荐)在控制台 - 数据管理 - MCP服务中,添加工具集合,随时可以把多个接口注册到同一个MCP服务中,方便AI自动发现和协同。

2. 填写 mcpServers 配置

    {
      "mcpServers": {
        "tianapi-tianqi": {
          "url": "https://mcp.tianapi.com/tianqi/index?key={your_apiKey}"
        }
      }
    }
  

3. 各平台配置位置参考

Dify

创建应用 → 工具 → “MCP 工具” → 粘贴上述 JSON

Coze / 扣子

Bot 设置 → 插件 → “自定义 MCP” → 输入配置

百炼

工作流 → 工具节点 → 选择 “MCP 服务” → 填入配置

部分 MCP 推荐

以下接口已全面支持 MCP 协议,覆盖生活、出行、健康、社交等高频场景:

🌤️ 实时天气(tianqi

查询全国城市未来7天天气、温度、湿度、风力、空气质量建议。

调用示例: {"city": "深圳"}

返回字段: city, temp, humidity, wind

📦 快递查询(kuaidi

自动识别快递公司,实时追踪物流轨迹(支持顺丰、中通、京东等)。

调用示例: {"number": "YT123456789CN"}

返回字段: com, status, list

🚗 车辆限行(vehiclelimit

获取北京、杭州、成都等城市今日/明日尾号限行规则及区域图。

调用示例: {"city": "成都"}

返回字段: date, limit_info, area

🔥 热搜榜单(networkhot

获取百度、微博、抖音实时热搜榜,含热度值与跳转链接。

调用示例: {"type": "weibo"}

返回字段: hot_listtitle, hot

全国油价(oilprice

返回92#、95#、98#汽油及0#柴油最新零售价(按省份)。

调用示例: {prov}

返回字段: province, p92, p95

🥗 菜品热量(imgcaipin

识别餐食图片中的菜品,返回热量(kcal)、蛋白质、脂肪等营养信息。

调用示例: {"imgurl": "http://me.jpg"}

返回字段: name, calorie, trust

更多支持MCP服务的接口,可在接口文档顶部查看是否标有支持MCP标签。

标准化 OpenAPI 3.0 文档

为需要更高自由度和控制权的开发者提供标准、规范的接口文档。基于 OpenAPI 3.0 标准生成,可一键导入 Apifox、Postman、Swagger UI 等主流调试工具,或无缝接入任何支持 OpenAPI 的 AI Agent 工作流。

1. 核心优势

  • 专业开发者首选:提供完整、标准的接口规范,方便深度定制与二次开发。
  • 无缝集成:一键导入主流调试工具,告别手动拼接参数的繁琐。
  • 实时同步:文档基于底层数据实时生成,确保与接口能力完全同步。

2. 如何获取?

a, 通过API市场,打开任意一个接口文档页(如 天气预报

b,在左侧“开发集成”模块下,点击“OpenAPI 文档”链接

c,获取专属 JSON 文档地址,例如:

https://www.tianapi.com/openapi/tianqi.json

️3. 主流调试工具导入参考

Apifox

项目设置 → 导入数据 → 选择 “OpenAPI/Swagger” → 粘贴 URL 或上传 JSON

Postman

File → Import → 选择 “Link” → 粘贴 OpenAPI 文档地址 → 确认导入

Swagger UI

在配置中修改 url 参数 → 指向 TianAPI OpenAPI JSON 地址 → 刷新页面

官方 Skill 入驻 ClawHub

天聚数行官方技能已全面入驻 ClawHub 生态!遵循 OpenClaw 标准,开发者无需手动封装 HTTP 请求或处理鉴权,即可在各类 AI 平台中开箱即用,让智能体轻松连接真实世界。

📦 快递物流查询

全球快递动态追踪,支持自动识别单号及物流公司,实时获取物流轨迹。

🚗 车架号 VIN 查询

精准解析 17 位车架号,秒出车辆核心参数、维保记录及配置信息。

🚦 城市车辆限行

实时掌握全国各城市尾号限行规则、限行区域及处罚标准。

🥗 菜品热量识别

AI 识别餐食图片,精准返回菜品名称、热量(kcal)及营养成分。

🗑️ 垃圾分类查询

根据物品名称快速查询垃圾分类信息,助力环保与智能问答。

🔥 全网热搜榜

聚合微博、抖音、百度等主流平台的实时热点,获取最新趋势。

更多官方 Skill 持续上架中,欢迎前往 ClawHub 体验或入驻

查看入驻详情与完整列表 前往 ClawHub 体验

常见问题(FAQ)

Q:MCP 是否收费?

A:MCP 本身免费,但所调用的接口按 TianAPI 标准计费(免费接口100次/天,计费接口都有测试额度)。

Q:能否在一个 mcpServers 中配置多个接口?

A:可以!如上文示例所示,一个 JSON 可包含数十个工具,平台会自动加载。

Q:图片类接口(如菜品热量)如何传图?

A:直接传图或将图片上传至公网可访问 URL(如 OSS、图床),再将imgurl 传入。

Q:配置MCP出现报错或查询失败为什么?

A:可能该接口暂未支持MCP服务;在接口管理中停用了接口;调用次数超限余额不足。

Q:OpenAPI 文档和 MCP 服务有什么区别?

A:MCP是面向 AI Agent 的“开箱即用”工具,自动处理鉴权和参数解析;OpenAPI是面向开发者的标准接口规范,适合需要深度定制、自行编写代码或导入 Postman/Apifox 调试的场景。

Q:OpenAPI 文档如何导入调试工具?

A:在接口文档页点击“OpenAPI 文档”获取 JSON 链接,然后在 Apifox/Postman 中选择“导入 -> URL”,粘贴链接即可自动生成调试环境。

Q:ClawHub Skill 和 MCP 服务是同一个东西吗?

A:底层能力相同,但运行环境不同。MCP 运行在你本地的 AI 客户端(如 Cherry Studio);ClawHub Skill 运行在 ClawHub 云端生态,支持跨平台调用和更复杂的编排。

Q:如何在我的 Agent 中使用 ClawHub Skill?

A:前往 ClawHub 技能市场,找到天聚数行官方技能,点击“安装”或复制配置代码,粘贴到你的 Agent 平台(如 Dify、Coze)即可。

Q:如何调试调用是否成功?

A:无论使用 MCP、OpenAPI 还是 Skill,均可在 TianAPI 控制台查看「API 调用日志」,包含请求参数、响应内容、状态码及耗时。

相关文章

工单 客服