Coding
PromptBeginner5 minmarkdown
Markdown Converter
Agent skill for markdown-converter
21
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.
Sign in to like and favorite skills
Manage bookmarks via Raindrop.io REST API.
User must have
RAINDROP_TOKEN env var set. If not configured, instruct them to:
export RAINDROP_TOKEN="..." to ~/.zshrc.localAll requests require:
Authorization: Bearer $RAINDROP_TOKEN
https://api.raindrop.io/rest/v1/
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
| Action | Method | Endpoint |
|---|---|---|
| List root | GET | |
| List children | GET | |
| Get one | GET | |
| Create | POST | |
| Update | PUT | |
| Delete | DELETE | |
| Action | Method | Endpoint |
|---|---|---|
| List | GET | |
| Get one | GET | |
| Create | POST | |
| Update | PUT | |
| Delete | DELETE | |
| Search | GET | |
Special collection IDs:
0 = all, -1 = unsorted, -99 = trash
| Action | Method | Endpoint |
|---|---|---|
| List all | GET | |
| List in collection | GET | |
| Rename | PUT | |
| Delete | DELETE | |
| Action | Method | Endpoint |
|---|---|---|
| List all | GET | |
| In collection | GET | |
| Add/Update/Remove | PUT | |
Colors: blue, brown, cyan, gray, green, indigo, orange, pink, purple, red, teal, yellow
./scripts/raindrop.sh POST /raindrop '{ "link": "https://example.com", "collection": {"$id": 12345}, "tags": ["tag1", "tag2"], "pleaseParse": {} }'
./scripts/raindrop.sh GET '/raindrops/0?search=keyword&sort=-created'
Search operators:
#tag - by tagtype:article - by type (link, article, image, video, document, audio)domain:example.com - by domaincreated:>2024-01-01 - by dateimportant:true - favorites only./scripts/raindrop.sh POST /collection '{ "title": "My Collection", "public": false }'
./scripts/raindrop.sh PUT /raindrop/123 '{ "highlights": [{"text": "highlighted text", "color": "yellow", "note": "my note"}] }'
./scripts/raindrop.sh PUT /raindrops/0 '{ "ids": [1, 2, 3], "tags": ["new-tag"] }'
curl -s "https://api.raindrop.io/rest/v1/raindrops/{collectionId}/export.csv" \ -H "Authorization: Bearer $RAINDROP_TOKEN" > bookmarks.csv
Formats: csv, html, zip
120 requests/minute. Check headers:
X-RateLimit-Limit, RateLimit-Remaining, X-RateLimit-Reset
See references/API-REFERENCE.md for complete endpoint documentation.