raindropSearch, list, and manage Raindrop.io bookmarks via CLI. Use when the user wants to find saved links, browse collections, add new bookmarks, organize with tag...
Install via ClawdBot CLI:
clawdbot install velvet-shark/raindropManage bookmarks via the Raindrop.io API.
# Get token from: https://app.raindrop.io/settings/integrations → "Create test token"
echo 'RAINDROP_TOKEN="your-token"' > ~/.config/raindrop.env
# Or pass token at runtime (recommended for ephemeral use)
{baseDir}/scripts/raindrop.sh --token "your-token" whoami# Search bookmarks
{baseDir}/scripts/raindrop.sh search "AI tools"
# List unsorted bookmarks
{baseDir}/scripts/raindrop.sh list -1 --limit 50
# Count unsorted
{baseDir}/scripts/raindrop.sh count -1
# Create collection and move bookmarks
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
{baseDir}/scripts/raindrop.sh move 12345 66016720
# Bulk move (efficient!)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789" 66016720| Command | Description |
|---------|-------------|
| whoami | Show authenticated user |
| collections | List all collections with IDs |
| list [ID] | List bookmarks (default: 0 = all) |
| count [ID] | Count bookmarks in collection |
| search QUERY [ID] | Search bookmarks |
| get ID | Get bookmark details |
| tags | List all tags with counts |
| list-untagged [ID] | Find bookmarks without tags |
| cache ID | Get permanent copy (Pro only) |
| Command | Description |
|---------|-------------|
| add URL [ID] | Add bookmark (default: -1 = Unsorted) |
| delete ID | Delete bookmark |
| create-collection NAME | Create new collection |
| move ID COLLECTION | Move bookmark to collection |
| update ID [opts] | Update tags/title/collection |
| bulk-move IDS TARGET [SOURCE] | Move multiple bookmarks (source defaults to -1/Unsorted) |
| suggest URL | Get AI-suggested tags/title |
| Flag | Description |
|------|-------------|
| --json | Raw JSON output |
| --limit N | Max results (default: 25) |
| --page N | Pagination (0-indexed) |
| --delay MS | Delay between API calls (rate limiting) |
| --token TOKEN | Override API token |
For the update command:
| Flag | Description |
|------|-------------|
| --tags TAG1,TAG2 | Set tags (comma-separated) |
| --title TITLE | Set title |
| --collection ID | Move to collection |
0 = All bookmarks-1 = Unsorted-99 = TrashN = Specific collection (get IDs from collections)# List unsorted with pagination
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 0
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 1
# Create collection
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
# Output: Created: AI Coding / ID: 66016720
# Move single bookmark
{baseDir}/scripts/raindrop.sh move 1234567 66016720
# Update bookmark with tags and move
{baseDir}/scripts/raindrop.sh update 1234567 --tags "claude-code,workflow,tips" --collection 66016720
# Bulk move with rate limiting (100ms between calls)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789,101112" 66016720 --delay 100
# Find untagged bookmarks in unsorted
{baseDir}/scripts/raindrop.sh list-untagged -1 --limit 100
# Get JSON for scripting
{baseDir}/scripts/raindrop.sh list -1 --json --limit 50 | jq '.items[]._id'
# Count unsorted bookmarks
{baseDir}/scripts/raindrop.sh count -1For large batch operations, use bulk-move which uses the Raindrop batch API (up to 100 items per request):
# Get IDs from unsorted
ids=$({baseDir}/scripts/raindrop.sh list -1 --json --limit 100 | jq -r '[.items[]._id] | join(",")')
# Move all to collection
{baseDir}/scripts/raindrop.sh bulk-move "$ids" 66016720Raindrop API has rate limits. For bulk operations:
--delay 100 (100ms between calls)bulk-move instead of individual move callsFor operations not covered:
source ~/.config/raindrop.env
# Update tags
curl -X PUT "https://api.raindrop.io/rest/v1/raindrop/ID" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tags": ["tag1", "tag2"]}'
# Bulk update (up to 100 IDs)
curl -X PUT "https://api.raindrop.io/rest/v1/raindrops" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ids": [123, 456, 789], "collectionId": 12345}'API docs: https://developer.raindrop.io/
Generated Mar 1, 2026
Digital marketers use the skill to organize and search saved articles, competitor links, and campaign resources across collections. They can bulk-move bookmarks into thematic folders like 'SEO Trends' or 'Social Media Ideas' for efficient content planning and retrieval.
Researchers and students employ the skill to catalog academic papers, online references, and study materials by tagging them with topics like 'machine-learning' or 'climate-change'. They use search and list-untagged features to maintain a clean, queryable library for literature reviews.
Developers integrate the skill into scripts to automatically add bookmarks from tools like GitHub or Stack Overflow, then organize them into collections like 'Code Snippets' or 'API Docs'. They leverage bulk operations and JSON output for seamless automation with other CLI tools.
Professionals in fields like consulting or design use the skill to manage saved links for projects, tagging them with client names or deadlines. They quickly move bookmarks between collections as projects evolve and use AI-suggested tags to enhance organization.
Offer a basic version of the skill for free to attract users, then charge for advanced features like bulk operations, AI suggestions, or enhanced rate limiting. Revenue comes from subscription tiers targeting power users who manage large bookmark libraries.
License the skill to businesses for team use, enabling shared bookmark collections and collaborative tagging. Add features like audit logs and admin controls, with revenue from annual licenses based on the number of users or collections managed.
Monetize by providing custom API integrations or consulting services for companies needing tailored bookmark management solutions. Offer support for bulk data migration, automation scripts, and training, generating revenue from project-based fees or retainer contracts.
💬 Integration Tip
Use the --json flag with jq for scripting automation, and set RAINDROP_TOKEN in environment variables for secure, persistent access across sessions.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.