核心用法
douban-cli 是一款模拟豆瓣官方 API 风格的 Node.js 命令行工具，开发者可通过 npm 全局安装后，在终端快速查询电影、剧集、书籍、用户片单等数据。核心功能覆盖四大模块：
1. 影视查询：支持热门电影/剧集、类型排行、Top250、正在热映、即将上映、一周口碑榜；支持按城市查询影院排片，以及按关键词搜索。
2. 深度信息：通过电影 ID 获取详情、评分分布（1-5 星占比）、热门短评、长评全文，满足深度分析需求。
3. 书籍模块：热门书籍、搜索、详情查询，覆盖文艺阅读场景。
4. 用户系统：可配置用户 ID 查看"我的片单"，或查询任意用户的想看/看过/在看列表，支持热门片单聚合。
所有命令支持 --json 输出结构化数据，便于脚本集成；--limit 参数控制返回数量，方便分页处理。
显著优点
- 终端原生体验：无需打开浏览器或 App，命令行秒级响应，适合多屏工作流与自动化脚本。
- 数据维度丰富：不仅提供基础信息，更包含评分分布、短评情感样本、长评内容，可用于简单的舆情分析。
- 输出格式灵活：JSON 模式支持与 Python、Shell、Node.js 等工具链无缝衔接，方便数据持久化与二次开发。
- 轻量无依赖：单 npm 包安装，不依赖本地数据库或复杂环境配置。
潜在缺点与局限性
- 非官方客户端：工具通过逆向或爬虫方式获取数据，存在接口失效风险；豆瓣官方 API 已收紧，长期稳定性存疑。
- 数据实时性：依赖缓存或轮询策略，热门榜单可能存在数小时延迟，无法保证与官方 App 完全同步。
- 反爬限制：高频请求可能触发 IP 限制或验证码，需自行控制调用频率；无内置代理或重试机制。
- 功能边界：不支持账号登录、评分、写评论等写操作，仅限只读查询；用户隐私设置可能导致部分片单不可见。
适合人群
- 终端重度用户与开发者，习惯命令行工作流
- 数据分析师、影评博主，需要批量采集豆瓣结构化数据
- 自建媒体库或推送服务的极客，需自动化获取榜单更新
- 避免移动端干扰、追求专注阅读信息的效率人士
常规风险
- 合规风险：抓取豆瓣数据可能违反《豆瓣用户协议》，大规模商业使用存在法律隐患
- 隐私泄露：配置用户 ID 后，片单信息可能被本地日志记录，共享环境需注意清理
- 供应链安全：npm 包依赖第三方模块，建议审计
package-lock.json，防范恶意依赖注入 - 稳定性风险：接口变更可能导致命令突然失效，需关注项目更新或准备降级方案