ClawSkills logoClawSkills

Karakeep

Manage bookmarks and links in a Karakeep instance. Use when the user wants to save links, list recent bookmarks, or search their collection. Triggers on phrases

Introduction

# Karakeep Skill

Save and search bookmarks in a Karakeep instance.

## Setup

First, configure your instance URL and API key: ```bash uv run --with requests skills/karakeep/scripts/karakeep-cli.py login --url <instance_url> <api_key> ```

## Commands

### Save a Link Add a URL to your collection: ```bash uv run --with requests skills/karakeep/scripts/karakeep-cli.py add <url> ```

### List Bookmarks Show the most recent bookmarks: ```bash uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --limit 10 ```

### Search Bookmarks Find bookmarks matching a query. Supports complex syntax like `is:fav`, `title:word`, `#tag`, `after:YYYY-MM-DD`, etc.: ```bash uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --search "title:react is:fav" ```

## Troubleshooting - Ensure `KARAKEEP_API_KEY` (or `HOARDER_API_KEY`) is set or run `login`. - Verify the instance URL is correct in the script or config (`~/.config/karakeep/config.json`).

More Products