douban-skill

1# Douban Collection Export
2 
3Export Douban user collections (books, movies, music, games) to CSV files.
4Douban has no official data export; the official API shut down in 2018.
5 
6## What This Skill Can Do
7 
8- Full export of all book/movie/music/game collections via Frodo API
9- RSS incremental sync for daily updates (last ~10 items)
10- CSV output with UTF-8 BOM (Excel-compatible), cross-platform (macOS/Windows/Linux)
11- No login, no cookies, no browser required
12- Pre-flight user ID validation (fail fast on wrong ID)
13 
14## What This Skill Cannot Do
15 
16- Cannot export reviews (长评), notes (读书笔记), or broadcasts (广播)
17- Cannot filter by single category in one run (exports all 4 types together)
18- Cannot access private profiles (returns 0 items silently)
19 
20## Why Frodo API (Do NOT Use Web Scraping)
21 
22Douban uses PoW (Proof of Work) challenges on web pages, blocking all HTTP scraping.
23We tested 7 approaches — only the Frodo API works. **Do NOT attempt** web scraping,
24`browser_cookie3`+`requests`, `curl` with cookies, or Jina Reader.
25 
26See [references/troubleshooting.md](references/troubleshooting.md) for the complete
27failure log of all 7 tested approaches and why each failed.
28 
29## Security & Privacy
30 
31The API key and HMAC secret in the script are Douban's **public mobile app credentials**,
32extracted from the APK. They are shared by all Douban app users and do not identify you.
33No personal credentials are used or stored. Data is fetched only from `frodo.douban.com`.
34 
35## Full Export (Primary Method)
36…