知乎热榜 MCP 接入指南

概述

知乎热榜 MCP 通过 MCP over SSE 协议提供知乎热榜能力，适合接入支持 MCP 的 Agent、助手或工作流系统。

当前服务仅提供工具能力，不提供资源（resources）与提示词（prompts）能力。

接口信息

流程说明：

1. 客户端先连接 SSE 端点
2. 服务端通过 endpoint 事件返回实际可用的 message 地址（带 sessionId）
3. 后续 initialize、tools/list、tools/call 请求均发送到该 message 地址

鉴权

请求头：

Authorization: Bearer <your_access_secret>

建议在 SSE 连接和后续 message 请求中均携带同一份鉴权信息。

额度说明

热榜每日调用额度为 2 次（试用用户），实名认证后可提升至 1000 次。

• API Token 管理：https://developer.zhihu.com/profile
• 知乎数据开发平台文档中心：https://developer.zhihu.com/docs?key=authorization

工具定义

hot_list

入参：

返回：

工具调用结果为 text 类型内容，正文为面向大模型消费的结构化文本（XML 格式）。

返回示例：

<hot_list limit="30" total="3">
  <item rank="1">
    <title>如何看待当前 AI Agent 的发展趋势？</title>
    <url>https://www.zhihu.com/question/123456789</url>
    <thumbnail_url>https://pic1.zhimg.com/v2-xxx.jpg</thumbnail_url>
    <summary>这是该问题的内容摘要</summary>
  </item>
</hot_list>

thumbnail_url 和 summary 始终返回，无数据时为空。建议将整段 XML 原样交给模型消费，不建议自行裁剪字段。

接入流程

1. 建立 SSE 连接

curl -N 'https://developer.zhihu.com/api/mcp/hot_list/v1/sse' \
  -H 'Authorization: Bearer <your_access_secret>' \
  -H 'Accept: text/event-stream'

2. 初始化 MCP 会话

curl -X POST "$MESSAGE_URL" \
  -H 'Authorization: Bearer <your_access_secret>' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "clientInfo": {"name": "demo-client", "version": "1.0.0"},
      "capabilities": {}
    }
  }'

3. 调用热榜工具

curl -X POST "$MESSAGE_URL" \
  -H 'Authorization: Bearer <your_access_secret>' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "hot_list",
      "arguments": {"limit": 10}
    }
  }'

Claude Code 配置

在 ~/.claude/settings.json 的 mcpServers 中添加：

"hot-list": {
  "url": "https://developer.zhihu.com/api/mcp/hot_list/v1/sse",
  "headers": {
    "Authorization": "Bearer <your_access_secret>"
  }
}

配置完成后重启 Claude Code 即可使用。

注意事项

1. 该服务采用标准 MCP 工具调用模式，推荐直接使用现成 MCP Client 接入
2. tools/call 的结果通过已建立的 SSE 通道返回，而非直接同步返回在 POST 响应体中
3. 热榜结果偏实时性，列表顺序和内容会随时间变化

热榜数据（2026-05-19）