raindrop

What This Skill Does

The Raindrop skill enables seamless management of your Raindrop.io bookmark library directly through the OpenClaw AI agent. It acts as a bridge between your terminal and the Raindrop API, allowing you to organize, search, and curate your saved links without ever leaving your command line environment. Whether you are performing bulk administrative tasks on your collection or looking for a specific research link while working on code, this tool provides a robust interface for both reading and writing operations. It supports deep functionality including searching by query, managing specific collections by ID, moving items in bulk, and updating metadata like tags and titles.

Installation

To get started, you must have an active Raindrop.io account. Visit the integration settings in the Raindrop web app to generate a test API token. Install the skill using the following terminal command:

clawhub install openclaw/skills/skills/velvet-shark/raindrop

Once installed, you must configure your credentials. Create a file located at ~/.config/raindrop.env and add your token: RAINDROP_TOKEN="your-token-here". Ensure the file permissions are restricted to your user for security.

Use Cases

This skill is perfect for power users who maintain large bookmark libraries. Common use cases include:

• Organizing Knowledge Bases: Quickly moving hundreds of 'unsorted' links into structured collections using the bulk-move command.
• Research Automation: Searching your entire library for specific keywords related to a coding project.
• Maintenance: Identifying and cleaning up untagged bookmarks to maintain a healthy and searchable repository.
• Workflow Integration: Saving new research directly to specific collections while actively writing code, keeping your context switch low.

Example Prompts

1. "Search my Raindrop bookmarks for 'AI coding tools' and list the titles."
2. "Move all my bookmarks currently in the 'Unsorted' collection to the 'Research' collection and add the tag 'pending-review'."
3. "List all my collections and tell me how many links I have in the 'Design Resources' collection."

Tips & Limitations

• Rate Limiting: If performing bulk operations, always utilize the --delay flag to respect API limits and prevent timeout errors during large transfers.
• Collection IDs: Remember that IDs like 0 (All), -1 (Unsorted), and -99 (Trash) are fixed. Use the collections command frequently to refresh your local map of collection names to IDs.
• Pro Features: Commands like cache require a Raindrop Pro subscription to function. If you encounter errors, verify your subscription status on the Raindrop website.
• Pagination: When dealing with large collections, always specify the --limit and --page flags to avoid truncated results.