Raindrop Api

What it does

This skill enables AI agents to interact with the Raindrop.io bookmarking service through its REST API. It allows for actions like creating, retrieving, updating, and deleting bookmarks (raindrops), as well as uploading files and covers. The agent will use curl and jq commands to make direct REST calls to the Raindrop.io API.

When to use it

• An agent needs to save web pages or articles to a user's Raindrop.io account.
• An agent wants to retrieve specific bookmarks from a user’s Raindrop.io collection.
• An agent is tasked with organizing existing bookmarks within a Raindrop.io account (e.g., updating tags).
• When an agent needs to upload files or cover images associated with bookmarks.

Key capabilities

• REST API Interaction: Executes curl commands against the Raindrop.io REST API.
• Authentication Handling: Resolves authentication tokens in a specific order: environment variable, conversation context, and user prompt.
• JSON Data Format: Handles requests and responses formatted as JSON.
• Rate Limit Awareness: Operates within the Raindrop.io rate limit of 120 requests per minute.
• Confirmation Requirement: Requires confirmation from the user before performing destructive actions (deletion, bulk updates).

Example prompts

• "Save this article to my Raindrop.io account: [article URL]"
• "Find all bookmarks in my 'Technology' collection."
• "Update the title of the raindrop with ID 12345 to 'New Title'."
• "Upload this image as a cover for the raindrop with ID 67890."

Tips & gotchas

• Authentication: You may need to provide an API token. Test tokens can be generated at https://app.raindrop.io/settings/integrations.
• Confirmation Required: Be aware that destructive actions require user confirmation before execution.
• Rate Limits: The API has a rate limit of 120 requests per minute; avoid exceeding this to prevent errors.