🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Raindrop Sync

by @zerone0x

Sync and process bookmarks from Raindrop.io. Use when fetching new bookmarks, analyzing saved content, or syncing bookmarks to knowledge base. Triggers on "r...

Versionv1.0.0
Downloads874
TERMINAL
clawhub install raindrop-sync

πŸ“– About This Skill


name: raindrop description: Sync and process bookmarks from Raindrop.io. Use when fetching new bookmarks, analyzing saved content, or syncing bookmarks to knowledge base. Triggers on "raindrop", "bookmarks", "sync bookmarks", "new saves".

Raindrop Bookmark Sync

Fetch bookmarks from Raindrop.io API and process them for knowledge base integration.

Setup

1. Get API token from https://app.raindrop.io/settings/integrations 2. Create test token (read-only is fine) 3. Save to .secrets/raindrop.env:

   RAINDROP_TOKEN=your_token_here
   

Usage

Fetch new bookmarks

source .secrets/raindrop.env
python3 skills/raindrop/scripts/fetch.py --since 24h

Fetch from specific collection

python3 skills/raindrop/scripts/fetch.py --collection 12345678

Process and add to knowledge base

python3 skills/raindrop/scripts/fetch.py --since 24h --output /tmp/raindrop-new.json

Then process each item with web_fetch and add to memory/knowledge-base.md

API Reference

  • Base URL: https://api.raindrop.io/rest/v1
  • Auth: Bearer token in header
  • Rate limit: 120 req/min
  • Key Endpoints

  • GET /raindrops/{collectionId} β€” List bookmarks (use 0 for all)
  • GET /collections β€” List collections
  • GET /raindrop/{id} β€” Single bookmark details
  • Bookmark Object

    {
      "_id": 123456,
      "title": "Article Title",
      "link": "https://example.com/article",
      "excerpt": "Short description...",
      "tags": ["tag1", "tag2"],
      "created": "2026-02-15T10:00:00Z",
      "collection": {"$id": 12345678}
    }
    

    Workflow

    1. Fetch β€” Get new bookmarks since last sync 2. Filter β€” Skip already-processed URLs (check memory/kb-index.json) 3. Extract β€” Use web_fetch to get content 4. Analyze β€” Summarize and tag 5. Store β€” Append to memory/knowledge-base.md 6. Update index β€” Add URL to memory/kb-index.json

    Cron Integration

    Add to heartbeat or cron for automatic sync:

    每倩检ζŸ₯一欑 Raindrop ζ–°δΉ¦η­ΎοΌŒε€„η†εŽε­˜ε…₯ηŸ₯θ―†εΊ“
    

    πŸ’‘ Examples

    Fetch new bookmarks

    source .secrets/raindrop.env
    python3 skills/raindrop/scripts/fetch.py --since 24h
    

    Fetch from specific collection

    python3 skills/raindrop/scripts/fetch.py --collection 12345678
    

    Process and add to knowledge base

    python3 skills/raindrop/scripts/fetch.py --since 24h --output /tmp/raindrop-new.json
    

    Then process each item with web_fetch and add to memory/knowledge-base.md

    βš™οΈ Configuration

    1. Get API token from https://app.raindrop.io/settings/integrations 2. Create test token (read-only is fine) 3. Save to .secrets/raindrop.env:

       RAINDROP_TOKEN=your_token_here