通过 MCP 在 AI 客户端（Cherry Studio/ChatBox）中直接调用网络搜索热词排行

# 通过 MCP 在 AI 客户端（Cherry Studio/ChatBox）中直接调用网络搜索热词排行 > 接口：网络搜索热词排行（apiCode=313，含 313-1/313-2 全部接入点） · 免费服务 · 集成方式 MCP · 适用人群：AI 开发者、AI 产品运营 · 阅读时间：约 6 分钟 ## 核心要点 - 官方提供 MCP 服务，覆盖本接口全部接入点；配置一段 JSON 即可让支持 MCP 的 AI 客户端直接查热搜。 - 配置只需把 `{your_appKey}` 换成你的真实 AppKey。 - 适合给 AI 助手加上"实时热搜感知"能力，无需自己写调用代码。 ## Why：为什么用 MCP 而不是直接调接口 如果你在用 Cherry Studio、ChatBox 这类支持 MCP 的客户端，配好 MCP 后，AI 自己就能在对话里调用热搜接口——你问"今天游戏圈在热什么"，它直接拉榜回答。比在代码里硬编码调用更省事，也方便非开发同学用。 ## What：MCP 服务信息 | 项目 | 说明 | |------|------| | 服务名 | `showapi-mcp-313` | | 地址 | `http://www.showapi.com.cn/mcp/313/{your_appKey}` | | 覆盖范围 | 本接口全部接入点（313-1 分类查询、313-2 热搜排行） | | 前置 | 有效 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)） | ## How：在客户端里配置 ### 步骤 1 · 准备配置 JSON 把下方 `{your_appKey}` 替换为你的真实 AppKey： ```json { "mcpServers": { "showapi-mcp-313": { "url": "http://www.showapi.com.cn/mcp/313/{your_appKey}" } } } ``` ### 步骤 2 · 在客户端添加 - **Cherry Studio**：设置 → MCP 服务器 → 添加服务器 → 选"远程/URL 类型" → 粘贴上面的 JSON（或填 URL 与名称）→ 保存并启用。 - **ChatBox**：插件/MCP 设置 → 新增 MCP → 填入名称 `showapi-mcp-313` 与上面的 URL → 启用。 ### 步骤 3 · 对话验证 在对话框问："用 showapi-mcp-313 查一下游戏分类的热搜榜前 5 名。" 客户端会调用接口并返回结构化结果。 ## 返回示例与解析 MCP 返回的内容即接口原始 JSON（结构见[返回字段全解篇](https://www.showapi.com/guides/hotword-response-fields-313)），AI 会把它整理成自然语言念给你听。 ## 进阶 / 边界 - **AppKey 保管**：MCP URL 里直接带 AppKey，仅建议在本地自用客户端配置，不要分享该配置给他人。 - **覆盖全部接入点**：同一个 MCP 服务即可查分类（313-1）与热搜（313-2），无需分别配置。 - **兼容性**：以客户端实际支持的 MCP 传输为准；如客户端要求 HTTPS，请以其最新文档为准（官方给出的是 `http` 地址）。 ## FAQ **Q1：MCP 和直接写代码调用有区别吗？** A1：能力相同（都覆盖 313 全部接入点），MCP 让你不用写代码就能在 AI 对话里用，更适合非工程场景。 **Q2：AppKey 写在 URL 里安全吗？** A2：仅限本地自用客户端；不要外发含 AppKey 的配置。需要共享给他人时，让对方填自己的 AppKey。 **Q3：能同时配多个 ShowAPI 接口的 MCP 吗？** A3：可以，每个接口一个 `mcpServers` 条目，分别配各自 URL 即可。 **Q4：接口免费，MCP 也免费吗？** A4：MCP 只是调用通道，费用以接口本身为准（本接口免费）。 **Q5：调用失败怎么排查？** A5：先确认 AppKey 有效、URL 完整；再看客户端 MCP 日志里的返回（按 `ret_code` 非 0 即失败处理）。 ## 相关能力 / 下一步阅读 - [5 分钟接入网络搜索热词排行：从注册到拿到第一条热搜榜](https://www.showapi.com/guides/hotword-quickstart-313) - [导入 Postman / Swagger：用 OpenAPI 文档管理网络搜索热词排行接口](https://www.showapi.com/guides/hotword-openapi-313) - [网络搜索热词排行返回字段全解：name/num/level/trend 一文读懂](https://www.showapi.com/guides/hotword-response-fields-313) - **本系列共 12 篇**：查看[网络搜索热词排行开发指南总目录](https://www.showapi.com/guides/hotword-guides-313)