Zhihu Helper
/install zhihu-helper
知乎内容辅助工具 (Zhihu Helper v2.0)
辅助查看知乎内容,提取数据,Cookie 加密存储,稳定可靠。
触发词(Trigger Phrases)
- "帮我发一篇知乎文章" / "写知乎文章"
- "发布知乎想法" / "发一条想法"
- "回答知乎问题" / "写回答"
- "知乎提问" / "问一个问题"
- "点赞" / "评论" / "关注"(知乎内容)
- "查看知乎热榜" / "知乎热搜"
- "搜索知乎" / "查一下知乎上的"
- "知乎数据" / "提取知乎信息"
快速开始
1. 安装依赖
# 依赖已安装,如首次使用:
cd zhihu-skill
npm install
npx playwright install chromium
2. 配置 Cookie 加密密钥
export ZHIHU_COOKIE_KEY="$(openssl rand -hex 32)"
3. 导出知乎 Cookie
# 会自动打开浏览器,手动登录后 Cookie 自动加密保存
node scripts/zhihu-export-cookie.js
4. 验证
# 检查 Cookie 是否有效
node tests/cookie-check.js
功能模块
1️⃣ 发布文章
在知乎专栏发布 Markdown 文章。
你: 帮我发一篇知乎文章,标题是"xxx",内容是...
AI: 正在生成内容 → 展示预览 → 等待用户确认 → 发布 → 返回链接
⚠️ 重要:所有发布操作前 AI 必须展示预览并等待用户明确确认("确认发布?"),未经确认不得执行任何公开操作。
CLI:
# 直接指定内容
node scripts/zhihu-publish.js article --title "标题" --content "正文"
# 从文件读取内容
node scripts/zhihu-publish.js article --title "标题" --content-file "文章.md"
# 保存为草稿(不发布)
node scripts/zhihu-publish.js article --title "标题" --content "正文" --draft
2️⃣ 发布想法
类似 Twitter 的短内容发布。
你: 发一条知乎想法,内容是xxx
CLI:
node scripts/zhihu-publish.js thought --content "想法内容"
# 带图片
node scripts/zhihu-publish.js thought --content "想法内容" --image "图片路径"
3️⃣ 回答问题
搜索问题并撰写回答。
你: 帮我在知乎搜索关于xxx的问题并回答
AI: 搜索问题 → 列出选项 → 用户选择 → 撰写 → 展示预览 → 等待确认 → 提交
CLI:
node scripts/zhihu-answer.js --question-id 123456789 --content "回答内容"
4️⃣ 提问
在知乎上提出新问题。
你: 帮我在知乎提问:xxx
AI: 展示预览 → 等待确认 → 提交
CLI:
node scripts/zhihu-ask.js --title "问题标题" --detail "补充说明"
5️⃣ 互动
点赞、评论、关注(执行前需用户确认)。
你: 给这篇知乎文章点赞 / 评论 / 关注这个用户
AI: 展示操作详情 → 等待确认 → 执行
⚠️ 所有互动操作(点赞/评论/关注)前必须等待用户明确确认。
CLI:
# 点赞
node scripts/zhihu-interact.js like --url "https://www.zhihu.com/question/xxx/answer/xxx"
# 取消点赞
node scripts/zhihu-interact.js unlike --url "..."
# 评论
node scripts/zhihu-interact.js comment --url "..." --content "评论内容"
# 关注用户
node scripts/zhihu-interact.js follow --user "用户ID"
6️⃣ 数据提取
从知乎提取结构化数据。
你: 今天知乎热榜是什么?
AI: 返回热榜 Top 20
CLI:
# 热榜
node scripts/zhihu-extract.js --type hot-list [--limit 20]
# 搜索
node scripts/zhihu-extract.js --type search --query "关键词" [--limit 10]
# 文章详情
node scripts/zhihu-extract.js --type article --id "文章ID"
# 用户信息
node scripts/zhihu-extract.js --type user --id "用户ID"
# 问题详情
node scripts/zhihu-extract.js --type question --id "问题ID"
# 回答列表
node scripts/zhihu-extract.js --type answers --id "问题ID" [--limit 10]
架构
AI Agent(用户自然语言触发)
│
┌────────▼────────┐
│ Skill 调度层 │
│ SKILL.md → 路由 │
└────────┬────────┘
│
┌────────────┼────────────┐
│ │
┌─────────▼─────────┐ ┌─────▼─────────┐
│ 浏览器操作通道 │ │ Python/OpenAPI │
│ zhihu-browser.js │ │ zhihu_bot.py │
│ zhihu-publish.js │ │ zhihu-bridge │
│ zhihu-interact.js│ └───────────────┘
│ zhihu-answer.js │
│ zhihu-extract.js │
└───────────────────┘
注:所有操作统一通过浏览器实现,Cookie 加密存储,稳定可靠。
安全
- Cookie 使用 AES-256-GCM 加密存储(权限 0600)
- 环境变量
ZHIHU_COOKIE_KEY管理加密密钥 - 支持密钥轮换(
rotateCookieKey)
Cookie 加密格式
~/.hermes/credentials/zhihu-cookies.enc
├── [12 bytes: 随机 IV]
├── [16 bytes: GCM 认证标签]
└── [AES-256-GCM 加密的 Cookie 数据]
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
ZHIHU_COOKIE_KEY |
✅ | Cookie 加密密钥(openssl rand -hex 32 生成) |
ZHIHU_APP_KEY |
❌ | 知乎 OpenAPI app_key(圈子互动) |
ZHIHU_APP_SECRET |
❌ | 知乎 OpenAPI app_secret |
测试
# 选择器冒烟测试
node tests/smoke-test.js
# Cookie 到期检测
node tests/cookie-check.js
# 端到端集成测试(沙箱模式)
ZHIHU_TEST_MODE=sandbox node tests/e2e-test.js
注意事项
- ⚠️ 频率控制:HTTP 200-500ms 间隔,浏览器 5-10s 间隔
- ⚠️ Cookie 有效期:约 30 天,到期需重新登录导出
- ⚠️ 知乎改版:
config/selectors.json可能需更新 - ⚠️ 签名失效自动降级:C3b 失败自动切换 Plan B(浏览器通道)
- ⚠️ 浏览器崩溃恢复:withCrashRecovery 自动重建会话
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zhihu-helper - After installation, invoke the skill by name or use
/zhihu-helper - Provide required inputs per the skill's parameter spec and get structured output
What is Zhihu Helper?
知乎内容辅助工具。支持查看文章、搜索问题、提取热榜/用户数据。 提供浏览器操作辅助,Cookie 加密存储。 It is an AI Agent Skill for Claude Code / OpenClaw, with 27 downloads so far.
How do I install Zhihu Helper?
Run "/install zhihu-helper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Zhihu Helper free?
Yes, Zhihu Helper is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Zhihu Helper support?
Zhihu Helper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Zhihu Helper?
It is built and maintained by liuboacean (@liuboacean); the current version is v2.0.7.