douban-sync

What This Skill Does

The douban-sync skill is a robust tool designed to help users bridge the gap between their digital collections on Douban and their local file systems. Whether you are an avid reader, movie enthusiast, or gamer, this skill allows you to export your entire history of ratings, comments, and statuses into structured CSV files. These files are optimized for integration with personal knowledge management systems like Obsidian, enabling you to build a local library of your cultural consumption. The skill supports both a one-time full export via browser automation and a lightweight, automated incremental sync using RSS feeds, ensuring your records remain up-to-date without constant manual intervention.

Installation

To install this skill, use the OpenClaw CLI in your terminal: clawhub install openclaw/skills/skills/cosformula/douban-sync-skill After installation, ensure you have the necessary environment variables configured, specifically your DOUBAN_USER ID. If you intend to use the browser-based scraping mode, ensure your environment supports Puppeteer/CDP-enabled browser instances.

Use Cases

• Personal Archiving: Create a permanent, offline backup of your Douban history to protect against platform data loss or censorship.
• Knowledge Management: Link your reading list directly to your Obsidian vault, using CSV imports to track your 'to-read' pile or archive your finished books.
• Portfolio Building: Export your movie or music ratings to share as a structured document or data visualization project.
• Daily Tracking: Maintain an automated daily log of newly watched movies or finished games using the RSS sync feature.

Example Prompts

1. "OpenClaw, please perform a full export of all my Douban book and movie collections to my local directory."
2. "I want to keep my game collection updated daily. Can you set up an incremental sync for my Douban profile using the RSS method?"
3. "Export my current 'Want to Read' list from Douban and save it as a CSV file in my Documents folder."

Tips & Limitations

• Rate Limiting: Douban is strict regarding automated requests. Always respect the 2-3 second delay between pages. If you encounter errors, wait at least 30 seconds before retrying.
• Deduplication: The tool intelligently uses the Douban URL as a primary key, meaning you can safely run the sync scripts repeatedly without creating duplicate entries in your CSV files.
• Login Status: Full exports via browser-automation require you to be actively logged into Douban in your browser. If the scraper fails, check your login session first.
• Manual Extraction: For users behind restrictive firewalls or those who prefer security, use the douban-extract.mjs script to generate a console script you can run manually within your browser’s developer tools.