技能介绍

这个技能解决什么问题

很多数据项目需要知乎的结构化内容：按关键词检索站内问答与文章、跨站做舆情观察、或者拿热榜做选题监控。手工抓取面临反爬、页面结构变动和渲染成本；而直接对接官方开放平台的 REST API，可以获得稳定的字段和明确的限流口径。这个技能把知乎开放平台的四个接口封装成统一调用面，让工程师能把知乎数据塞进现有的采集、分析或 Agent 流程，不必自己处理鉴权细节与参数校验。

技能如何工作

技能的核心是四组 REST 端点，全部走知乎开放平台：

知乎搜索 GET https://developer.zhihu.com/api/v1/content/zhihu_search：站内检索，返回问题、回答、文章。Query 必填，Count 默认 10、上限 10。
全网搜索 GET https://developer.zhihu.com/api/v1/content/global_search：跨站点检索，Count 默认 10、上限 20，支持 Filter 表达式按域名、发布时间过滤，SearchDB 可选 all/realtime/static。
知乎直答 POST https://developer.zhihu.com/v1/chat/completions：AI 对话，OpenAI SDK 兼容，模型有 zhida-fast-1p5、zhida-thinking-1p5、zhida-agent。
知乎热榜 GET https://developer.zhihu.com/api/v1/content/hot_list：Limit 默认 30、上限 30。

鉴权统一使用 Bearer：请求头携带 Authorization: Bearer <Access Secret>、X-Request-Timestamp（秒级 Unix 时间戳）与 Content-Type: application/json。Access Secret 在知乎开放平台个人中心获取。响应为结构化 JSON，搜索结果含标题、ContentType、ContentID、赞同数、评论数、作者信息、权威等级、精选评论等字段；热榜返回标题、链接、缩略图与摘要。思考模型还会在 reasoning_content 中返回推理过程。

适用边界与注意点

zhida-agent 只支持单轮 messages（仅 user），需要多轮上下文请改用 zhida-fast-1p5 或 zhida-thinking-1p5。
全网搜索的 host 过滤不支持 zhihu.com 及其子域名，站内内容必须走 zhihu_search。
Access Secret 是敏感凭据，用环境变量或配置管理，不要硬编码在公开代码里。
频率受限时返回 30001，参数错误 10001，鉴权失败 20001，内部错误 90001；做重试时要区分这几类。
单次返回数量有硬上限：站内搜索 10 条、全网搜索 20 条、热榜 30 条，需要更多数据得自己分页或多次调用。