A robust tool to export and incrementally sync your Douban library to local CSV files for personal archiving or Obsidian integration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install douban-sync-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install douban-sync-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Douban Sync?
Douban Sync is a comprehensive data portability solution designed for users who want to maintain local control over their cultural consumption history. As part of the Openclaw Skills ecosystem, this tool allows you to bridge the gap between your Douban profile and your local knowledge management systems. It supports books, movies, music, and games, ensuring your ratings and reviews are never locked behind a single platform.
This skill provides two primary operational modes: a deep-dive full export using browser automation for initial setup, and a lightweight incremental sync via RSS for daily updates. By converting your Douban activity into standardized CSV files, it enables seamless integration with tools like Obsidian, allowing you to build a personal dashboard of everything you have watched, read, or played.
Douban Sync Use Cases
- Exporting years of Douban reading and watching history for local backup.
- Synchronizing new Douban ratings automatically to an Obsidian vault for personal knowledge management.
- Migrating Douban data to other platforms using standardized CSV formats.
- Creating a personal dashboard to visualize consumption habits over time.
How Douban Sync Works
- The skill identifies the target user via the DOUBAN_USER environment variable to locate the correct profile pages.
- During the initial export, a scraper navigates through paginated collection lists for books, movies, music, and games.
- The system implements a strategic rate-limiting mechanism with 2-3 second delays to ensure stable data retrieval without being blocked.
- For ongoing maintenance, an RSS-based sync script fetches recent activity without requiring active login sessions.
- The gathered data is parsed and deduplicated based on unique Douban URLs before being appended to categorized local CSV files.
Douban Sync Setup
To get started with this entry in your Openclaw Skills collection, you need to configure your Douban User ID.
# Set your Douban User ID
export DOUBAN_USER="your_user_id"
# Optional: Set custom output directory (defaults to ~/douban-sync)
export DOUBAN_OUTPUT_DIR="~/my-douban-data"
To run an incremental sync:
node scripts/douban-rss-sync.mjs
Douban Sync Data Schema & Taxonomy
The skill organizes data into four primary CSV files named by category. This structure is highly compatible with Obsidian and other markdown-based tools.
| File Name | Description |
|---|---|
| 书.csv | Book collection (Read, Reading, Wishlist) |
| 影视.csv | Movie/TV collection (Watched, Watching, Wishlist) |
| 音乐.csv | Music collection (Listened, Listening, Wishlist) |
| 游戏.csv | Game collection (Played, Playing, Wishlist) |
CSV Column Definitions:
- title: The name of the item.
- url: Permanent Douban link (primary key for deduplication).
- date: Completion or log date (YYYY-MM-DD).
- rating: Star rating representation.
- status: Localized status (e.g., 读过, 看过).
- comment: Your personal review or short notes.
Douban Sync Advanced Features
- Puppeteer CDP support for automated browser scraping to bypass basic bot detection mechanisms.
- Incremental RSS syncing allows for lightweight daily updates without performing full site crawls.
- Obsidian-compatible CSV formatting for instant integration into personal knowledge bases.
- Automatic deduplication logic ensures that running the scripts multiple times never creates redundant entries.
- Manual extraction script generation for environments where automated browser access is restricted.
SKILL.md
Loading
Related Openclaw Skills
Taildrop
A command-line utility for retrieving files from the Tailscale Taildrop inbox to local Linux storage.
Phone Voice Integration
A comprehensive integration that turns your Openclaw instance into a voice-activated phone assistant using ElevenLabs and Twilio.
UI Skills
A rigorous set of architectural constraints and design principles that guide AI agents in building accessible, performant, and visually consistent user interfaces.
Tencent Map API Integration
A comprehensive integration of Tencent Map Web Services for advanced location search, route planning, and coordinate transformations.
GitHub Star Manager
An AI-enhanced management tool for organizing, categorizing, and pruning GitHub stars using the GitHub CLI and GraphQL.
wakapi-sync
A synchronization tool that fetches daily WakaTime-compatible coding statistics from Wakapi and saves them as structured local CSV files.
METADATA
Featured*
