@marvae24/douban-cli
v0.2.0
Published
Douban CLI - browse movies, TV shows, search from terminal | 豆瓣命令行工具
Maintainers
Readme
douban-cli
Douban CLI - browse movies, TV shows, books, and personal collections from the terminal.
豆瓣命令行工具:在终端查看热门电影/剧集、排行榜、Top250、用户片单、书籍搜索与详情,并支持登录后进行标记、评分、评论、长评、导出和社交操作。
Features / 功能
Movies / 电影
hot热门电影/剧集tv按标签查看剧集rank类型高分排行top250豆瓣 Top 250now正在热映coming即将上映weekly一周口碑榜search电影搜索movie电影详情(支持 ID 或片名)rating评分分布comments短评reviews热门影评
Books / 书籍
book hot热门书籍book search搜索书籍book info书籍详情
User / 用户
user指定用户片单me我的片单(配置用户 ID 或登录态自动识别)config本地配置list热门豆列celebrity影人信息
Auth & Social / 登录与社交
login登录并缓存 Cookiewhoami查看当前登录用户logout清除本地登录态mark标记想看/看过/在看unmark取消标记rate评分(1-5)comment发送短评review发布长评feed查看关注动态stats观影统计export导出观影记录follow关注用户unfollow取消关注
Installation / 安装
需要 Node.js 22 或更高版本。
npm install -g @marvae24/douban-cli或直接运行:
npx @marvae24/douban-cli hotRequirements / 运行要求
- Node.js
>= 22 - 支持的浏览器(用于自动提取登录态):Chrome / Edge / Firefox / Safari
Usage / 常用命令
基础查询
douban hot
douban hot --tv
douban tv 美剧 --limit 10
douban rank 科幻 --limit 20
douban top250 --limit 50
douban now --city 上海
douban coming --limit 10
douban weekly搜索与详情
douban search "奥本海默"
douban movie 35593344
douban movie "沙丘"
douban rating 1291546
douban comments 1291546 --latest
douban reviews 1291546 --limit 5书籍
douban book hot --limit 10
douban book search "三体"
douban book info 2567698用户与配置
douban user USER_ID
douban user USER_ID --wish
douban config --user USER_ID
douban me
douban me --doing
douban list --limit 10登录与身份
douban login
douban whoami
douban logout标记/评分/评论(需登录)
douban mark 1292052 --wish
douban mark 1292052 --watched
douban mark 1292052 --watching
douban unmark 1292052
douban rate 1292052 --score 5
douban comment 1292052 "值得二刷"
douban review 1292052 "标题" "长评正文"批量操作(需登录)
douban mark --file ids.txt --wish
douban unmark --file ids.txt --delay 1.5
douban rate --file rate.csv
douban comment --file comments.csv --delay 1.5文件格式:
ids.txt: 每行一个电影 IDrate.csv: 每行<id>,<score>(score为1-5)comments.csv: 每行<id>,<comment>(也支持制表符分隔)
社交与数据(需登录)
douban feed --limit 10
douban stats --year 2026
douban export --format json -o douban-export.json
douban export --format csv -o douban-export.csv
douban follow USER_ID
douban unfollow USER_IDJSON 输出
所有命令都支持 --json:
douban search "沙丘" --json
douban whoami --json
douban export --format json --output export.jsonLicense
MIT
