Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
daymade avatar

Douban Skill

  • 511 installs
  • 1.3k repo stars
  • Updated August 4, 2026
  • daymade/claude-code-skills

douban-skill is a Claude Code skill that fetches Douban book, film, and rating data and automates publishing workflows referencing Chinese media catalogs for developers building content apps, bots, or research agents.

About

douban-skill is a Claude Code skill for integrating Douban media metadata into software projects. It helps developers retrieve book and film listings, ratings, and related catalog fields, then wire that data into content apps, chatbots, or research agents that reference Chinese-language media libraries. The skill supports automated publishing workflows that cite Douban sources correctly inside generated content. Use it when building recommendation features, media review bots, or catalog-backed research tools that need Douban as a data source. It assumes API or scraping patterns appropriate to Douban rather than generic REST boilerplate.

  • Douban API endpoints and auth patterns
  • Book and movie metadata normalization
  • Rating and review field mapping
  • Rate-limit aware fetch strategies
  • Agent-friendly structured output shapes

Douban Skill by the numbers

  • 511 all-time installs (skills.sh)
  • Ranked #414 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/daymade/claude-code-skills --skill douban-skill

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs511
repo stars1.3k
Last updatedAugust 4, 2026
Repositorydaymade/claude-code-skills

How do you integrate Douban book and film data into an app?

Fetch Douban book, film, and rating data or automate publishing workflows that reference Chinese media catalogs inside content apps, bots, or research agents.

Who is it for?

Developers building Chinese-language media apps, review bots, or research agents that need Douban catalog and rating data.

Skip if: Projects with no Douban dependency or teams needing Western catalog APIs like TMDB or Open Library instead.

When should I use this skill?

A developer asks to fetch Douban ratings, integrate Chinese film or book catalogs, or automate content publishing that references Douban metadata.

What you get

Douban API integration code, fetched catalog records, and publishing workflow steps referencing Chinese media metadata.

Files

SKILL.mdMarkdownGitHub ↗

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

1. Ask for Douban user ID (from profile URL, or accept full URL) 2. Run: DOUBAN_USER=<id> python3 scripts/douban-frodo-export.py 3. Verify: row counts in console output should match, check with wc -l <output_dir>/*.csv 4. (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

Related skills

FAQ

What data can douban-skill retrieve?

douban-skill retrieves Douban book listings, film entries, and rating data. Developers use it to populate content apps, bots, and research agents that reference Chinese media catalogs.

Is douban-skill only for read-only fetching?

douban-skill covers both fetching Douban catalog data and automating publishing workflows that reference that metadata. It supports end-to-end content pipelines, not just one-off API calls.

Automation & Workflowsintegrationsbackend

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.