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`).