douban

name	douban
description	豆瓣电影、图书查询与个人书单/影单管理。当用户提到豆瓣、想看/在看/看过、书单、影单、电影评分、图书评分、Top250、豆列时使用。

豆瓣 Skill (douban-mcp CLI)

触发场景

用户说	该用
"豆瓣上 XX 评分多少？"	search-movie 找 id → get-movie 看详情
"我想看的电影里有哪些科幻？"	user-collections --status wish
"把 XX 标为看过 5 星"	mark-movie --status collect --rating 5
"Top250 第一页"	movie-chart --kind top250
"三体的评分多少"	search-book → get-book

工作流

1. 搜索 → 详情

douban-mcp-cli --json search-movie --q "盗梦空间" --count 1 \
  | jq -r '.[0].id' \
  | xargs -I{} douban-mcp-cli get-movie --id {}

2. 我的待看清单

douban-mcp-cli --json user-collections --uid <your-uid> --category movie --status wish

如未配 cookie 或无 uid 报 AUTH_FAILED，提示用户：

• 设置 DOUBAN_COOKIE 环境变量后 uid 可省略
• 或显式传 --uid <id>

3. 批量标记（需写权限）

douban-mcp-cli --json user-collections --category movie --status wish \
  | jq -r '.[] | select(.subject.rating > 8) | .subject.id' \
  | xargs -I{} douban-mcp-cli mark-movie --id {} --status collect --rating 5

需 DOUBAN_COOKIE + DOUBAN_ENABLE_WRITE=true。

错误处理

Exit	含义	Agent 应该
0	成功	继续
1	AUTH_FAILED / WRITE_DISABLED	提示用户更新 cookie 或开启 enable_write
2	NOT_FOUND	报告 id 不存在
3	RATE_LIMITED	等 60s 重试
4	PARSE_FAILED / NETWORK / UNKNOWN	重试一次；仍失败则报告

配置前置条件

• 安装：npm i -g douban-mcp-cli 或 npx douban-mcp-cli
• 写操作：export DOUBAN_COOKIE=...; export DOUBAN_ENABLE_WRITE=true

可用命令（自动生成，勿手改）

命令	说明
check	验证 DOUBAN_COOKIE 是否仍然有效
search-movie	按关键词搜索豆瓣电影。返回标题/年份/评分/链接的 markdown 列表。
get-movie	获取一部电影的详细信息（导演、演员、评分、简介等）。id 是豆瓣电影 subject id（数字）。
list-movie-reviews	获取一部电影的短评列表（不含长评）。
movie-chart	获取电影榜单。kind: top250 (Top250)、weekly (一周口碑榜)、new (近期上映)。
search-book	按关键词搜索豆瓣图书。
get-book	获取图书详情（作者、出版、ISBN、简介等）。id 是豆瓣图书 subject id（数字）。
list-book-reviews	获取图书的短评列表。
book-chart	获取图书榜单。kind: fiction (小说)、non_fiction (随笔)、new (新书速递)。
user-collections	获取某用户的"想看/在看/看过"列表。无 cookie 时必须传 uid。
user-doulist	获取某用户的豆列清单。无 cookie 时必须传 uid。
user-profile	获取某用户的基本信息。无 cookie 时必须传 uid。
mark-movie	标记一部电影（想看/在看/看过），可选打分、备注、标签。需要 cookie + DOUBAN_ENABLE_WRITE。shareToFeed 默认 false（不广播）。
unmark-movie	取消对一部电影的标记。
mark-book	标记一本书（想看/在看/看过），可选打分、备注、标签。需要 cookie + DOUBAN_ENABLE_WRITE。shareToFeed 默认 false（不广播）。
unmark-book	取消对一本书的标记。