zhihu-cli 使用指南:终端里的知乎客户端
zhihu-cli 使用指南:终端里的知乎客户端
知乎是中文互联网最大的问答社区,但日常浏览往往要打开浏览器或 App。如果你习惯泡在终端里(比如我是 Vim + tmux 重度用户),或者你正在写 AI Agent 想集成知乎能力,那么 zhihu-cli 这类命令行工具就能帮你把知乎搬进终端:搜索问题、看热榜、读回答、甚至发布文章和想法,全程不离开键盘。
本文基于 GitHub 上最活跃的同名项目 BAIGUANGMEI/zhihu-cli(PyPI 包名 pyzhihu-cli)编写,覆盖安装、登录、常用命令与实战示例。
zhihu-cli 是什么
zhihu-cli 是一个用 Python 编写的知乎命令行客户端,通过知乎 V4 API 获取数据,用 Rich 库在终端渲染成漂亮的表格输出。它把知乎的主要功能搬进了终端:
- 搜索:按关键词搜索问题、回答、文章,支持按类型(话题、用户)过滤
- 浏览:热榜、问题详情、回答详情及评论、首页推荐、话题
- 用户:查看用户资料、回答列表、文章列表、粉丝与关注
- 互动:赞同/取消赞同回答,关注/取消关注问题
- 创作:发布提问、发布想法、发布图文文章(支持 HTML 富文本)
- 管理:查看收藏夹、通知,删除自己发布的内容
项目信息
动手之前先看下项目基本面:
| 项目 | 详情 |
|---|---|
| GitHub 仓库 | BAIGUANGMEI/zhihu-cli |
| PyPI 包名 | pyzhihu-cli |
| 开发语言 | Python 3.10+(Click + Requests + Rich) |
| 许可证 | Apache-2.0 |
| Star / Fork | 65 / 17 |
| 安装方式 | uv / pipx / 源码 |
| 登录方式 | 二维码扫码 或 手动粘贴 Cookie |
注意:GitHub 上存在多个同名"zhihu-cli"项目(如基于知乎开放平台的 Node.js 版本、仿 curl 的 Rust 版本 zhurl 等)。本文介绍的
pyzhihu-cli功能最全、持续维护,且不需要申请开放平台密钥,开箱即用。
安装
需要 Python 3.10 及以上版本,推荐使用 uv 或 pipx 安装(自动隔离依赖):
|
|
验证安装:
|
|
安装成功后 zhihu 命令即可使用。依赖只有 requests、rich、click、qrcode,二维码登录无需 Playwright。
登录与认证
zhihu-cli 支持两种登录方式,登录态保存在 ~/.zhihu-cli/cookies.json(文件权限 0600,仅当前用户可读)。
方式一:二维码扫码(推荐)
|
|
扫码过程中二维码也会保存为 ~/.zhihu-cli/login_qrcode.png,方便你在手机上用知乎 App 扫码,或者由 AI Agent 读取后发送给用户。
方式二:手动粘贴 Cookie
|
|
Cookie 可以从浏览器开发者工具中复制,注意该方式不会自动获取浏览器 Cookie。
登录状态管理
|
|
常用命令与示例
搜索内容
|
|
浏览热榜
|
|
查看问题与回答
|
|
用户相关
用户查询使用 URL Token,即知乎个人主页路径中的部分,比如 zhihu.com/people/zhang-san 中的 zhang-san:
|
|
推荐流与话题
|
|
互动:赞同与关注
|
|
创作:发布提问、想法、文章
发布内容时,描述与正文都支持 HTML 富文本(如 <p>、<strong>、<a>):
|
|
删除自己发布的内容
|
|
其他实用命令
|
|
实战:一条命令看今日热榜
下面用一个完整示例演示 zhihu-cli 的实际效果。假设我们要看看今天知乎上大家在讨论什么:
|
|
配合 jq 可以做更多自动化:
|
|
工作原理
zhihu-cli 的架构很清晰,三层分工:
|
|
|
|
执行流程大致为:
- 认证:通过二维码扫码或手动 Cookie 完成登录,登录态保存到
~/.zhihu-cli/cookies.json - 校验:通过
/api/v4/me接口验证会话有效性 - 取数:用 requests 请求知乎 V4 API,获取结构化 JSON
- 展示:用 Rich 渲染成表格、带颜色的终端输出
值得留意的是它的反爬与风控设计:全局统一 Chrome 浏览器指纹(User-Agent、sec-ch-ua、sec-ch-ua-platform 版本号一致,集中管理在 config.CHROME_VERSION),登录与写操作带 CSRF token(_xsrf / x-xsrftoken),能有效降低被风控拦截的概率。
网络安全设计
项目在 README 中专门说明了安全设计,使用前值得了解:
- 凭证仅存本地:Cookie 只写入本机
~/.zhihu-cli/cookies.json,权限 0600,不会上传给任何第三方 - 全程 HTTPS:所有请求只发往知乎官方域名(
www.zhihu.com、api.zhihu.com) - 无密码落地:仅支持二维码扫码或 Cookie 登录,不收集、不存储账号密码
- 最小权限:只请求完成当前命令所需的 API,不额外拉取数据
- 可审计:项目开源,依赖在
pyproject.toml声明,无闭源运行时
建议只在可信环境使用,妥善保管本地 Cookie 文件,退出后可用
zhihu logout清除登录态。
常见问题 FAQ
Q: 登录后报"请先登录"?
A: 检查 zhihu status 是否显示已登录。手动粘贴的 Cookie 里必须包含 z_c0、_xsrf、d_c0 三个字段,缺一不可,注意 Cookie 过期后需要重新登录。
Q: 发布的文字可以格式化吗?
A: 可以。提问描述、想法正文、文章内容都支持 HTML 富文本,比如 <strong>加粗</strong>、<a href="...">链接</a>。
Q: 如何彻底退出登录并清除数据?
A: zhihu logout 会清除本地保存的登录态,同时可手动删除 ~/.zhihu-cli/cookies.json 文件。
Q: 能发布回答和评论吗? A: 目前还不能,官方路线图里"发布回答、发布评论、发布视频"还在后续开发中。
Q: 浏览器指纹版本号怎么更新?
A: 所有指纹版本号集中管理在 config.py 的 CHROME_VERSION 常量,当知乎风控收紧时更新这一处即可全局生效。
总结
zhihu-cli 把知乎的核心浏览与创作能力带进了终端,安装一条命令、登录扫码一次即可使用。对程序员来说,最实用的组合是 zhihu search + zhihu hot --json + jq:随时在终端查资料、抓热榜做数据分析;对 AI Agent 来说,它提供了一套纯 API 的知乎访问通道,配合 JSON 输出可以轻松集成到工作流里。
感兴趣的读者可以进一步关注:
- 项目主页:https://github.com/BAIGUANGMEI/zhihu-cli
- PyPI 页面:https://pypi.org/project/pyzhihu-cli/
- 知乎开放平台(官方 API,供学习参考):https://developer.zhihu.com
