zhihu-creator-cli

name	zhihu-creator-cli
description	知乎创作助手 CLI 工具技能。当用户提到知乎、zhihu、知乎创作、知乎文章、知乎问题、知乎搜索、zhihu-creator 时触发。提供创作中心、问题推荐/搜索、用户资料、热榜、专栏、话题、收藏夹、想法、通知等只读功能，支持 Cookie 登录和 --json 输出供 Agent 程序消费。

Zhihu Creator CLI

知乎创作助手 CLI — 专为内容创作者和 AI Agent 设计的只读命令行工具。

所有命令支持 --json 输出原始 JSON，供程序直接消费。

安装与认证

pip install -e .

# Cookie 登录（必需 z_c0, _xsrf, d_c0）
zhihu-creator auth login --cookie "z_c0=xxx; _xsrf=yyy; d_c0=zzz"
zhihu-creator auth status

Cookie 获取：浏览器 F12 → Application → Cookies → 复制 z_c0, _xsrf, d_c0。

命令组

auth — 认证

命令	说明
auth login --cookie	Cookie 登录
auth logout	退出登录
auth status [--json]	登录状态
auth whoami [--json]	当前用户信息

articles — 创作中心文章

命令	说明
articles list [--limit] [--status] [--sort] [--json]	文章列表
articles detail <id> [--json]	文章详情

questions — 问题发现

命令	说明
questions recommend [--limit] [--topic] [--json]	推荐问题
questions search <keyword> [--limit] [--json]	搜索问题（兼容旧命令）
questions detail <id> [--json]	问题详情（fallback 策略）
questions answers <id> [--limit] [--sort] [--json]	问题回答列表
questions invites [--limit] [--answered] [--json]	邀请回答通知（兼容旧命令）

answers — 回答

命令	说明
answers detail <id> [--json]	回答详情
answers comments <id> [--limit] [--json]	回答评论列表
answers voters <id> [--limit] [--json]	回答投票人列表

users — 用户资料与内容

命令	说明
users profile <url_token> [--json]	用户资料
users articles <url_token> [--limit] [--sort] [--json]	用户文章
users answers <url_token> [--limit] [--sort] [--json]	用户回答
users questions <url_token> [--limit] [--json]	用户提问
users followers <url_token> [--limit] [--json]	粉丝列表
users followees <url_token> [--limit] [--json]	关注列表
users collections <url_token_or_id> [--limit] [--json]	收藏夹列表（兼容 url_token 和 user_id）
users pins <url_token> [--limit] [--json]	想法列表
users activities <url_token> [--limit] [--json]	用户动态
users mutuals <url_token> [--limit] [--json]	互关列表
users following-topics <url_token> [--limit] [--json]	关注话题
users following-questions <url_token> [--limit] [--json]	关注问题
users following-columns <url_token> [--limit] [--json]	关注专栏
users zvideos <url_token> [--limit] [--json]	用户视频
users columns <url_token> [--limit] [--json]	用户专栏列表

columns — 专栏

命令	说明
columns list [--limit] [--json]	我的专栏列表
columns recommend [--classify] [--limit] [--json]	专栏推荐
columns search <keyword> [--limit] [--json]	专栏搜索（兼容旧命令）
columns detail <slug_or_id> [--json]	专栏详情
columns articles <slug_or_id> [--limit] [--json]	专栏文章列表

hot — 热榜

命令	说明
hot list [--limit] [--json]	知乎热榜（含问题ID、热度、标题）

search — 统一搜索

命令	说明
search general <keyword> [--limit] [--json]	综合搜索
search questions <keyword> [--limit] [--json]	问题搜索
search answers <keyword> [--limit] [--json]	回答搜索
search articles <keyword> [--limit] [--json]	文章搜索
search columns <keyword> [--limit] [--json]	专栏搜索
search topics <keyword> [--limit] [--json]	话题搜索
search people <keyword> [--limit] [--json]	用户搜索
search top [--json]	热搜关键词
search preset-words [--json]	搜索预设词

creator — 创作中心

命令	说明
creator home [--json]	创作中心首页概览
creator stats [--json]	创作数据统计

topics — 话题

命令	说明
topics detail <topic_id> [--json]	话题详情
topics unanswered <topic_id> [--limit] [--json]	话题待答问题

collections — 收藏夹

命令	说明
collections detail <id> [--json]	收藏夹详情
collections contents <id> [--limit] [--json]	收藏夹内容列表

pins — 想法

命令	说明
pins detail <pin_id> [--json]	想法详情

notifications — 通知

命令	说明
notifications invites [--limit] [--json]	邀请回答通知
notifications messages [--limit] [--json]	消息通知

Agent 使用要点

1. 必须加 --json：当需要解析/处理数据时，加 --json 输出原始 JSON
2. 分页：--offset 和 --limit 控制分页，默认 offset=0, limit=20
3. ID 不截断：所有 ID 列使用 no_wrap+min_width=22，19位知乎ID完整显示
4. 标识符：users 子命令用 url_token（如 toff314），users collections 同时兼容 url_token 和 user_id
5. 旧命令兼容：questions search 和 columns search 仍可用，内部转调统一 search 方法

限制

• 只读：不支持发布/编辑（需动态签名 x-zst-81）
• Cookie 过期：401 错误需重新登录
• 部分接口 403：问题详情、文章详情(v4)、话题详情(v4) 需签名，项目使用 fallback

开发

pip install -e ".[dev]"
ruff check zhihu_creator_cli/
ruff format zhihu_creator_cli/

# 代码结构
zhihu_creator_cli/
├── cli.py              # 入口
├── commands/           # Click 命令定义（14 模块）
├── client/             # API 客户端（Mixin 架构，14 模块）
├── display/            # 展示逻辑（14 模块）