# Zhihu Search

> 知乎开放平台搜索能力集成——在 Agent 需要搜索知乎内容、全网信息、直答或查看热榜时使用。包含每日额度管理与智能源选择策略。

- Skill: `klarkxy/zhihu-search` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add klarkxy/zhihu-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/klarkxy/zhihu-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: klarkxy (https://skillmd.com/u/klarkxy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/klarkxy/zhihu-search

---


# 知乎搜索插件使用指南

本插件封装了知乎开放平台的四个核心 API：知乎搜索、全网搜索、知乎直答、热榜。插件自动追踪每日免费额度（1000 次/天，共享于 zhihu_search + global_search），并根据问题特征智能选择搜索源。

## 第一步：配置密钥

在首次使用任何搜索工具之前，必须先配置 Access Secret：

1. 引导用户前往 https://developer.zhihu.com/profile 获取 Access Secret
2. 调用 `set_zhihu_api_key` 工具，传入 `accessSecret` 参数
3. 工具会自动验证密钥有效性

密钥会在插件的数据目录中持久保存，后续无需重复配置。

## 工具列表与选择策略

| 工具 | 用途 | 额度 | 适合场景 |
|------|------|------|----------|
| `zhihu_search` | 知乎站内搜索 | 共享每日 1000 次 | 常规知乎内容搜索 |
| `global_search` | 全网搜索（含知乎内容） | 共享每日 1000 次 | 需要站外信息、最新资讯 |
| `zhida` | 知乎直答（深度问答） | **独立额度** | 复杂、分析性问题 |
| `hot_list` | 知乎实时热榜 | 不计入限制 | **仅用户主动要求时使用** |
| `query_zhihu_quota` | 查询额度使用 | — | 查询今日剩余次数 |

### 智能选择逻辑

当用户提出搜索类请求时，按以下优先级判断：

1. **先查额度** —— 如果今日免费额度（zhihu_search + global_search）还有剩余
   - 普通问题 → `zhihu_search`（知乎站内搜索）
   - 需要最新/全网信息 → `global_search`（全网搜索）
2. **额度用尽时** → 自动转用 `zhida`（知乎直答），它使用独立额度
3. **复杂问题** —— 无论额度是否充足，如果问题属于以下特征，直接用 `zhida`：
   - 问题长度超过 80 字
   - 包含多个问号或分句
   - 包含分析类关键词：为什么、如何、原理、机制、分析、比较、区别、优缺点、影响、关系、论证、解释、趋势等
4. **热榜** —— `hot_list` **仅当用户主动要求查看热榜时才调用**，不得主动推送或定时抓取热榜内容
5. **额度查询** —— 当用户询问「还有多少额度」「每天能搜多少次」时，用 `query_zhihu_quota`

### 综合示例

用户问：「量子计算的原理是什么？」→ 这是复杂问题 → 调用 `zhida`

用户问：「最近有什么热门新闻？」→ 这是搜索需求 → 检查额度：
- 有额度 → `global_search`（全网搜索）
- 额度用尽 → `zhida`

用户问：「知乎热榜今天有什么？」→ 用户主动要求热榜 → 调用 `hot_list`

用户问：「今天还能搜多少次？」→ 调用 `query_zhihu_quota`

## 注意事项

- 所有搜索工具都依赖 Access Secret，未配置时会返回明确提示
- API 调用携带 Bearer Token 和秒级 Unix 时间戳，插件自动处理
- 额度数据每日自动重置（北京时间）
- `zhida` 不计入免费额度，但可能有独立计费规则
- `hot_list` 仅在用户主动要求时调用——不要在工具调用中自行触发热榜
- 如果用户未提供密钥，不要尝试用空密钥调用 API，先请用户提供