知乎热榜监控助手

它解决什么问题

知乎热榜、话题动态和公开问答散落在网页各处，手工刷新效率低，而且接口字段、鉴权流程和权限白名单都在变化。知乎热榜监控助手 把这套只读采集流程整理成可复用的操作骨架，让 Agent 在拿到有效凭证后，能用统一方式拉取热榜、订阅话题更新、读取公开回答。

它不替用户调用真实接口，而是负责在任务开始前把方法、接口路径和排错路径说清楚，减少“看到报错但不知道去哪里查”的情况。

核心能力

• 热榜读取：定位 https://api.zhihu.com/ 下的 /v4/hot_list（或 https://www.zhihu.com/api/v3/feed/topstory/hot-lists）只读热榜接口。
• 话题与动态：围绕 /v4/topics/{id} 读取话题信息和公开动态。
• 问答采集：在有权限的前提下，读取公开问题和回答，用于整理摘要或趋势观察。
• 凭证与排错：基于知乎开放平台 OAuth2，说明 client_id、client_secret 与 access_token 的用途，并对 token 过期、无权限、白名单未通过 等失败给出定位方向。

工作方式

1. 明确采集目标：热榜、话题动态，还是某个公开问题的讨论。
2. 检查本地是否已有 client_id、client_secret 和可用 access_token；缺失时引导查看 USAGE.md 完成授权。
3. 调用对应只读接口，并把返回内容整理为结构化结果。
4. 请求失败时返回错误码与排查提示，而不是静默重试。

边界与注意点

• 严格只读：知乎开放平台不支持写操作，技能不会发布、回复或修改内容，也不会绕过限制。
• 只处理公开数据：不抓取非公开或隐私内容。
• 注意频控：批量调用要控制频率，避免触发风控。
• 凭证本地保存：client_secret 与 token 只保存在本地，不回传、不打印。
• 接口路径和参数以知乎开放平台官方文档最新版为准。