天聚数行 TianAPI

解决接口对接的碎片化痛点

国内开发者调用新闻、天气、AI等不同类型API时，常需对接多个平台，面临文档分散、认证方式不一、限流规则复杂的问题。手动拼接请求参数、处理不同返回结构、维护密钥管理，不仅耗时，还容易出现调用频率超限、权限失效等隐性错误。TianAPI技能聚焦这一痛点，提供统一的接口封装与调用范式。

技能的核心工作方式

技能通过call_tianapi函数封装所有接口调用，开发者只需传入接口路径名与参数即可。以已申请的免费接口为例，查询国内新闻可简化为call_tianapi("guonei", {"num": 10})，返回统一UTF-8编码的JSON结构，省去手动构造URL、处理认证参数的步骤。接口按分类索引，涵盖新闻资讯、热搜榜单、生活服务等12大类，每个接口对应明确的路径名与参数规范，例如networkhot接口可直接聚合微博、抖音等平台的热搜数据。

对于特殊接口，技能内置默认配置：基础域名自动拼接https://apis.juhe.cn/fapigx/{api_name}/query，支持GET/POST请求，密钥已预配置在函数中，无需每次调用手动传递。此外，技能适配MCP协议，可在Cherry Studio等AI客户端中直接调用，无需额外编写胶水代码。

适用边界与注意事项

• 限流与计费规则：免费接口每日100次调用，默认1次/秒频率限制，超出返回错误码130；付费接口按天豆计费（1天豆≈0.02元），需在控制台充值后使用。
• 接口时效性：部分接口如微信文章精选已停更，仅支持查询历史数据；新闻类接口存在10-30分钟缓存延迟，不适合实时性要求高的场景。
• 密钥管理：MCP协议为代理模式调用，需严格保管API Key，避免泄露导致额度消耗或账号风险。
• 参数编码：中文参数需手动进行URL编码，避免请求失败；返回数据为UTF-8编码，解析时需注意编码格式匹配。