Zhihu

browse · download · search · publish · analyze — all from the command line.

zhihu-cli 将你的终端变成一个功能齐全的知乎客户端。只需认证一次，即可浏览、搜索、下载、发布和分析，全程无需打开浏览器。

⚠️ 这是知乎的非官方 CLI。使用风险自负。与知乎公司无关。

👉 在寻找 DSH 插件？→ dsh-plugin/

🚀 快速开始

要求： Python 3.10 或更高版本。安装前使用 python --version 检查版本。

# Install
pip install zhihu-toolkit

1. 认证

zhihu auth paste          # paste a cURL from browser DevTools
zhihu auth login          # scan a QR code with the Zhihu App
zhihu auth import         # import the session from a local browser (needs: pip install 'zhihu-toolkit[browser]')

2. 验证

zhihu auth status         # check login status and active profile

✨ 你可以做什么

📖 阅读与浏览

浏览知乎的动态、热榜、问题、文章、想法和评论，所有内容都会通过 Rich 驱动的分页器呈现在终端中。查看带摘要的实时热榜，滚动浏览为你个性化推荐的内容，或深入查看问题及其完整回答串，全程无需点击任何链接。知乎日报有独立的命令组：zhihu daily latest、zhihu daily before <date> 和 zhihu daily story <id> --save。

💾 下载以供离线使用

将任何知乎内容（文章、回答、问题、想法、视频）保存为带 YAML frontmatter 的简洁 Markdown。可下载单条内容，也可根据清单批量处理。所有内容都会按类型整理，保存到 ~/.zhihu-cli/downloads/，方便导入笔记系统或离线阅读。

🔍 搜索

在知乎上搜索问题、文章、用户和话题。可从命令行调整结果深度和数量。

✍️ 发布与编辑

使用 Markdown 撰写回答和文章，然后通过一条命令发布到知乎。需要更新时，可从本地文件修改已有回答和文章。Markdown 到 HTML 的转换会通过知乎自己的渲染流程自动完成。

💬 互动

投票、致谢、关注、拉黑和评论，无需浏览器即可进行完整的社交互动。管理收藏夹：创建、添加内容并整理。发送和接收私信，还可通过 MQTT 实时接收通知和聊天消息。

🕸️ 抓取与导出

将你发布的内容、活动历史、回答和文章批量导出为结构化 JSON。使用通用转换器跨格式合并并规范化数据，以用于自己的数据流水线。

📊 分析

创作者数据分析——获取知乎收入数据并进行可视化：月度摘要、趋势图（含 EMA）、高级指标（布林带、MACD）、导数分析（速度／加速度／加加速度）、星期几统计，以及按内容细分的每日指标。图表会保存为 PNG 文件。

NLP 工具——对下载的内容进行词频分析、生成词云和 K-means 聚类。所有工具均可处理完整的 Markdown 内容库。

🔐 多账号

保存不同账号的多个配置，并通过一条命令在配置间切换。每个配置都有独立的认证凭据和 Cookie。

🏗️ 架构

src/zhihu_cli/
├── main.py                  # Click CLI — command group hub
├── output.py                # styled terminal output (Rich)
├── content/
│   ├── handlers/            # one file per Zhihu domain
│   └── utils/               # HTML↔Markdown, ZSE v4 signing
├── creator_tools/           # income analytics + plotting
├── nlp_tools/               # word count, wordcloud, clustering
└── extensions/              # plugin system (auto-discovered)

🧪 额外功能

可选依赖项

pip install -e ".[nlp]"          # jieba, matplotlib, wordcloud, scikit-learn...
pip install -e ".[creator]"      # matplotlib, numpy, pandas, seaborn...
pip install -e ".[classifier]"   # torch, transformers, scikit-learn...
pip install -e ".[llm]"          # openai (zhihu agora ai, zhihu chat bot, crank)
pip install -e ".[notify]"       # desktop-notifier (zhihu chat interactive --notify)
pip install -e ".[mcp]"          # mcp (the zhihu-mcp server entry point)

Shell 补全

eval "$(python autocomp.py)"

🤝 参与贡献

欢迎提交 PR！代码库的结构便于扩展：

• 新增命令？ 在 commands/ 中添加一个文件，其中包含 register_<name>(group) 函数，并在 main.py 中导入。
• 新增处理器？ 在 content/handlers/ 中添加一个文件，并遵循现有模式。
• 新增扩展？ 创建 extensions/<name>/，并添加一个公开 register_cli(group) 的 __init__.py。

提交前请运行格式化工具：

pre-commit run --all-files
ruff check .
ruff format .

📜 许可证

MIT