天聚数行（TianAPI）API 接口对接

国内综合性 API 接口平台，提供 234 个接口，涵盖新闻、天气、生活工具、AI 智能等。

使用前提

• 注册 tianapi.com 账号
• 控制台获取 API Key（已配置于 call_tianapi 函数中）
• 免费接口需先点击"申请接口"

API 信息

通用调用方式

import requests

TIANAPI_KEY = "b32728bac74d956d8e33015188a2c5a2"

def call_tianapi(api_name: str, params: dict = None) -> dict:
    """调用天行数据 API 的通用函数"""
    url = f"https://apis.juhe.cn/fapigx/{api_name}/query"
    if params is None:
        params = {}
    params["key"] = TIANAPI_KEY
    params["dtype"] = "json"
    response = requests.get(url, params=params, timeout=10)
    return response.json()

返回结构

{
    "code": 200,        // 200=成功，其他为错误码
    "msg": "success",
    "result": { ... }
}

已申请免费接口（快捷调用）

以下接口每日 100 次免费额度，调用时注意 1 次/秒 频率限制。

使用示例

1. 查询天气

result = call_tianapi("tianqi", {"city": "101020100", "type": "1"})

2. 查询热搜榜

result = call_tianapi("networkhot", {"num": "10"})

3. 智能翻译

result = call_tianapi("translate", {"text": "Hello World", "to": "zh"})

4. IP 归属地查询

result = call_tianapi("ipquery", {"ip": "8.8.8.8"})

5. 天行机器人对话

result = call_tianapi("robot", {"question": "今天天气怎么样", "userid": "user001"})

接口分类索引

按以下分类组织（详细接口列表可访问官网 API 文档 查看）：

MCP 协议接入

天行数据已适配 MCP（Model Context Protocol），可在 Cherry Studio、GitHub Copilot 等 AI 客户端中直接使用。

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

错误码速查

完整错误码列表可访问官网 错误码说明 查看。

注意事项

1. 频率限制：默认 1 次/秒，超出返回错误码 130
2. 编码格式：全站 UTF-8，中文参数建议 urlencode 编码
3. 免费接口：标注 * 的接口会员免费，申请即送 1000 次
4. 计费接口：使用天豆（1 天豆 ≈ 0.02 元），10 元 = 50000 次
5. 数据缓存：部分新闻类接口有缓存延迟（10-30 分钟）
6. MCP 安全：MCP 为代理模式调用，请严格保管密钥
7. 控制台：https://www.tianapi.com/console/ 管理接口和查看调用统计

相关链接

• 官网：https://www.tianapi.com/
• 控制台：https://www.tianapi.com/console/
• 接口文档：https://www.tianapi.com/openapilist.html
• MCP 服务：https://www.tianapi.com/mcp/