douban-cli · 豆瓣命令行工具

在终端和 AI 里用豆瓣：查电影、剧集、图书和 Top250，一条命令导出备份你的豆瓣观影和读书记录，让 AI 放心地帮你标记、评分、写短评。

Douban (豆瓣) from your terminal and AI agents: look up movies, TV shows and books, back up your ratings and reviews to JSON, CSV or Markdown, and let an agent mark and rate titles safely.

$ npx @marvae24/douban-cli now

🍿 正在热映

#    片名                 评分   上映    ID
1    生化危机：爆发夜     7.3    10.05   37068446
2    鲸口脱险             6.2    10.16   36806762
3    神探之痕迹           6.8    10.01   37247814
4    一个夜晚与三个夏天   7.2    10.13   36449264
5    野兽之心             7.3    09.30   36828393

• 💾 备份你的豆瓣：一条命令导出看过、想看、在看和读过、想读、在读，连同评分、短评和“仅自己可见”的条目，存成 JSON、CSV 或 Markdown。
• 🤖 交给 AI：装上 Skill，直接说“今晚看什么”“把《三体》标成读过，评 5 星”。改动账号前会先给你看预览。
• 🔎 想查就查：片名、书名、ISBN 直接查评分、短评、书评和相似推荐；Top250、正在热映、口碑榜、豆列都能看，不用登录。
• 🛡️ 改得放心：只改你指定的内容，原有评分、标签和可见性都会保留，不发广播，改完读回核对。
• 🪶 不用安装：有 Node.js 就能用 npx 直接运行。只有 2 个依赖，不需要申请 API key。

常见用法

想做的事	怎么做
备份豆瓣观影、读书记录	douban export -o movies.md，douban book export -o books.csv
把微信读书读完的书同步到豆瓣	同时装上微信读书官方 Skill，对 AI 说“把我今年在微信读书读完的书标到豆瓣”；按 ISBN 精确匹配，先预览再提交
找下一部想看的	对 AI 说“推荐几部像《沙丘》的电影”，或 douban movie 沙丘 看相似推荐
查评分和榜单	douban top250、douban now、douban weekly、douban book info <ISBN>

在 AI agent 里使用

把这句话发给你的 agent：

安装这个 skill 并帮我配置好：https://github.com/Marvae/douban-cli/tree/main/skills/douban-cli

或者在终端安装到本机支持 Agent Skills 的 agent：

npx skills add Marvae/douban-cli

Skill 会在需要时帮你装好 CLI。用到账号功能时，需要你在自己的终端里运行一次 douban login。

在终端使用

npm install -g @marvae24/douban-cli    # 需要 Node.js 22.13+，也可以不装，用 npx @marvae24/douban-cli

douban movie 沙丘                      # 片名或 ID 都行，附相似推荐
douban comments 沙丘 -n 10             # 热门短评
douban book info 9787536692930         # 书名、ISBN 或 ID
douban list 240962                     # 读取豆列

douban login                           # 读取浏览器里已有的豆瓣登录
douban export -o my-movies.json        # 备份自己的看过/想看/在看（书单用 book export）
douban book mark 2567698 --read --dry-run   # 先预览，确认后去掉 --dry-run

命令一览

分类	命令
电影与剧集	hot tv rank top250 now coming weekly search movie rating comments reviews
图书	book top250 chart new search info rating comments reviews notes
用户与豆列	me book me user book user list config
账号与备份	login whoami logout record stats export，图书加 book 前缀
修改记录	mark rate comment unmark，图书加 book 前缀；review follow unfollow
诊断	doctor

每个命令都可以用 douban <命令> --help 查看参数。详细说明：命令参考 · 登录、修改与导出 · 脚本与排查

安全与隐私

• 修改记录时只改你指定的内容，原有评分、标签和“仅自己可见”都会保留，也不会发到广播。
• 公开查询不读取 Cookie。登录只保存豆瓣登录所需的两项，加密存在本机，30 天后失效，douban logout 立即删除。
• 非官方工具，请控制请求频率。被限流时它会明确告诉你，而不是返回空结果。

开发

npm ci
npm run verify   # lint、类型检查、单元测试、构建和 CLI 冒烟测试

代码结构与约定见 AGENTS.md。

License

MIT

觉得有用的话，点个 ⭐ Star，让更多人找到它。