核心用法
douban-cli 是一款基于 Node.js 开发的命令行工具，通过非官方接口抓取豆瓣电影、书籍及用户数据。用户可通过简洁指令查询热门榜单（douban hot、douban top250）、分类剧集（美剧/日剧/韩剧/国产剧）、类型排行（科幻/动作/悬疑等）、影院实时排片（douban now），以及搜索具体条目详情、短评长评、影人信息。书籍模块支持热门榜单与关键词检索。用户系统允许查询公开收藏或绑定个人账号查看私有收藏（douban me）。
显著优点
- 高效便捷：纯命令行交互，支持 JSON 输出与管道处理，便于脚本自动化
- 数据维度丰富：涵盖电影、电视剧、书籍、影人、用户、影评等多维度信息
- 场景覆盖广：从日常选片（热门、口碑榜）到深度调研（详情、评论、收藏）均可满足
- 跨平台：Node.js 生态，Windows/macOS/Linux 通用
潜在缺点与局限性
- 非官方 API：依赖逆向或爬虫技术，接口稳定性无保障，存在随时失效风险
- IP 封禁风险：频繁请求可能触发豆瓣反爬机制，导致临时或永久封禁
- 数据时效性：缓存机制不明，部分数据可能滞后于官方 App
- 无 GUI：对非技术用户门槛较高
- 隐私边界模糊：用户收藏查询功能可能涉及数据爬取合规性争议
适合人群
命令行爱好者、影视行业研究员、数据分析师、自动化脚本开发者，以及习惯终端工作流的重度豆瓣用户。
常规风险
- 账号风险：若使用个人账号登录功能，Cookie 等凭证本地存储存在泄露隐患
- 法律合规：大规模爬取数据可能违反豆瓣用户协议及相关法律法规
- 服务中断：非官方工具随时可能因接口变更而失效，无官方支持渠道