Douban CLI

豆瓣电影/书籍/影人/用户收藏查询与标记 CLI。触发词：豆瓣、电影推荐、热门电影、想看什么、top250、美剧日剧韩剧、影评短评、标记看过、评分、好书推荐、书籍、豆列、关注、导出观影记录、影人、演员导演。

Security Scan

The skill's declared requirements and instructions (npm package providing a douban CLI, reading browser cookies to obtain Douban login, storing config/auth files) are coherent with its description; nothing indicates it is doing unrelated or hidden actions, but it does request sensitive browser-cookie access which the user should consider before installing.

Purpose & Capability

Name/description (Douban CLI) match the declared binary 'douban' and the npm install @marvae24/douban-cli. Commands and config paths in SKILL.md align with a CLI that queries and marks Douban content.

Instruction Scope

Runtime instructions focus on search/browse/mark/export operations and batch file workflows. They explicitly state the CLI will extract Douban login state from browser cookies and write local config/auth files (~/.douban-cli.json, ~/.douban-cli-auth.json). Those actions are within scope for a CLI that needs to authenticate, but extracting browser cookies is sensitive and worth scrutiny.

Install Mechanism

Install is an npm package (@marvae24/douban-cli) that provides the 'douban' binary—this is an expected and common distribution method for a CLI. NPM installs carry the usual moderate risk (third-party code executed on your machine); no suspicious download URLs or archive extraction are present in the spec.

Credentials

No environment variables are requested (ok). The skill requests permission to read browser cookies (Chrome/Edge/Firefox/Safari) to extract Douban login state and will store encrypted auth cache in the home directory. Reading browser cookies is disproportionally sensitive if the tool reads entire cookie stores or other sites' cookies; the SKILL.md states the intent (extract Douban cookies), which makes it justifiable but still sensitive.

Persistence & Privilege

The skill is not always-enabled, does not request system-wide config changes, and stores only its own config/auth files under the user's home. Autonomous invocation (agent can invoke) is the platform default; combined with browser-cookie access this increases potential impact if misused, but there is no evidence here the skill abuses persistence or privileges.

Assessment

This skill appears to do what it says: it installs an npm 'douban' CLI that reads browser cookies to log you into Douban and stores local config/auth files. Before installing, consider: 1) Trust the npm package and maintainer (@marvae24) — inspect the package source on the registry or GitHub if possible. 2) Browser-cookie access is sensitive — confirm the tool only extracts Douban-specific cookies and not unrelated site tokens. 3) If you have concerns, run the tool in an isolated environment or container, or use explicit credentials instead of cookie extraction. 4) After installation, review ~/.douban-cli-auth.json and ~/.douban-cli.json and monitor network activity if you want extra assurance.

豆瓣电影/书籍/影人/用户收藏查询与标记命令行工具。

场景指引

根据用户意图选择合适的命令：

用户意图	推荐命令
"最近有啥好看的" / "推荐电影"	douban hot 或 douban weekly
"经典电影推荐" / "必看电影"	douban top250
"有什么美剧/日剧/韩剧"	douban tv 美剧 / 日剧 / 韩剧
"想看科幻/动作/悬疑片"	douban rank 科幻 / 动作 / 悬疑
"XX电影怎么样" / "介绍一下XX"	先 douban search XX 拿 ID，再 douban movie <id>
"XX电影评价如何"	douban comments <id> 看短评，douban reviews <id> 看长评
"XX是谁演的" / "这个导演还拍过什么"	douban celebrity <id>
"有什么好书"	douban book hot
"这本书怎么样"	douban book search XX，再 douban book info <id>
"我看过的电影" / "我的片单"	douban me（需登录）
"帮我标记看过/想看"	douban mark <id> --watched / --wish（需登录）
"导出我的观影记录"	douban export --format csv -o records.csv（需登录）

常见工作流

查一部电影的完整信息：

douban search 盗梦空间          # 拿到 ID（如 3541415）
douban movie 3541415            # 看详情
douban rating 3541415           # 看评分分布
douban comments 3541415         # 看热门短评
douban reviews 3541415          # 看热门影评

批量标记/评分（从文件读取）：

douban mark --file ids.txt --wish              # 批量标记想看（每行一个 ID）
douban rate --file scores.txt --delay 3        # 批量评分（每行: ID,分数）
douban comment --file comments.txt --delay 3   # 批量短评（每行: ID,评论内容）

命令参考

浏览（无需登录）

命令	说明
douban hot	热门电影
douban hot --tv	热门剧集（综合）
douban tv 美剧	分类剧集。可选：美剧、英剧、日剧、韩剧、国产剧
douban rank 科幻	类型排行。可选：科幻、动作、爱情、悬疑、喜剧、恐怖、动画等
douban top250	豆瓣 Top 250
douban now	正在热映。-c 上海 指定城市
douban coming	即将上映
douban weekly	一周口碑榜
douban search <关键词>	搜索电影
douban movie <id或片名>	电影详情。支持数字 ID 或片名（片名会自动搜索匹配）
douban comments <id>	热门短评。--latest 按时间排序
douban reviews <id>	热门影评
douban rating <id>	评分分布（星级柱状图）
douban celebrity <id>	影人详情（演员/导演）

书籍（无需登录）

命令	说明
douban book hot	热门书籍 Top 250
douban book search <关键词>	搜索书籍
douban book info <id>	书籍详情

用户与配置

命令	说明	需登录
douban user <userId>	查看用户片单	否
douban me	我的片单	是
douban config --user <id>	设置默认用户 ID	否

登录

命令	说明
douban login	登录（自动从浏览器提取 Cookie，支持 Chrome/Edge/Firefox/Safari）
douban whoami	查看当前登录用户
douban logout	退出登录

标记（需登录）

命令	说明
douban mark <id> --wish	标记想看
douban mark <id> --watched	标记看过
douban mark <id> --watching	标记在看
douban unmark <id>	取消标记
douban rate <id> --score <1-5>	评分（1-5 星）
douban comment <id> "评论内容"	发布短评
douban review <id> "标题" "正文"	发布长评

社交与统计（需登录）

命令	说明
douban feed	关注动态
douban stats --year 2024	年度观影统计
douban export -o records.csv -f csv	导出记录。格式：json（默认）/ csv
douban follow <userId>	关注用户
douban unfollow <userId>	取消关注

通用选项

选项	说明
--json	以 JSON 格式输出，便于程序处理
--limit N / -n N	控制返回数量
--start N / -s N	分页偏移（从 0 开始）
--delay <秒>	批量操作的请求间隔，避免触发反爬（默认随机 1-2 秒）

故障排除

问题	解决方式
"反爬挑战" 错误	豆瓣临时封禁，等几分钟后重试，或降低请求频率（加大 --delay）
"ck token" / 登录失效	通常会自动重试刷新。若仍失败，再运行 douban logout 然后 douban login
搜索无结果	尝试更短的关键词，或直接用豆瓣 ID
"未配置默认用户"	运行 douban login 或 douban config --user <id>
批量操作部分失败	检查输出的错误信息，常见原因：ID 不存在、评分不在 1-5 范围、重复标记