按关键词搜索知乎用户；已有用户主页链接时直接调用用户资料接口。支持 page_token 翻页。
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 用户搜索关键词或短语，例如账号名；不要传主页链接、用户 ID 或 page_token。 | |
| page_token | No | 首页留空；后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨能力使用。 |
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 当前页用户搜索结果。 | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| next_page_token | Yes | 下一页不透明分页令牌；为空表示结束。必须原样传回同一用户搜索入口，不可跨关键词或能力使用。 |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
注解已声明readOnlyHint=true和openWorldHint=true，描述没有与之矛盾。描述额外说明了page_token翻页这一行为特性，但对返回格式、分页细节等未提及。由于有输出schema，这些信息可从中获取，描述补充了翻页机制，比基线略好。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
描述仅两句话，第一句点明核心功能，第二句给出使用条件，第三句说明翻页。信息密度高，没有冗余，且关键信息前置。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
对于搜索类工具，有输出schema描述返回结构，注解覆盖只读属性，描述提供了足够的场景区分和翻页指导。代理可以准确判断何时使用此工具以及如何正确调用，没有遗漏关键信息。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
schema对两个参数的描述已非常详细（keyword禁止传链接/ID，page_token说明首页留空和跨能力不可用），覆盖率达100%。描述本身没有增加超出schema的语义，但强调了'已有主页链接时'的用法，这属于使用指导而非参数语义。因此维持基线3分。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
描述明确说明工具用途是'按关键词搜索知乎用户'，动词+资源清晰，且与兄弟工具区分（zhihu_search_content用于内容搜索，zhihu_get_user_info_by_profile_url用于获取用户资料）。还特别指出已有主页链接时用其他接口，进一步明确了边界。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
描述直接给出使用条件：已有用户主页链接时应调用用户资料接口，隐含了本工具适用于无链接时按关键词搜索。同时提到支持page_token翻页，让代理知道如何处理分页。虽然没有列出所有兄弟工具，但关键替代方案已明确。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.