OpenSkillIndex← back to search
claude-codeautomation

Claude-skill-registry raindrop

Manage Raindrop.io bookmarks, collections, tags, and highlights via API. Use when user mentions raindrop, bookmarks, saving links, organizing URLs, bookmark collections, or web highlights.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/raindrop" ~/.claude/skills/majiayu000-claude-skill-registry-raindrop && rm -rf "$T"
manifest: skills/data/raindrop/SKILL.md
tags
#raindrop-io#bookmark-management#api-integration#collection-organization#highlight-annotation
safety · automated scan (low risk)
This is a pattern-based risk scan, not a security review. Our crawler flagged:
  • makes HTTP requests (curl)
Always read a skill's source content before installing. Patterns alone don't mean the skill is malicious — but they warrant attention.
source content

Raindrop.io API Skill

Manage bookmarks via Raindrop.io REST API.

Prerequisites

User must have 

RAINDROP_TOKEN
env var set. If not configured, instruct them to:

  1. Create app at https://app.raindrop.io/settings/integrations
  2. Generate test token
  3. Add 
    export RAINDROP_TOKEN="..."
    to 
    ~/.zshrc.local

Authentication

All requests require:

Authorization: Bearer $RAINDROP_TOKEN

Base URL

https://api.raindrop.io/rest/v1/

Helper Script

Use 

scripts/raindrop.sh
for API calls:

./scripts/raindrop.sh GET /collections
./scripts/raindrop.sh POST /raindrop '{"link":"https://example.com","pleaseParse":{}}'
./scripts/raindrop.sh PUT /raindrop/123 '{"tags":["new-tag"]}'
./scripts/raindrop.sh DELETE /raindrop/123

Quick Reference

Collections

ActionMethodEndpoint
List rootGET
/collections
List childrenGET
/collections/childrens
Get oneGET
/collection/{id}
CreatePOST
/collection
UpdatePUT
/collection/{id}
DeleteDELETE
/collection/{id}

Raindrops (Bookmarks)

ActionMethodEndpoint
ListGET
/raindrops/{collectionId}
Get oneGET
/raindrop/{id}
CreatePOST
/raindrop
UpdatePUT
/raindrop/{id}
DeleteDELETE
/raindrop/{id}
SearchGET
/raindrops/0?search=...

Special collection IDs: 

0
= all, 
-1
= unsorted, 
-99
= trash

Tags

ActionMethodEndpoint
List allGET
/tags
List in collectionGET
/tags/{collectionId}
RenamePUT
/tags/{collectionId}
DeleteDELETE
/tags/{collectionId}

Highlights

ActionMethodEndpoint
List allGET
/highlights
In collectionGET
/highlights/{collectionId}
Add/Update/RemovePUT
/raindrop/{id}

Colors: blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal, yellow

Common Operations

Create bookmark with auto-parse

./scripts/raindrop.sh POST /raindrop '{
  "link": "https://example.com",
  "collection": {"$id": 12345},
  "tags": ["tag1", "tag2"],
  "pleaseParse": {}
}'

Search bookmarks

./scripts/raindrop.sh GET '/raindrops/0?search=keyword&sort=-created'

Search operators:

  • #tag
    - by tag
  • type:article
    - by type (link, article, image, video, document, audio)
  • domain:example.com
    - by domain
  • created:>2024-01-01
    - by date
  • important:true
    - favorites only

Create collection

./scripts/raindrop.sh POST /collection '{
  "title": "My Collection",
  "public": false
}'

Add highlight to bookmark

./scripts/raindrop.sh PUT /raindrop/123 '{
  "highlights": [{"text": "highlighted text", "color": "yellow", "note": "my note"}]
}'

Bulk tag bookmarks

./scripts/raindrop.sh PUT /raindrops/0 '{
  "ids": [1, 2, 3],
  "tags": ["new-tag"]
}'

Export collection

curl -s "https://api.raindrop.io/rest/v1/raindrops/{collectionId}/export.csv" \
  -H "Authorization: Bearer $RAINDROP_TOKEN" > bookmarks.csv

Formats: csv, html, zip

Rate Limits

120 requests/minute. Check headers: 

X-RateLimit-Limit
, 
RateLimit-Remaining
, 
X-RateLimit-Reset

Detailed Reference

See references/API-REFERENCE.md for complete endpoint documentation.