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.

7 stars

Best use case

raindrop is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using raindrop should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

How raindrop Compares

Feature / AgentraindropStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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:
```bash
./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

| Action | Method | Endpoint |
|--------|--------|----------|
| List root | GET | `/collections` |
| List children | GET | `/collections/childrens` |
| Get one | GET | `/collection/{id}` |
| Create | POST | `/collection` |
| Update | PUT | `/collection/{id}` |
| Delete | DELETE | `/collection/{id}` |

### Raindrops (Bookmarks)

| Action | Method | Endpoint |
|--------|--------|----------|
| List | GET | `/raindrops/{collectionId}` |
| Get one | GET | `/raindrop/{id}` |
| Create | POST | `/raindrop` |
| Update | PUT | `/raindrop/{id}` |
| Delete | DELETE | `/raindrop/{id}` |
| Search | GET | `/raindrops/0?search=...` |

Special collection IDs: `0` = all, `-1` = unsorted, `-99` = trash

### Tags

| Action | Method | Endpoint |
|--------|--------|----------|
| List all | GET | `/tags` |
| List in collection | GET | `/tags/{collectionId}` |
| Rename | PUT | `/tags/{collectionId}` |
| Delete | DELETE | `/tags/{collectionId}` |

### Highlights

| Action | Method | Endpoint |
|--------|--------|----------|
| List all | GET | `/highlights` |
| In collection | GET | `/highlights/{collectionId}` |
| Add/Update/Remove | PUT | `/raindrop/{id}` |

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

## Common Operations

### Create bookmark with auto-parse

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

### Search bookmarks

```bash
./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

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

### Add highlight to bookmark

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

### Bulk tag bookmarks

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

### Export collection

```bash
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](references/API-REFERENCE.md) for complete endpoint documentation.

Related Skills

raindrop-io

242
from aiskillstore/marketplace

Manage Raindrop.io bookmarks with AI assistance. Save and organize bookmarks, search your collection, manage reading lists, and organize research materials. Use when working with bookmarks, web research, reading lists, or when user mentions Raindrop.io.

Data & Research

raindrop-cli

3891
from openclaw/skills

Manage Raindrop.io bookmarks from the command line (search, exists, add, update, remove) using the Raindrop REST API. Use when automating bookmark capture and organization with a personal RAINDROP_TOKEN.

raindrop-api

25
from ComeOnOliver/skillshub

This skill provides comprehensive instructions for interacting with the Raindrop.io bookmarks service via its REST API using curl and jq. It covers authentication, CRUD operations for collections, raindrops (bookmarks), tags, highlights, filters, import/export, and backups. Use this skill whenever the user asks to work with their bookmarks from Raindrop.io, including reading, creating, updating, deleting, searching, or organising bookmarks and collections.

raindrop-io

25
from ComeOnOliver/skillshub

Manage Raindrop.io bookmarks with AI assistance. Save and organize bookmarks, search your collection, manage reading lists, and organize research materials. Use when working with bookmarks, web research, reading lists, or when user mentions Raindrop.io.

workspace-surface-audit

144923
from affaan-m/everything-claude-code

Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows. Use when the user wants help setting up Claude Code or understanding what capabilities are actually available in their environment.

DevelopmentClaude

ui-demo

144923
from affaan-m/everything-claude-code

Record polished UI demo videos using Playwright. Use when the user asks to create a demo, walkthrough, screen recording, or tutorial video of a web application. Produces WebM videos with visible cursor, natural pacing, and professional feel.

Developer ToolsClaude

token-budget-advisor

144923
from affaan-m/everything-claude-code

Offers the user an informed choice about how much response depth to consume before answering. Use this skill when the user explicitly wants to control response length, depth, or token budget. TRIGGER when: "token budget", "token count", "token usage", "token limit", "response length", "answer depth", "short version", "brief answer", "detailed answer", "exhaustive answer", "respuesta corta vs larga", "cuántos tokens", "ahorrar tokens", "responde al 50%", "dame la versión corta", "quiero controlar cuánto usas", or clear variants where the user is explicitly asking to control answer size or depth. DO NOT TRIGGER when: user has already specified a level in the current session (maintain it), the request is clearly a one-word answer, or "token" refers to auth/session/payment tokens rather than response size.

Productivity & Content CreationClaude

skill-comply

144923
from affaan-m/everything-claude-code

Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines

DevelopmentClaude

santa-method

144923
from affaan-m/everything-claude-code

Multi-agent adversarial verification with convergence loop. Two independent review agents must both pass before output ships.

Quality AssuranceClaude

safety-guard

144923
from affaan-m/everything-claude-code

Use this skill to prevent destructive operations when working on production systems or running agents autonomously.

DevelopmentClaude

repo-scan

144923
from affaan-m/everything-claude-code

Cross-stack source code asset audit — classifies every file, detects embedded third-party libraries, and delivers actionable four-level verdicts per module with interactive HTML reports.

DevelopmentClaude

project-flow-ops

144923
from affaan-m/everything-claude-code

Operate execution flow across GitHub and Linear by triaging issues and pull requests, linking active work, and keeping GitHub public-facing while Linear remains the internal execution layer. Use when the user wants backlog control, PR triage, or GitHub-to-Linear coordination.

DevelopmentClaude