douban-cli

豆瓣电影/书籍/影人/用户收藏查询与标记命令行工具。

场景指引

根据用户意图选择合适的命令：

用户意图	推荐命令
"最近有啥好看的" / "推荐电影"	INLINECODE0 或 INLINECODE1
"经典电影推荐" / "必看电影"

douban top250 |
| "有什么美剧/日剧/韩剧" | douban tv 美剧 / 日剧 / 韩剧 |
| "想看科幻/动作/悬疑片" | douban rank 科幻 / 动作 / 悬疑 |
| "XX电影怎么样" / "介绍一下XX" | 先 douban search XX 拿 ID，再 douban movie <id> |
| "XX电影评价如何" | douban comments <id> 看短评，douban reviews <id> 看长评 |
| "XX是谁演的" / "这个导演还拍过什么" | douban celebrity <id> |
| "有什么好书" | douban book hot |
| "这本书怎么样" | douban book search XX，再 douban book info <id> |
| "我看过的电影" / "我的片单" | douban me（需登录） |
| "帮我标记看过/想看" | douban mark <id> --watched / --wish（需登录） |
| "导出我的观影记录" | douban export --format csv -o records.csv（需登录） |

常见工作流

查一部电影的完整信息：
CODEBLOCK0

批量标记/评分（从文件读取）：
CODEBLOCK1

命令参考

浏览（无需登录）

命令	说明
INLINECODE21	热门电影
INLINECODE22

热门剧集（综合） | | douban tv 美剧 | 分类剧集。可选：美剧、英剧、日剧、韩剧、国产剧 | | douban rank 科幻 | 类型排行。可选：科幻、动作、爱情、悬疑、喜剧、恐怖、动画等 | | douban top250 | 豆瓣 Top 250 | | douban now | 正在热映。-c 上海 指定城市 | | douban coming | 即将上映 | | douban weekly | 一周口碑榜 | | douban search <关键词> | 搜索电影 | | douban movie <id或片名> | 电影详情。支持数字 ID 或片名（片名会自动搜索匹配） | | douban comments <id> | 热门短评。--latest 按时间排序 | | douban reviews <id> | 热门影评 | | douban rating <id> | 评分分布（星级柱状图） | | douban celebrity <id> | 影人详情（演员/导演） |

书籍（无需登录）

命令	说明
INLINECODE37	热门书籍 Top 250
INLINECODE38

搜索书籍 | | douban book info <id> | 书籍详情 |

用户与配置

命令	说明	需登录
INLINECODE40	查看用户片单	否
INLINECODE41

我的片单 | 是 | | douban config --user <id> | 设置默认用户 ID | 否 |

登录

命令	说明
INLINECODE43	登录（自动从浏览器提取 Cookie，支持 Chrome/Edge/Firefox/Safari）
INLINECODE44

查看当前登录用户 | | douban logout | 退出登录 |

标记（需登录）

命令	说明
INLINECODE46	标记想看
INLINECODE47

标记看过 | | douban mark <id> --watching | 标记在看 | | douban unmark <id> | 取消标记 | | douban rate <id> --score <1-5> | 评分（1-5 星） | | douban comment <id> "评论内容" | 发布短评 | | douban review <id> "标题" "正文" | 发布长评 |

社交与统计（需登录）

命令	说明
INLINECODE53	关注动态
INLINECODE54

年度观影统计 | | douban export -o records.csv -f csv | 导出记录。格式：json（默认）/ csv | | douban follow <userId> | 关注用户 | | douban unfollow <userId> | 取消关注 |

通用选项

选项	说明
INLINECODE58	以 JSON 格式输出，便于程序处理
INLINECODE59 / INLINECODE60

控制返回数量 | | --start N / -s N | 分页偏移（从 0 开始） | | --delay <秒> | 批量操作的请求间隔，避免触发反爬（默认随机 1-2 秒） |

故障排除

问题	解决方式
"反爬挑战" 错误	豆瓣临时封禁，等几分钟后重试，或降低请求频率（加大 --delay）
"ck token" / 登录失效

通常会自动重试刷新。若仍失败，再运行 douban logout 然后 douban login | | 搜索无结果 | 尝试更短的关键词，或直接用豆瓣 ID | | "未配置默认用户" | 运行 douban login 或 douban config --user <id> | | 批量操作部分失败 | 检查输出的错误信息，常见原因：ID 不存在、评分不在 1-5 范围、重复标记 |