[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77VQXCS72Y9V6WN2CW57BX4":3,"skill-same:01M77VQXCS72Y9V6WN2CW57BX4":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M77VQXCS72Y9V6WN2CW57BX4","raindrop-api",null,"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\u002Fexport, 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.","Reihantt6\u002Fsns-myagent","Reihantt6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219822095?v=4","01M77KK94PV8B7C2D9XWXNS8DJ","Mohamad Reihan tegar prasetya","01M77KK958QFMTHYXGXFV7KZ79",2,"MIT","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fraindrop-api\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"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\u002Fexport, 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.\\n\"\n---\n# Raindrop.io API Skill\n\nThis skill enables interaction with the Raindrop.io bookmarks service through its REST API. Use `curl` and `jq` for direct REST calls.\n\n**Official API documentation**: https:\u002F\u002Fdeveloper.raindrop.io\u002F\n\n## Authentication\n\n### Token Resolution\n\nResolve the API token in this order:\n\n1. Check environment variable `RAINDROP_TOKEN`\n2. Check if the user has provided a token in the conversation context\n3. If neither is available, use AskUserQuestion to request the token from the user\n\nTo verify a token exists in the environment:\n\n```bash\n[ -n \"$RAINDROP_TOKEN\" ] && echo \"Token available\" || echo \"Token not set\"\n```\n\n**Quick setup**: For personal use or development, generate a test token at https:\u002F\u002Fapp.raindrop.io\u002Fsettings\u002Fintegrations — open your app and copy the \"Test token\". Test tokens do not expire.\n\nFor full OAuth2 flow details, see the [Authentication](#authentication-oauth2-flow) section below.\n\n### Making Authenticated Requests\n\nAll requests require the Authorization header with Bearer token:\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002FENDPOINT\"\n```\n\nFor POST\u002FPUT requests with JSON body:\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"key\": \"value\"}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002FENDPOINT\"\n```\n\n### Verifying Authentication\n\nTest the token by retrieving the current user:\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fuser\" | jq '.user.fullName'\n```\n\n## Base URL and Conventions\n\n- **Base URL**: `https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002F`\n- **Data Format**: JSON for all request\u002Fresponse bodies\n- **Timestamps**: ISO 8601 format\n- **Rate Limit**: 120 requests per minute per authenticated user\n- **CORS**: Supported for browser-based apps\n\n## Confirmation Requirement\n\n**Before executing any destructive action (DELETE, bulk update, move to trash), always ask the user for confirmation using AskUserQuestion.** A single confirmation suffices for a logical group of related actions.\n\nDestructive actions include:\n- Deleting raindrops, collections, or tags\n- Bulk updating or moving raindrops\n- Merging or removing tags\n- Removing collaborators from shared collections\n- Clearing trash\n\nRead-only operations (GET requests) do not require confirmation.\n\n## Endpoints Reference\n\n### Raindrops (Bookmarks)\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\n\n#### Single Raindrop Operations\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get raindrop | GET | `\u002Fraindrop\u002F{id}` |\n| Create raindrop | POST | `\u002Fraindrop` |\n| Update raindrop | PUT | `\u002Fraindrop\u002F{id}` |\n| Remove raindrop | DELETE | `\u002Fraindrop\u002F{id}` |\n| Upload file | PUT | `\u002Fraindrop\u002Ffile` |\n| Upload cover | PUT | `\u002Fraindrop\u002F{id}\u002Fcover` |\n| Get permanent copy | GET | `\u002Fraindrop\u002F{id}\u002Fcache` |\n| Suggest (new URL) | POST | `\u002Fraindrop\u002Fsuggest` |\n| Suggest (existing) | GET | `\u002Fraindrop\u002F{id}\u002Fsuggest` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\u002Fsingle\n\n**Raindrop creation\u002Fupdate fields:**\n- `link` (string, required for creation) - Bookmark URL\n- `title` (string) - Bookmark title\n- `excerpt` (string) - Short description\n- `note` (string) - User notes (supports Markdown)\n- `tags` (array of strings) - Tag names\n- `collection` (object) - `{\"$id\": collectionId}`\n- `type` (string) - `link`, `article`, `image`, `video`, `document`, `audio`\n- `important` (boolean) - Mark as favourite\n- `order` (number) - Sort order (ascending)\n- `media` (array) - Media\u002Fthumbnail info\n- `highlights` (array) - Text highlights\n- `cover` (string) - Cover image URL, or `\u003Cscreenshot>` for auto-capture\n- `pleaseParse` (object) - `{}` to trigger background metadata parsing\n- `created` (string) - ISO 8601 creation date\n- `lastUpdate` (string) - ISO 8601 last update date\n- `reminder` (object) - Reminder settings\n\n**Deletion behaviour**: Removing a raindrop moves it to Trash (collection ID `-99`). Removing from Trash deletes permanently.\n\n#### Multiple Raindrop Operations\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get raindrops | GET | `\u002Fraindrops\u002F{collectionId}` |\n| Create multiple | POST | `\u002Fraindrops` |\n| Update multiple | PUT | `\u002Fraindrops\u002F{collectionId}` |\n| Remove multiple | DELETE | `\u002Fraindrops\u002F{collectionId}` |\n| Export | GET | `\u002Fraindrops\u002F{collectionId}\u002Fexport.{format}` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\u002Fmultiple\n\n**collectionId values:**\n- `0` - All raindrops\n- `-1` - Unsorted\n- `-99` - Trash\n- Any positive integer - Specific collection\n\n**Query parameters for GET \u002Fraindrops\u002F{collectionId}:**\n- `sort` - Sort order: `-created` (default), `created`, `score`, `-sort`, `title`, `-title`, `domain`, `-domain`\n- `perpage` - Results per page (max 50)\n- `page` - Page number (0-indexed)\n- `search` - Search query (see `references\u002Fsearch-operators.md`)\n- `nested` - Boolean, include child collection bookmarks\n\n**Bulk update fields** (PUT with `ids` array or `search` query):\n- `important` (boolean)\n- `tags` (array) - Appends tags; empty array clears all\n- `media` (array) - Appends; empty array clears\n- `cover` (string) - URL or `\u003Cscreenshot>`\n- `collection` (object) - `{\"$id\": collectionId}` to move\n\n**Export formats**: `csv`, `html`, `zip`\n\n### Collections\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fcollections\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| List root collections | GET | `\u002Fcollections` |\n| List child collections | GET | `\u002Fcollections\u002Fchildrens` |\n| Get collection | GET | `\u002Fcollection\u002F{id}` |\n| Create collection | POST | `\u002Fcollection` |\n| Update collection | PUT | `\u002Fcollection\u002F{id}` |\n| Upload cover | PUT | `\u002Fcollection\u002F{id}\u002Fcover` |\n| Delete collection | DELETE | `\u002Fcollection\u002F{id}` |\n| Delete multiple | DELETE | `\u002Fcollections` |\n| Reorder\u002Fexpand all | PUT | `\u002Fcollections` |\n| Merge collections | PUT | `\u002Fcollections\u002Fmerge` |\n| Remove empty | PUT | `\u002Fcollections\u002Fclean` |\n| Empty trash | DELETE | `\u002Fcollection\u002F-99` |\n| System collection counts | GET | `\u002Fuser\u002Fstats` |\n| Search covers\u002Ficons | GET | `\u002Fcollections\u002Fcovers\u002F{text}` |\n| Featured covers | GET | `\u002Fcollections\u002Fcovers` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fcollections\u002Fmethods\n\n**Collection fields:**\n- `title` (string) - Collection name\n- `view` (string) - Display style: `list`, `simple`, `grid`, `masonry`\n- `public` (boolean) - Public accessibility\n- `parent` (object) - `{\"$id\": parentCollectionId}` for nesting\n- `sort` (number) - Sort position\n- `cover` (array) - Cover image URLs\n- `expanded` (boolean) - Whether subcollections are expanded\n- `color` (string) - Collection colour\n\n**System collections** (non-removable):\n- ID `-1` - \"Unsorted\"\n- ID `-99` - \"Trash\"\n\n**Access levels** (`access.level`):\n- `1` - Read only\n- `2` - Collaborator (write)\n- `3` - Collaborator (write + manage)\n- `4` - Owner\n\nFor sharing\u002Fcollaborators, see `references\u002Fcollections-sharing.md`.\n\n### Tags\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Ftags\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get tags | GET | `\u002Ftags\u002F{collectionId}` |\n| Rename tag | PUT | `\u002Ftags\u002F{collectionId}` |\n| Merge tags | PUT | `\u002Ftags\u002F{collectionId}` |\n| Remove tag(s) | DELETE | `\u002Ftags\u002F{collectionId}` |\n\n**collectionId**: Omit or use `0` for tags from all collections.\n\n**Get tags response:**\n\n```json\n{\n  \"result\": true,\n  \"items\": [{\"_id\": \"tagname\", \"count\": 42}]\n}\n```\n\n**Rename tag:**\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"replace\": \"new-name\", \"tags\": [\"old-name\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n**Merge tags** (same endpoint, multiple tags in array):\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"replace\": \"merged-name\", \"tags\": [\"tag1\", \"tag2\", \"tag3\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n**Remove tags:**\n\n```bash\ncurl -s -X DELETE \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"tags\": [\"tag-to-remove\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n### Highlights\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fhighlights\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get all highlights | GET | `\u002Fhighlights` |\n| Get collection highlights | GET | `\u002Fhighlights\u002F{collectionId}` |\n| Get raindrop highlights | GET | `\u002Fraindrop\u002F{id}` |\n| Add highlight | PUT | `\u002Fraindrop\u002F{id}` |\n| Update highlight | PUT | `\u002Fraindrop\u002F{id}` |\n| Delete highlight | PUT | `\u002Fraindrop\u002F{id}` |\n\nFor details, see `references\u002Fhighlights.md`.\n\n### Filters\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Ffilters\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ffilters\u002F{collectionId}\" | jq '.'\n```\n\nUse `0` for all collections. Returns aggregated counts for broken links, duplicates, favourites, untagged items, tags, and content types.\n\n**Query parameters:**\n- `tagsSort` - `-count` (default) or `_id` (alphabetical)\n- `search` - Additional search filter\n\n### User\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fuser\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get current user | GET | `\u002Fuser` |\n| Update user | PUT | `\u002Fuser` |\n\n### Import\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fimport\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Parse URL | GET | `\u002Fimport\u002Furl\u002Fparse?url={url}` |\n| Check URL existence | POST | `\u002Fimport\u002Furl\u002Fexists` |\n| Parse HTML bookmark file | POST | `\u002Fimport\u002Ffile` |\n\n### Backups\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fbackups\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| List backups | GET | `\u002Fbackups` |\n| Download backup | GET | `\u002Fbackup\u002F{id}.{format}` |\n| Generate new backup | GET | `\u002Fbackup` |\n\n**Formats**: `html` or `csv`\n\n## Authentication: OAuth2 Flow\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fauthentication\u002Ftoken\n\nFor apps accessing other users' data (not personal use), use the full OAuth2 flow:\n\n### Step 1: Authorise\n\nDirect users to:\n\n```\nhttps:\u002F\u002Fraindrop.io\u002Foauth\u002Fauthorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code\n```\n\n### Step 2: Exchange Code for Token\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fraindrop.io\u002Foauth\u002Faccess_token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"code\": \"AUTH_CODE\",\n    \"client_id\": \"YOUR_CLIENT_ID\",\n    \"client_secret\": \"YOUR_CLIENT_SECRET\",\n    \"redirect_uri\": \"YOUR_REDIRECT_URI\",\n    \"grant_type\": \"authorization_code\"\n  }' | jq '.'\n```\n\nResponse:\n\n```json\n{\n  \"access_token\": \"...\",\n  \"refresh_token\": \"...\",\n  \"expires_in\": 1209599,\n  \"token_type\": \"Bearer\"\n}\n```\n\n### Step 3: Refresh Token\n\nAccess tokens expire after two weeks. Refresh with:\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fraindrop.io\u002Foauth\u002Faccess_token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"client_id\": \"YOUR_CLIENT_ID\",\n    \"client_secret\": \"YOUR_CLIENT_SECRET\",\n    \"refresh_token\": \"YOUR_REFRESH_TOKEN\",\n    \"grant_type\": \"refresh_token\"\n  }' | jq '.'\n```\n\n## Error Handling\n\nCheck HTTP status codes:\n\n- `200` - Success\n- `204` - Success, no content\n- `400` - Bad request\n- `401` - Authentication failed (check token)\n- `403` - Forbidden (insufficient permissions)\n- `404` - Resource not found\n- `429` - Rate limited (120 req\u002Fmin exceeded)\n- `5xx` - Server error\n\n### Example with Error Handling\n\n```bash\nresponse=$(curl -s -w \"\\n%{http_code}\" \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\")\n\nhttp_code=$(echo \"$response\" | tail -1)\nbody=$(echo \"$response\" | sed '$d')\n\nif [ \"$http_code\" -ge 200 ] && [ \"$http_code\" -lt 300 ]; then\n  echo \"$body\" | jq '.'\nelse\n  echo \"Error: HTTP $http_code\"\n  echo \"$body\"\nfi\n```\n\n## Common Patterns\n\n### List All Bookmarks in a Collection\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002FCOLLECTION_ID?perpage=50\" | jq '.items[] | {title, link}'\n```\n\n### Create a Bookmark\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"link\": \"https:\u002F\u002Fexample.com\",\n    \"title\": \"Example Site\",\n    \"tags\": [\"reference\", \"example\"],\n    \"collection\": {\"$id\": COLLECTION_ID},\n    \"pleaseParse\": {}\n  }' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrop\" | jq '.'\n```\n\n### Search Bookmarks\n\n```bash\n# Search across all collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?search=YOUR_QUERY\" | jq '.items[] | {title, link}'\n\n# Search with tag filter\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?search=%23tagname\" | jq '.items[] | {title, link}'\n```\n\nSee `references\u002Fsearch-operators.md` for the complete search query syntax.\n\n### Move Bookmark to a Collection\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"collection\": {\"$id\": TARGET_COLLECTION_ID}}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrop\u002FRAINDROP_ID\" | jq '.'\n```\n\n### Get All Tags\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\" | jq '.items[] | {tag: ._id, count}'\n```\n\n### Create a Collection\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"title\": \"My Collection\", \"view\": \"list\"}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollection\" | jq '.'\n```\n\n### List All Collections (Root + Children)\n\n```bash\n# Root collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollections\" | jq '.items[] | {id: ._id, title}'\n\n# Child collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollections\u002Fchildrens\" | jq '.items[] | {id: ._id, title, parent: .parent.\"$id\"}'\n```\n\n### Paginate Through All Bookmarks\n\n```bash\npage=0\nwhile true; do\n  response=$(curl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n    \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?perpage=50&page=$page\")\n\n  count=$(echo \"$response\" | jq '.items | length')\n  echo \"$response\" | jq '.items[] | {title, link}'\n\n  if [ \"$count\" -lt 50 ]; then\n    break\n  fi\n  page=$((page + 1))\ndone\n```\n\n### Export Bookmarks\n\n```bash\n# Export all bookmarks as CSV\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\u002Fexport.csv\" -o bookmarks.csv\n\n# Export as HTML\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\u002Fexport.html\" -o bookmarks.html\n```\n\n### Check if URL Already Saved\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"urls\": [\"https:\u002F\u002Fexample.com\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fimport\u002Furl\u002Fexists\" | jq '.'\n```\n\n## Pagination\n\nRaindrop uses page-based pagination (not cursor-based):\n\n- `page` - Page number (0-indexed)\n- `perpage` - Items per page (max 50, default 25 for highlights)\n\nWhen the number of items returned is less than `perpage`, you have reached the last page.\n\n## Nested Collection Structure\n\nCollections are organised hierarchically. Reconstructing the full sidebar requires:\n\n1. `GET \u002Fuser` - Returns `groups` array with collection ordering\n2. `GET \u002Fcollections` - Root collections\n3. `GET \u002Fcollections\u002Fchildrens` - Nested collections\n\nRoot collection sort order is persisted in the user's `groups[].collections` array. Child collection sort order is stored in the collection's `sort` field.\n\n## Additional Reference\n\nFor detailed documentation on specific topics, consult:\n- `references\u002Fsearch-operators.md` - Search query syntax and operators\n- `references\u002Fcollections-sharing.md` - Collection sharing and collaborators\n- `references\u002Fhighlights.md` - Highlight management\n\n## Workflow Summary\n\n1. **Resolve token** - Environment, context, or ask user\n2. **Verify authentication** - Test with `GET \u002Fuser`\n3. **Read operations** - Execute directly without confirmation\n4. **Write operations** - Ask for confirmation before executing\n5. **Handle pagination** - Loop with page number until items \u003C perpage\n6. **Parse responses** - Use jq to extract and format data\n","# Raindrop.io API Skill\n\nThis skill enables interaction with the Raindrop.io bookmarks service through its REST API. Use `curl` and `jq` for direct REST calls.\n\n**Official API documentation**: https:\u002F\u002Fdeveloper.raindrop.io\u002F\n\n## Authentication\n\n### Token Resolution\n\nResolve the API token in this order:\n\n1. Check environment variable `RAINDROP_TOKEN`\n2. Check if the user has provided a token in the conversation context\n3. If neither is available, use AskUserQuestion to request the token from the user\n\nTo verify a token exists in the environment:\n\n```bash\n[ -n \"$RAINDROP_TOKEN\" ] && echo \"Token available\" || echo \"Token not set\"\n```\n\n**Quick setup**: For personal use or development, generate a test token at https:\u002F\u002Fapp.raindrop.io\u002Fsettings\u002Fintegrations — open your app and copy the \"Test token\". Test tokens do not expire.\n\nFor full OAuth2 flow details, see the [Authentication](#authentication-oauth2-flow) section below.\n\n### Making Authenticated Requests\n\nAll requests require the Authorization header with Bearer token:\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002FENDPOINT\"\n```\n\nFor POST\u002FPUT requests with JSON body:\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"key\": \"value\"}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002FENDPOINT\"\n```\n\n### Verifying Authentication\n\nTest the token by retrieving the current user:\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fuser\" | jq '.user.fullName'\n```\n\n## Base URL and Conventions\n\n- **Base URL**: `https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002F`\n- **Data Format**: JSON for all request\u002Fresponse bodies\n- **Timestamps**: ISO 8601 format\n- **Rate Limit**: 120 requests per minute per authenticated user\n- **CORS**: Supported for browser-based apps\n\n## Confirmation Requirement\n\n**Before executing any destructive action (DELETE, bulk update, move to trash), always ask the user for confirmation using AskUserQuestion.** A single confirmation suffices for a logical group of related actions.\n\nDestructive actions include:\n- Deleting raindrops, collections, or tags\n- Bulk updating or moving raindrops\n- Merging or removing tags\n- Removing collaborators from shared collections\n- Clearing trash\n\nRead-only operations (GET requests) do not require confirmation.\n\n## Endpoints Reference\n\n### Raindrops (Bookmarks)\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\n\n#### Single Raindrop Operations\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get raindrop | GET | `\u002Fraindrop\u002F{id}` |\n| Create raindrop | POST | `\u002Fraindrop` |\n| Update raindrop | PUT | `\u002Fraindrop\u002F{id}` |\n| Remove raindrop | DELETE | `\u002Fraindrop\u002F{id}` |\n| Upload file | PUT | `\u002Fraindrop\u002Ffile` |\n| Upload cover | PUT | `\u002Fraindrop\u002F{id}\u002Fcover` |\n| Get permanent copy | GET | `\u002Fraindrop\u002F{id}\u002Fcache` |\n| Suggest (new URL) | POST | `\u002Fraindrop\u002Fsuggest` |\n| Suggest (existing) | GET | `\u002Fraindrop\u002F{id}\u002Fsuggest` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\u002Fsingle\n\n**Raindrop creation\u002Fupdate fields:**\n- `link` (string, required for creation) - Bookmark URL\n- `title` (string) - Bookmark title\n- `excerpt` (string) - Short description\n- `note` (string) - User notes (supports Markdown)\n- `tags` (array of strings) - Tag names\n- `collection` (object) - `{\"$id\": collectionId}`\n- `type` (string) - `link`, `article`, `image`, `video`, `document`, `audio`\n- `important` (boolean) - Mark as favourite\n- `order` (number) - Sort order (ascending)\n- `media` (array) - Media\u002Fthumbnail info\n- `highlights` (array) - Text highlights\n- `cover` (string) - Cover image URL, or `\u003Cscreenshot>` for auto-capture\n- `pleaseParse` (object) - `{}` to trigger background metadata parsing\n- `created` (string) - ISO 8601 creation date\n- `lastUpdate` (string) - ISO 8601 last update date\n- `reminder` (object) - Reminder settings\n\n**Deletion behaviour**: Removing a raindrop moves it to Trash (collection ID `-99`). Removing from Trash deletes permanently.\n\n#### Multiple Raindrop Operations\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get raindrops | GET | `\u002Fraindrops\u002F{collectionId}` |\n| Create multiple | POST | `\u002Fraindrops` |\n| Update multiple | PUT | `\u002Fraindrops\u002F{collectionId}` |\n| Remove multiple | DELETE | `\u002Fraindrops\u002F{collectionId}` |\n| Export | GET | `\u002Fraindrops\u002F{collectionId}\u002Fexport.{format}` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fraindrops\u002Fmultiple\n\n**collectionId values:**\n- `0` - All raindrops\n- `-1` - Unsorted\n- `-99` - Trash\n- Any positive integer - Specific collection\n\n**Query parameters for GET \u002Fraindrops\u002F{collectionId}:**\n- `sort` - Sort order: `-created` (default), `created`, `score`, `-sort`, `title`, `-title`, `domain`, `-domain`\n- `perpage` - Results per page (max 50)\n- `page` - Page number (0-indexed)\n- `search` - Search query (see `references\u002Fsearch-operators.md`)\n- `nested` - Boolean, include child collection bookmarks\n\n**Bulk update fields** (PUT with `ids` array or `search` query):\n- `important` (boolean)\n- `tags` (array) - Appends tags; empty array clears all\n- `media` (array) - Appends; empty array clears\n- `cover` (string) - URL or `\u003Cscreenshot>`\n- `collection` (object) - `{\"$id\": collectionId}` to move\n\n**Export formats**: `csv`, `html`, `zip`\n\n### Collections\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fcollections\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| List root collections | GET | `\u002Fcollections` |\n| List child collections | GET | `\u002Fcollections\u002Fchildrens` |\n| Get collection | GET | `\u002Fcollection\u002F{id}` |\n| Create collection | POST | `\u002Fcollection` |\n| Update collection | PUT | `\u002Fcollection\u002F{id}` |\n| Upload cover | PUT | `\u002Fcollection\u002F{id}\u002Fcover` |\n| Delete collection | DELETE | `\u002Fcollection\u002F{id}` |\n| Delete multiple | DELETE | `\u002Fcollections` |\n| Reorder\u002Fexpand all | PUT | `\u002Fcollections` |\n| Merge collections | PUT | `\u002Fcollections\u002Fmerge` |\n| Remove empty | PUT | `\u002Fcollections\u002Fclean` |\n| Empty trash | DELETE | `\u002Fcollection\u002F-99` |\n| System collection counts | GET | `\u002Fuser\u002Fstats` |\n| Search covers\u002Ficons | GET | `\u002Fcollections\u002Fcovers\u002F{text}` |\n| Featured covers | GET | `\u002Fcollections\u002Fcovers` |\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fcollections\u002Fmethods\n\n**Collection fields:**\n- `title` (string) - Collection name\n- `view` (string) - Display style: `list`, `simple`, `grid`, `masonry`\n- `public` (boolean) - Public accessibility\n- `parent` (object) - `{\"$id\": parentCollectionId}` for nesting\n- `sort` (number) - Sort position\n- `cover` (array) - Cover image URLs\n- `expanded` (boolean) - Whether subcollections are expanded\n- `color` (string) - Collection colour\n\n**System collections** (non-removable):\n- ID `-1` - \"Unsorted\"\n- ID `-99` - \"Trash\"\n\n**Access levels** (`access.level`):\n- `1` - Read only\n- `2` - Collaborator (write)\n- `3` - Collaborator (write + manage)\n- `4` - Owner\n\nFor sharing\u002Fcollaborators, see `references\u002Fcollections-sharing.md`.\n\n### Tags\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Ftags\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get tags | GET | `\u002Ftags\u002F{collectionId}` |\n| Rename tag | PUT | `\u002Ftags\u002F{collectionId}` |\n| Merge tags | PUT | `\u002Ftags\u002F{collectionId}` |\n| Remove tag(s) | DELETE | `\u002Ftags\u002F{collectionId}` |\n\n**collectionId**: Omit or use `0` for tags from all collections.\n\n**Get tags response:**\n\n```json\n{\n  \"result\": true,\n  \"items\": [{\"_id\": \"tagname\", \"count\": 42}]\n}\n```\n\n**Rename tag:**\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"replace\": \"new-name\", \"tags\": [\"old-name\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n**Merge tags** (same endpoint, multiple tags in array):\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"replace\": \"merged-name\", \"tags\": [\"tag1\", \"tag2\", \"tag3\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n**Remove tags:**\n\n```bash\ncurl -s -X DELETE \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"tags\": [\"tag-to-remove\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\"\n```\n\n### Highlights\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fhighlights\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get all highlights | GET | `\u002Fhighlights` |\n| Get collection highlights | GET | `\u002Fhighlights\u002F{collectionId}` |\n| Get raindrop highlights | GET | `\u002Fraindrop\u002F{id}` |\n| Add highlight | PUT | `\u002Fraindrop\u002F{id}` |\n| Update highlight | PUT | `\u002Fraindrop\u002F{id}` |\n| Delete highlight | PUT | `\u002Fraindrop\u002F{id}` |\n\nFor details, see `references\u002Fhighlights.md`.\n\n### Filters\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Ffilters\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ffilters\u002F{collectionId}\" | jq '.'\n```\n\nUse `0` for all collections. Returns aggregated counts for broken links, duplicates, favourites, untagged items, tags, and content types.\n\n**Query parameters:**\n- `tagsSort` - `-count` (default) or `_id` (alphabetical)\n- `search` - Additional search filter\n\n### User\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fuser\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Get current user | GET | `\u002Fuser` |\n| Update user | PUT | `\u002Fuser` |\n\n### Import\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fimport\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| Parse URL | GET | `\u002Fimport\u002Furl\u002Fparse?url={url}` |\n| Check URL existence | POST | `\u002Fimport\u002Furl\u002Fexists` |\n| Parse HTML bookmark file | POST | `\u002Fimport\u002Ffile` |\n\n### Backups\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fbackups\n\n| Operation | Method | Endpoint |\n|-----------|--------|----------|\n| List backups | GET | `\u002Fbackups` |\n| Download backup | GET | `\u002Fbackup\u002F{id}.{format}` |\n| Generate new backup | GET | `\u002Fbackup` |\n\n**Formats**: `html` or `csv`\n\n## Authentication: OAuth2 Flow\n\nDocs: https:\u002F\u002Fdeveloper.raindrop.io\u002Fv1\u002Fauthentication\u002Ftoken\n\nFor apps accessing other users' data (not personal use), use the full OAuth2 flow:\n\n### Step 1: Authorise\n\nDirect users to:\n\n```\nhttps:\u002F\u002Fraindrop.io\u002Foauth\u002Fauthorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code\n```\n\n### Step 2: Exchange Code for Token\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fraindrop.io\u002Foauth\u002Faccess_token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"code\": \"AUTH_CODE\",\n    \"client_id\": \"YOUR_CLIENT_ID\",\n    \"client_secret\": \"YOUR_CLIENT_SECRET\",\n    \"redirect_uri\": \"YOUR_REDIRECT_URI\",\n    \"grant_type\": \"authorization_code\"\n  }' | jq '.'\n```\n\nResponse:\n\n```json\n{\n  \"access_token\": \"...\",\n  \"refresh_token\": \"...\",\n  \"expires_in\": 1209599,\n  \"token_type\": \"Bearer\"\n}\n```\n\n### Step 3: Refresh Token\n\nAccess tokens expire after two weeks. Refresh with:\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fraindrop.io\u002Foauth\u002Faccess_token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"client_id\": \"YOUR_CLIENT_ID\",\n    \"client_secret\": \"YOUR_CLIENT_SECRET\",\n    \"refresh_token\": \"YOUR_REFRESH_TOKEN\",\n    \"grant_type\": \"refresh_token\"\n  }' | jq '.'\n```\n\n## Error Handling\n\nCheck HTTP status codes:\n\n- `200` - Success\n- `204` - Success, no content\n- `400` - Bad request\n- `401` - Authentication failed (check token)\n- `403` - Forbidden (insufficient permissions)\n- `404` - Resource not found\n- `429` - Rate limited (120 req\u002Fmin exceeded)\n- `5xx` - Server error\n\n### Example with Error Handling\n\n```bash\nresponse=$(curl -s -w \"\\n%{http_code}\" \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\")\n\nhttp_code=$(echo \"$response\" | tail -1)\nbody=$(echo \"$response\" | sed '$d')\n\nif [ \"$http_code\" -ge 200 ] && [ \"$http_code\" -lt 300 ]; then\n  echo \"$body\" | jq '.'\nelse\n  echo \"Error: HTTP $http_code\"\n  echo \"$body\"\nfi\n```\n\n## Common Patterns\n\n### List All Bookmarks in a Collection\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002FCOLLECTION_ID?perpage=50\" | jq '.items[] | {title, link}'\n```\n\n### Create a Bookmark\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"link\": \"https:\u002F\u002Fexample.com\",\n    \"title\": \"Example Site\",\n    \"tags\": [\"reference\", \"example\"],\n    \"collection\": {\"$id\": COLLECTION_ID},\n    \"pleaseParse\": {}\n  }' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrop\" | jq '.'\n```\n\n### Search Bookmarks\n\n```bash\n# Search across all collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?search=YOUR_QUERY\" | jq '.items[] | {title, link}'\n\n# Search with tag filter\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?search=%23tagname\" | jq '.items[] | {title, link}'\n```\n\nSee `references\u002Fsearch-operators.md` for the complete search query syntax.\n\n### Move Bookmark to a Collection\n\n```bash\ncurl -s -X PUT \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"collection\": {\"$id\": TARGET_COLLECTION_ID}}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrop\u002FRAINDROP_ID\" | jq '.'\n```\n\n### Get All Tags\n\n```bash\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Ftags\u002F0\" | jq '.items[] | {tag: ._id, count}'\n```\n\n### Create a Collection\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"title\": \"My Collection\", \"view\": \"list\"}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollection\" | jq '.'\n```\n\n### List All Collections (Root + Children)\n\n```bash\n# Root collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollections\" | jq '.items[] | {id: ._id, title}'\n\n# Child collections\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fcollections\u002Fchildrens\" | jq '.items[] | {id: ._id, title, parent: .parent.\"$id\"}'\n```\n\n### Paginate Through All Bookmarks\n\n```bash\npage=0\nwhile true; do\n  response=$(curl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n    \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0?perpage=50&page=$page\")\n\n  count=$(echo \"$response\" | jq '.items | length')\n  echo \"$response\" | jq '.items[] | {title, link}'\n\n  if [ \"$count\" -lt 50 ]; then\n    break\n  fi\n  page=$((page + 1))\ndone\n```\n\n### Export Bookmarks\n\n```bash\n# Export all bookmarks as CSV\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\u002Fexport.csv\" -o bookmarks.csv\n\n# Export as HTML\ncurl -s -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fraindrops\u002F0\u002Fexport.html\" -o bookmarks.html\n```\n\n### Check if URL Already Saved\n\n```bash\ncurl -s -X POST \\\n  -H \"Authorization: Bearer $RAINDROP_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"urls\": [\"https:\u002F\u002Fexample.com\"]}' \\\n  \"https:\u002F\u002Fapi.raindrop.io\u002Frest\u002Fv1\u002Fimport\u002Furl\u002Fexists\" | jq '.'\n```\n\n## Pagination\n\nRaindrop uses page-based pagination (not cursor-based):\n\n- `page` - Page number (0-indexed)\n- `perpage` - Items per page (max 50, default 25 for highlights)\n\nWhen the number of items returned is less than `perpage`, you have reached the last page.\n\n## Nested Collection Structure\n\nCollections are organised hierarchically. Reconstructing the full sidebar requires:\n\n1. `GET \u002Fuser` - Returns `groups` array with collection ordering\n2. `GET \u002Fcollections` - Root collections\n3. `GET \u002Fcollections\u002Fchildrens` - Nested collections\n\nRoot collection sort order is persisted in the user's `groups[].collections` array. Child collection sort order is stored in the collection's `sort` field.\n\n## Additional Reference\n\nFor detailed documentation on specific topics, consult:\n- `references\u002Fsearch-operators.md` - Search query syntax and operators\n- `references\u002Fcollections-sharing.md` - Collection sharing and collaborators\n- `references\u002Fhighlights.md` - Highlight management\n\n## Workflow Summary\n\n1. **Resolve token** - Environment, context, or ask user\n2. **Verify authentication** - Test with `GET \u002Fuser`\n3. **Read operations** - Execute directly without confirmation\n4. **Write operations** - Ask for confirmation before executing\n5. **Handle pagination** - Loop with page number until items \u003C perpage\n6. **Parse responses** - Use jq to extract and format data\n",{"description":24},"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\u002Fexport, 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.\n","main","58843b159d7a4050d6b785a98b908cce505c0b92","agent\u002Fskills\u002Fraindrop-api",0,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent","https:\u002F\u002Fgithub.com\u002FReihantt6","reihsns.web.id","2026-08-19 20:08:18",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Reihantt6\u002Fsns-myagent --skill raindrop-api",{"tool":39,"command":40},"bunx","bunx skills add Reihantt6\u002Fsns-myagent --skill raindrop-api",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Reihantt6\u002Fsns-myagent --skill raindrop-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fraindrop-api\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fcollections-sharing.md","REFERENCE","参考文档",2556,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fraindrop-api\u002Freferences\u002Fcollections-sharing.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fhighlights.md",3027,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fraindrop-api\u002Freferences\u002Fhighlights.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fsearch-operators.md",4761,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fraindrop-api\u002Freferences\u002Fsearch-operators.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M77XDCYZ407XYMF2T4P6F7VT","youtube-transcript","Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com\u002Fwatch?v=, youtu.be\u002F, or similar). Supports output with or without timestamps.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-transcript\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M77XD7PBC98J6MXGJJ2TJ8DX","youtube-thumbnail-design","YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A\u002FB testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-thumbnail-design\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M77XD2541C8HXJ6RHYZP4NGJ","youtube-short-maker","Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: \"youtube short\", \"make a youtube short\", \"shorts video\", \"short-form video\". NOT for long-form or landscape video.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-short-maker\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M77XCXKVSYK7KTZ3PQBVVGFD","xcode-project-setup","Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fxcode-project-setup\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M77XCR1DV8ZQK2NHWKVY4EWX","x402","Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — \"just use it\" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or \"build it in\" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fx402\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M77XCMD3R3ZBZQQSW6E0793B","x-twitter-scraper","Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fx-twitter-scraper\u002FSKILL.md",[],[]]