Skip to content
Back to search

douban-cli

豆瓣命令行工具 + AI Agent Skill:查电影、剧集、图书和 Top250,导出备份豆瓣观影/读书记录,让 AI 放心地标记评分 | Douban CLI for movies, books & your ratings

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Marvae/douban-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Marvae/douban-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marvae--douban-cli/badge.svg)](/listings/marvae--douban-cli)

HTML

<a href="/listings/marvae--douban-cli"><img src="/api/listings/marvae--douban-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 102 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # douban-cli · 豆瓣命令行工具
  2. [![npm version](https://img.shields.io/npm/v/%40marvae24%2Fdouban-cli.svg)](https://www.npmjs.com/package/@marvae24/douban-cli)
  3. [![npm downloads](https://img.shields.io/npm/dm/%40marvae24%2Fdouban-cli.svg)](https://www.npmjs.com/package/@marvae24/douban-cli)
  4. [![CI](https://github.com/Marvae/douban-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Marvae/douban-cli/actions/workflows/ci.yml)
  5. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. 在终端和 AI 里用豆瓣:查电影、剧集、图书和 Top250,一条命令导出备份你的豆瓣观影和读书记录,让 AI 放心地帮你标记、评分、写短评。
  7. 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.
  8. ```text
  9. $ npx @marvae24/douban-cli now
  10. 🍿 正在热映
  11. # 片名 评分 上映 ID
  12. 1 生化危机:爆发夜 7.3 10.05 37068446
  13. 2 鲸口脱险 6.2 10.16 36806762
  14. 3 神探之痕迹 6.8 10.01 37247814
  15. 4 一个夜晚与三个夏天 7.2 10.13 36449264
  16. 5 野兽之心 7.3 09.30 36828393
  17. ```
  18. - 💾 **备份你的豆瓣**:一条命令导出看过、想看、在看和读过、想读、在读,连同评分、短评和“仅自己可见”的条目,存成 JSON、CSV 或 Markdown。
  19. - 🤖 **交给 AI**:装上 Skill,直接说“今晚看什么”“用 ISBN 把这本书标成读过,评 5 星”。改动账号前会先给你看预览;同一书名有多个版本时按 ISBN 核对。
  20. - 🔎 **想查就查**:片名、书名、ISBN 直接查评分、短评、书评、相似推荐和播放平台;实时热门、Top250、正在热映、电影/剧集/综艺口碑榜、豆列都能看,不用登录。
  21. - 🛡️ **改得放心**:只改你指定的内容,原有评分、标签和可见性都会保留,不发广播,改完读回核对。
  22. - 🪶 **不用安装**:有 Node.js 就能用 `npx` 直接运行。只有 2 个依赖,不需要申请 API key。
  23. ## 常见用法
  24. | 想做的事 | 怎么做 |
  25. |---|---|
  26. | 备份豆瓣观影、读书记录 | `douban export -o movies.md`,`douban book export -o books.csv` |
  27. | 把微信读书读完的书同步到豆瓣 | 同时装上微信读书官方 Skill,对 AI 说“把我今年在微信读书读完的书标到豆瓣”;按 ISBN 精确匹配,先预览再提交 |
  28. | 找下一部想看的 | 对 AI 说“推荐几部像《沙丘》的电影”,或 `douban movie 沙丘` 看相似推荐 |
  29. | 最近追什么剧 | `douban trending --tv` 看实时热度,`douban weekly --tv` 看口碑;`douban movie <剧名>` 看在哪个平台播 |
  30. | 查评分和榜单 | `douban trending`(实时热门)、`douban top250`、`douban now`、`douban weekly`、`douban book info <ISBN>` |
  31. ## 在 AI agent 里使用
  32. 把这句话发给你的 agent:
  33. > 安装这个 skill 并帮我配置好:https://github.com/Marvae/douban-cli/tree/main/skills/douban-cli
  34. 或者在终端安装到本机支持 Agent Skills 的 agent:
  35. ```bash
  36. npx skills add Marvae/douban-cli
  37. ```
  38. Skill 会在需要时帮你装好 CLI。用到账号功能时,需要你在自己的终端里运行一次 `douban login`。
  39. ## 在终端使用
  40. ```bash
  41. npm install -g @marvae24/douban-cli # 需要 Node.js 22.13+,也可以不装,用 npx @marvae24/douban-cli
  42. douban movie 沙丘 # 片名或 ID 都行,附相似推荐
  43. douban comments 沙丘 -n 10 # 热门短评
  44. douban book info 9787536692930 # 书名、ISBN 或 ID
  45. douban list 240962 # 读取豆列
  46. douban login # 读取浏览器里已有的豆瓣登录
  47. douban export -o my-movies.json # 备份自己的看过/想看/在看(书单用 book export)
  48. douban book mark 2567698 --read --dry-run # 先预览,确认后去掉 --dry-run
  49. ```
  50. ## 命令一览
  51. | 分类 | 命令 |
  52. |---|---|
  53. | 电影与剧集 | `trending` `hot` `tv` `rank` `top250` `now` `coming` `weekly` `search` `movie` `rating` `comments` `reviews` |
  54. | 图书 | `book top250` `chart` `new` `search` `info` `rating` `comments` `reviews` `notes` |
  55. | 用户与豆列 | `me` `book me` `user` `book user` `list` `config` |
  56. | 账号与备份 | `login` `whoami` `logout` `record` `stats` `export`,图书加 `book` 前缀 |
  57. | 修改记录 | `mark` `rate` `comment` `unmark`,图书加 `book` 前缀;`review` `follow` `unfollow` |
  58. | 诊断 | `doctor` |
  59. 每个命令都可以用 `douban <命令> --help` 查看参数。详细说明:[命令参考](docs/commands.md) · [登录、修改与导出](docs/account.md) · [脚本与排查](docs/scripting.md)
  60. ## 安全与隐私
  61. - 修改记录时只改你指定的内容,原有评分、标签和“仅自己可见”都会保留,也不会发到广播。
  62. - 公开查询不读取 Cookie。登录只保存豆瓣登录所需的两项,按本机身份加密存放,30 天后失效,`douban logout` 立即删除。
  63. - 非官方工具,请控制请求频率。被限流时它会明确告诉你,而不是返回空结果。
  64. ## 开发
  65. ```bash
  66. npm ci
  67. npm run verify # lint、类型检查、单元测试、构建和 CLI 冒烟测试
  68. ```
  69. 代码结构与约定见 [AGENTS.md](AGENTS.md)。
  70. ## License
  71. MIT
  72. 觉得有用的话,点个 ⭐ Star,让更多人找到它。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.