# Douban Marks

> 只读查询豆瓣电影、图书、音乐标记列表和电影条目联想。用于读取用户自己的已看、想看、在看等标记；公开主页可直接读，私密列表需要本机环境或 .env 中的 DOUBAN_COOKIE。禁止用于批量采集、绕登录、写入标记或读取非授权账号。

- Skill: `uvwt/douban-marks` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add uvwt/douban-marks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uvwt/douban-marks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: uvwt (https://skillmd.com/u/uvwt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/uvwt/douban-marks

---


# 豆瓣标记

用于只读查询豆瓣标记数据。

## 能力边界

- 读取操作只读；写入操作必须显式要求并默认 `dry_run=true`。
- 不接收明文 cookie 参数；如需登录态，使用 `DOUBAN_COOKIE` 环境变量或本地 `.env`。
- 默认读取公开主页；如果列表私密，必须是用户自己的登录态。
- 不用于批量采集、绕反爬、抓取非授权账号或高频同步。
- 写入只允许操作用户自己的账号；真实提交必须提供 `DOUBAN_COOKIE`、`dry_run=false` 和 `confirm=true`。

## 常用操作

- `movie-suggest`: 搜索电影候选。
- `movie-watched`: 读取电影已看。
- `movie-wish`: 读取电影想看。
- `movie-doing`: 读取电影在看。
- `marks`: 通用读取，`category` 为 `movie`、`book`、`music`，`status` 为 `collect`、`wish`、`do`。
- `status`: 检查网页接口可达性，以及是否配置了 `DOUBAN_USER_ID`、`DOUBAN_COOKIE`。
- `movie-interest-status`: 用登录态检查电影条目标记弹窗。
- `movie-mark-wish`: 标记想看。
- `movie-mark-doing`: 标记在看。
- `movie-mark-watched`: 标记看过，可附带 1-5 星评分。
- `movie-rate`: 提交看过并评分。

## 配置

可在 AgentDock 环境或本地 `.env` 设置：

```text
DOUBAN_USER_ID=你的豆瓣用户 ID
DOUBAN_COOKIE=bid=...; dbcl2=...; ck=...
```

`DOUBAN_COOKIE` 只用于请求头，不会出现在输出里。

## 辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

```bash
printf '%s' '{"skill_action":"<动作>"}' | python3 run.py
```

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 |
|---|---|
| `status` | 检查豆瓣网页接口可达性，以及本地是否配置了 DOUBAN_USER_ID 和 DOUBAN_COOKIE。 |
| `movie-suggest` | 查询豆瓣电影联想候选，返回标题、年份、豆瓣 ID、类型、海报和 URL。 |
| `marks` | 读取豆瓣用户标记列表。category 支持 movie/book/music；status 支持 collect/wish/do。默认从 DOUBAN_USER_ID 取用户 ID。 |
| `movie-watched` | 读取电影已看列表，等价于 marks(category=movie,status=collect)。 |
| `movie-wish` | 读取电影想看列表，等价于 marks(category=movie,status=wish)。 |
| `movie-doing` | 读取电影在看列表，等价于 marks(category=movie,status=do)。 |
| `movie-interest-status` | 用登录态读取电影条目标记弹窗，检查是否能提取当前兴趣状态。需要 DOUBAN_COOKIE。 |
| `movie-mark-wish` | 将电影标记为想看。默认 dry_run=true；真实写入必须 dry_run=false 且 confirm=true，并需要 DOUBAN_COOKIE。 |
| `movie-mark-doing` | 将电影标记为在看。默认 dry_run=true；真实写入必须 dry_run=false 且 confirm=true，并需要 DOUBAN_COOKIE。 |
| `movie-mark-watched` | 将电影标记为看过，可附带 1-5 星评分。默认 dry_run=true；真实写入必须 dry_run=false 且 confirm=true，并需要 DOUBAN_COOKIE。 |
| `movie-rate` | 给电影评分；本质上提交看过 collect + rating。默认 dry_run=true；真实写入必须 dry_run=false 且 confirm=true，并需要 DOUBAN_COOKIE。 |