douban-sync

Export Douban collections to per-user CSV files with RSS incremental syncing.

31|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/cosformula/douban-sync-skill --skill douban-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: douban-sync
Source: https://github.com/cosformula/douban-sync-skill/tree/main
Command: npx skills add https://github.com/cosformula/douban-sync-skill --skill douban-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires puppeteer-core, and includes scripts (resource) components.

What problem does it solve?

This tool eliminates the friction of manually exporting and organizing Douban data by converting your books, movies, music, and games into local CSV files that are easy to import into Obsidian, spreadsheets, or databases.

Core Features & Use Cases

  • Full export: scrape all items from your Douban collections across books, movies, music, and games into per-user CSV files.
  • Incremental sync: automatically pull new items via RSS and append them to existing CSVs without duplicates.
  • Flexible output: supports per-user directories, deduplication by URL, and CSV formatting suitable for Obsidian notes or data pipelines.
  • Multi-source access: works with HTTP scraping or browser-assisted scraping when login is required.

Quick Start

Set DOUBAN_USER and run the incremental RSS sync to keep your local exports up-to-date.

Frequently Asked Questions about douban-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export my Douban collections to CSV for local data archival?

You can export Douban collections to local CSV files by scraping all items across books, movies, music, and games. The tool outputs per-user CSVs with URL-based deduplication, making the data suitable for offline analysis or importing into spreadsheets.

Can I automatically sync new Douban items to my existing CSV exports?

Yes, you can automatically sync new Douban items via RSS incremental syncing. The tool pulls new items from RSS feeds and appends them to your existing CSV files without creating duplicates, keeping your local backups up-to-date.

Does Douban data export work with Obsidian notes and data pipelines?

Douban data export works with Obsidian notes and data pipelines by generating CSV files with flexible formatting. This allows you to directly import your archived books, movies, music, and games into Obsidian or use them in automated data workflows.

Do I need a browser to scrape Douban collections when login is required?

You need browser-assisted scraping using puppeteer-core when login is required to access your Douban collections. The tool supports multi-source access, allowing it to switch between HTTP scraping and browser-assisted scraping based on your authentication needs.

What environment setup is required to run incremental RSS sync for Douban data?

You need to set the DOUBAN_USER environment variable to run incremental RSS sync for Douban data. This environment configuration enables the tool to identify your account and safely handle network errors while pulling collection updates.

Why does my Douban collection export include duplicate entries?

Douban collection exports prevent duplicate entries by deduplicating items based on their URL. If duplicates appear, it may indicate a network error interrupted the sync process, which the tool is designed to handle safely without corrupting existing CSV data.