Skip to content

commands.md

Latest commit

 

History

History
126 lines (102 loc) · 7.65 KB

commands.md

File metadata and controls

126 lines (102 loc) · 7.65 KB
Raw

命令参考

每个命令的完整参数以 douban <命令> --help 为准。登录、写入、导出与隐私见 account.md；JSON、错误码与排查见 scripting.md。

电影与剧集

这一组命令都是公开只读请求，无需登录，并且全部支持 --json。

命令 能做什么 常用参数
douban trending 豆瓣实时热门（书影音综合榜，每小时更新），含热度和排名变化 --movie、--tv、--limit（最多 20）
douban hot 热门电影；加 --tv 查看剧集 --tv、--tag、--limit
douban tv <tag> 按标签查看剧集 热门/美剧/英剧/日剧/韩剧/国产剧/综艺/最新
douban rank <genre> 按类型查看高分电影 --limit
douban top250 豆瓣电影 Top250 --page、--limit，支持交互翻页
douban now 正在热映（全国） --limit
douban coming 即将上映 --limit
douban weekly 一周口碑电影榜；--tv 华语口碑剧集、--show 国内口碑综艺，加 --global 看全球/国外 --tv、--show、--global、--limit
douban search <keyword> 搜索电影和剧集（自动复用本地登录态，见下文） --start、--limit
douban movie <id-or-title> 电影/剧集详情，可直接传 ID 或片名 --json
douban rating <id-or-title> 评分分布、想看/看过统计和类型排名 ID 或片名
douban comments <id-or-title> 热门短评 --page、--limit
douban reviews <id-or-title> 热门影评 --page、--limit

类型排行支持：剧情、喜剧、动作、爱情、科幻、动画、悬疑、惊悚、恐怖、纪录片、短片、情色、同性、音乐、歌舞、家庭、儿童、传记、历史、战争、犯罪、西部、奇幻、冒险、灾难、武侠、古装、运动、黑色电影。

douban trending                        # 实时热门：综艺、剧集、电影一起排
douban trending --tv                   # 只看电视榜
douban weekly --tv                     # 华语口碑剧集榜（每周三更新）
douban weekly --show --global          # 国外口碑综艺榜
douban hot --tv --tag 英剧 --limit 10
douban top250 --page 2
douban search "奥本海默" --start 20 --limit 20
douban movie 35593344
douban movie "沙丘"
douban rating 1291546
douban rating 沙丘
douban comments 1291546
douban reviews 1291546 --limit 5

搜索和按片名、书名查询会自动复用本地登录态，未登录时更容易被豆瓣限流；被限流时返回 RATE_LIMITED，稍后再试即可。ISBN 走豆瓣的直达地址，不经过搜索。

电影详情包括片名、年份、评分（无评分时附豆瓣给的原因，如“暂无评分”）、导演、主演、类型、地区、语言、片长、上映/首播日期、集数、播放平台（vendors，如“腾讯视频（单片付费）· 独播”）、简介，以及“喜欢这部电影的人也喜欢”（recommendations）。播放平台只列豆瓣收录的，没有列出不代表无处可看。推荐或剧集集数读取失败时，不影响其余内容。

同一片名可能是电影、剧集或翻拍。按片名查询时，会优先完全同名的条目；有多部同名作品时，终端里列出年份和类型供选择。管道和 --json 不会自动用第一个，而是返回 AMBIGUOUS 并列出候选项，请改用 ID。

图书

以下读取命令无需登录，详情类命令接受豆瓣 ID、ISBN 或书名。book user / book export / book stats 会自动复用本地登录态；匿名读取书单时结果可能较少或被拒绝。图书的标记、评分和短评见 account.md。

命令 能做什么 常用参数
douban book top250 豆瓣图书 Top250 --page、--limit，支持交互翻页
douban book chart [category] 当前热门图书榜，最多 20 条 --limit
douban book new [category] 新书速递，最多 20 条 --limit；别名 latest
douban book search <keyword> 按书名、作者或 ISBN 搜索 --start、--limit
douban book info <query> 图书完整详情 ID、ISBN 或关键词
douban book rating <query> 五星分布与想读/在读/读过统计 ID、ISBN 或关键词
douban book comments <query> 热门短评 --page、--limit
douban book reviews <query> 热门书评 --page、--limit
douban book notes <query> 热门读书笔记 --page、--limit
douban book me 我的想读/在读/读过书单（config --user 指定的用户或当前登录账号） --wish、--reading、--page、--limit
douban book user <userId> 指定用户当前可见的想读/在读/读过书单 --wish、--reading、--page、--limit
douban book stats 某一年的读书统计 --year、--limit
douban book export [userId] 导出书单（默认自己的读过/想读/在读） -o、--wish、--reading、--format、--limit

book chart 和 book new 支持：全部、文学、小说、历史文化、社会纪实、科学新知、艺术设计、商业经管、绘本漫画。

# 榜单与发现
douban book chart 小说 --limit 10
douban book top250 --page 2 --limit 25
douban book latest 科学新知

# 搜索、详情与内容
douban book search "三体" --limit 20
douban book info 三体
douban book info 9787536692930
douban book rating 三体
douban book comments 三体
douban book reviews 三体 --limit 5
douban book notes 三体 --limit 5

# 书单（自动复用本地登录态）
douban book user USER_ID --wish --page 2
douban book user USER_ID --reading
douban book export -o my-books.md
douban book export USER_ID --reading -o reading.csv

图书详情包括作者、译者、出版社、出版年、页数、定价、ISBN、丛书、标签、简介、作者简介、目录，以及“喜欢读这本书的人也喜欢”（recommendations）。某个数据来源失败时，保留其余来源的结果。

同一书名常有多个版本，出版社、ISBN 和评分都可能不同。终端里按书名查询会列出同名版本（评分、评价人数、出版社），输入编号选择，回车用第一个。管道和 --json 不会自动用第一个，而是返回 AMBIGUOUS 并列出候选项。ISBN 精确对应那一版。

用户收藏、豆列与配置

命令 能做什么 说明
douban user <userId> 指定用户的电影看过/想看/在看 自动复用本地登录态；默认看过，使用 --wish 或 --doing 切换
douban book user <userId> 指定用户当前可见的图书读过/想读/在读 自动复用本地登录态；默认读过，使用 --wish 或 --reading 切换
douban config 查看本地配置；--user <id> 设置 me 和 book me 的默认用户 无需登录
douban me config --user 指定的用户或当前登录账号的电影片单 默认看过，使用 --wish 或 --doing 切换；--page、--limit
douban list 热门豆列推荐 无需登录
douban list <id-or-url> 读取豆列内容，自动翻页 无需登录；--limit（最多 1000）、--start 
douban user USER_ID
douban user USER_ID --wish --page 2
douban user USER_ID --doing

douban config --user USER_ID
douban config
douban me --wish
douban list --limit 10
douban list 240962 --limit 50
douban list https://www.douban.com/doulist/240962/ --start 25

诊断

douban doctor            # 检查 Node.js 版本、登录态与本地文件权限，不发请求
douban doctor --online   # 额外发 2-3 个只读请求：公开接口、搜索是否被限流、登录是否仍然有效