核心功能与用法
douban-cli 是一款基于 Node.js 开发的命令行工具，通过封装豆瓣公开数据接口，提供无需打开浏览器即可快速查询电影、剧集、书籍及用户片单的能力。核心用法涵盖四大模块：
1. 影视查询：douban hot 查看热门电影/剧集，douban top250 获取经典榜单，douban rank 科幻 按类型筛选，douban now 查询影院热映，douban movie <id> 查看详情并配合 rating、comments、reviews 分析评分分布与口碑。
2. 书籍检索：douban book hot 与 douban book search 提供书籍发现与详情查询。
3. 用户数据：douban config --user 绑定账号后，通过 douban me 或 douban user <id> 导出个人或他人「想看」「看过」片单。
4. 数据导出：全局支持 --json 参数输出结构化数据，--limit 控制返回数量，便于脚本化集成与数据分析。
显著优点
- 效率极高：终端直接输出，避免网页跳转与广告干扰，API 响应秒级返回。
- 数据结构化：JSON 输出天然适合配合
jq、Python等工具进行自动化处理与持久化存储。 - 功能覆盖全：从榜单浏览、详情查询到用户片单导出，满足影迷整理待看清单、爬虫开发者获取训练数据、数据分析师研究评分分布等多场景需求。
- 跨平台：基于 Node.js，Windows、macOS、Linux 均可运行。
潜在局限与风险
- 接口稳定性：依赖非官方公开接口，豆瓣反爬策略调整可能导致功能失效或限流。
- 数据完整性：部分用户隐私数据（如非公开片单）无法获取；长评、短评可能因版权或反爬机制返回不完整内容。
- 无官方背书：非豆瓣官方产品，接口变更或停止维护时无服务保障。
- Cookie/登录风险：查看个人片单需配置用户 ID，存在账号异常判定风险，建议避免使用主账号。
适合人群
- 开发者与数据分析师：需要批量获取豆瓣结构化数据构建数据集。
- 影迷与书虫：习惯终端操作，追求高效查询与待看清单管理。
- 自动化爱好者：希望将豆瓣数据集成至个人工作流或通知系统。
常规使用建议
建议配合 --json 与 jq 进行数据筛选，避免高频请求触发限流；涉及用户数据时优先使用小号或游客模式，降低账号风险。