raindrop

Manage Raindrop.io bookmarks, collections, tags, and highlights via REST API.

5|Updated Aug 8, 2016
One-click install
npx skills add https://github.com/gbencke/dotfiles --skill raindrop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: raindrop
Source: https://github.com/gbencke/dotfiles/tree/main/pi/skills/raindrop
Command: npx skills add https://github.com/gbencke/dotfiles --skill raindrop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the need to manually manage Raindrop.io bookmarks and instead lets you programmatically organize links, collections, tags, and highlights.

Core Features & Use Cases

  • Manage collections: List root and child collections, create or rename collections, and move/remove them via the Raindrop REST API.
  • Create, update, and delete raindrops (bookmarks): Save single bookmarks (optionally auto-parsing metadata), bulk import, bulk update, soft-delete to Trash, and permanently delete from Trash.
  • Search and curate content: Query bookmarks in a collection using search operators like tags, domains, types, importance, and created-date ranges.
  • Handle highlights and metadata: Add, update, and remove highlights on a raindrop to capture excerpts and notes.

Quick Start

Use the raindrop skill to save a new bookmark by running: Add a URL to an appropriate collection, auto-parse its metadata, and tag it as reading.

Frequently Asked Questions about raindrop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Raindrop.io bookmarks through the REST API?

You can manage Raindrop.io bookmarks through the REST API by capturing single links, performing bulk imports or updates, and soft-deleting items. The API supports auto-parsing metadata to automatically populate bookmark details during creation.

Can I organize Raindrop.io collections programmatically?

Yes, you can organize Raindrop.io collections programmatically by listing root and child collections, creating new ones, renaming existing structures, and moving or removing collections directly via REST API endpoints.

How do I search and filter bookmarks in a specific collection?

You can search and filter bookmarks within a collection using API search operators. Queries support filtering by tags, domains, item types, importance levels, and created-date ranges to curate saved content.

Do I need a Bearer token to use the Raindrop.io API?

Yes, you need a Bearer token to authenticate with the Raindrop.io API. The integration requires configuring a RAINDROP_TOKEN environment variable to satisfy authenticated requirements for accessing REST endpoints.

How are API rate limits handled when updating Raindrop.io highlights?

API rate limits are handled safely when updating Raindrop.io highlights by intercepting 429 responses. This ensures bulk operations and metadata extraction processes do not exceed endpoint request thresholds.

What is the best way to bulk import and tag Raindrop.io bookmarks?

The best way to bulk import and tag Raindrop.io bookmarks is using the REST API to process multiple links simultaneously. You can auto-parse metadata and apply tags like reading during the import workflow.