raindrop - SKILL.md Agent 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

Get API token from https://app.raindrop.io/settings/integrations
Create test token (read-only is fine)
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

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

Cron Integration

Add to heartbeat or cron for automatic sync:


每天检查一次 Raindrop 新书签，处理后存入知识库