douban-skill

Other Community

Repo stars 0
Author updated Aug 24, 2026, 03:33 PM
Author repo claude-code-skills

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: > Export Douban user collections (books, movies, music, games) to CSV files. Douban has no official data export; the official AP…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “What This Skill Can Do”, “What This Skill Cannot Do”, “Why Frodo API (Do NOT Use Web Scraping)”, “Security & Privacy”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name douban-skill directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “What This Skill Can Do / What This Skill Cannot Do / Why Frodo API (Do NOT Use Web Scraping)” before expanding.

Boundaries And Review

Dependencies: Prepare Vendor-specific API keys before running a full task.
Permissions: Declared permissions include read / env-read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Douban Collection Export

Export Douban user collections (books, movies, music, games) to CSV files. Douban has no official data export; the official API shut down in 2018.

What This Skill Can Do

Full export of all book/movie/music/game collections via Frodo API
RSS incremental sync for daily updates (last ~10 items)
CSV output with UTF-8 BOM (Excel-compatible), cross-platform (macOS/Windows/Linux)
No login, no cookies, no browser required
Pre-flight user ID validation (fail fast on wrong ID)

What This Skill Cannot Do

Cannot export reviews (长评), notes (读书笔记), or broadcasts (广播)
Cannot filter by single category in one run (exports all 4 types together)
Cannot access private profiles (returns 0 items silently)

Why Frodo API (Do NOT Use Web Scraping)

Douban uses PoW (Proof of Work) challenges on web pages, blocking all HTTP scraping. We tested 7 approaches — only the Frodo API works. Do NOT attempt web scraping, browser_cookie3+requests, curl with cookies, or Jina Reader.

See references/troubleshooting.md for the complete failure log of all 7 tested approaches and why each failed.

Security & Privacy

The API key and HMAC secret in the script are Douban's public mobile app credentials, extracted from the APK. They are shared by all Douban app users and do not identify you. No personal credentials are used or stored. Data is fetched only from frodo.douban.com.

Full Export (Primary Method)

DOUBAN_USER=<user_id> python3 scripts/douban-frodo-export.py

Finding the user ID: Profile URL douban.com/people/<ID>/ — the ID is after /people/. If the user provides a full URL, the script auto-extracts the ID.

Environment variables:

DOUBAN_USER (required): Douban user ID (alphanumeric or numeric, or full profile URL)
DOUBAN_OUTPUT_DIR (optional): Override output directory

Default output (auto-detected per platform):

macOS: ~/Downloads/douban-sync/<user_id>/
Windows: %USERPROFILE%\Downloads\douban-sync\<user_id>\
Linux: ~/Downloads/douban-sync/<user_id>/

Dependencies: Python 3.6+ standard library only (works with python3 or uv run).

Example console output:

Douban Export for user: your_douban_id
Output directory: /Users/you/Downloads/douban-sync/your_douban_id

=== 读过 (book) ===
  Total: 639
  Fetched 0-50 (50/639)
  Fetched 50-100 (100/639)
  ...
  Fetched 597-639 (639/639)
  Collected: 639

=== 在读 (book) ===
  Total: 75
  ...

--- Writing CSV files ---
  书.csv: 996 rows
  影视.csv: 238 rows
  音乐.csv: 0 rows
  游戏.csv: 0 rows

Done! 1234 total items exported to /Users/you/Downloads/douban-sync/your_douban_id

RSS Incremental Sync (Complementary)

DOUBAN_USER=<user_id> node scripts/douban-rss-sync.mjs

RSS returns only the latest ~10 items (no pagination). Use Full Export first, then RSS for daily updates.

Output Format

Four CSV files per user:

Downloads/douban-sync/<user_id>/
├── 书.csv      (读过 + 在读 + 想读)
├── 影视.csv    (看过 + 在看 + 想看)
├── 音乐.csv    (听过 + 在听 + 想听)
└── 游戏.csv    (玩过 + 在玩 + 想玩)

Columns: title, url, date, rating, status, comment

rating: ★ to ★★★★★ (empty if unrated)
date: YYYY-MM-DD (when the user marked it)
Safe to run multiple times (overwrites with fresh data)
Row counts may be slightly below Douban's displayed count due to delisted items

Workflow

Ask for Douban user ID (from profile URL, or accept full URL)
Run: DOUBAN_USER=<id> python3 scripts/douban-frodo-export.py
Verify: row counts in console output should match, check with wc -l <output_dir>/*.csv
(Optional) Set up RSS sync for daily incremental updates

Troubleshooting

See references/troubleshooting.md for:

Frodo API auth details (HMAC-SHA1 signature computation)
Common errors (code 996 signature error, rate limits, pagination quirks)
Complete failure log of all 7 tested approaches with root causes
Alternative approaches (豆伴 extension, Tampermonkey script, browser console)
API endpoint reference with response format

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @daymade · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: Required · Vendor-specific
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Node.js · Python >=3.6
Detected file/system behavior: Read-only
Env read
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview douban-skill.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Douban Collection Export

Export Douban user collections (books, movies, music, games) to CSV files.
Douban has no official data export; the official API shut down in 2018.

## What This Skill Can Do

- Full export of all book/movie/music/game collections via Frodo API
- RSS incremental sync for daily updates (last ~10 items)
- CSV output with UTF-8 BOM (Excel-compatible), cross-platform (macOS/Windows/Linux)
- No login, no cookies, no browser required
- Pre-flight user ID validation (fail fast on wrong ID)

## What This Skill Cannot Do

- Cannot export reviews (长评), notes (读书笔记), or broadcasts (广播)
- Cannot filter by single category in one run (exports all 4 types together)
- Cannot access private profiles (returns 0 items silently)

## Why Frodo API (Do NOT Use Web Scraping)

Douban uses PoW (Proof of Work) challenges on web pages, blocking all HTTP scraping.
We tested 7 approaches — only the Frodo API works. **Do NOT attempt** web scraping,
`browser_cookie3`+`requests`, `curl` with cookies, or Jina Reader.

See [references/troubleshooting.md](references/troubleshooting.md) for the complete
failure log of all 7 tested approaches and why each failed.

## Security & Privacy

The API key and HMAC secret in the script are Douban's **public mobile app credentials**,
extracted from the APK. They are shared by all Douban app users and do not identify you.
No personal credentials are used or stored. Data is fetched only from `frodo.douban.com`.

## Full Export (Primary Method)

```bash
DOUBAN_USER=<user_id> python3 scripts/douban-frodo-export.py
```

**Finding the user ID:** Profile URL `douban.com/people/<ID>/` — the ID is after `/people/`.
If the user provides a full URL, the script auto-extracts the ID.

**Environment variables:**

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> What This Skill Can Do → What This Skill Cannot Do → Why Frodo API (Do NOT Use Web Scraping) → Security & Privacy → Full Export (Primary Method) → RSS Incremental Sync (Complementary)
terms    -> Do NOT attempt · public mobile app credentials · Finding the user ID · Environment variables · Default output · Dependencies · Example console output
files/cmd -> browsercookie3 · requests · curl · frodo.douban.com · douban.com/people/<ID>/ · /people/ · DOUBANUSER · DOUBANOUTPUTDIR
body sha256 -> 57c71dd2a772