playbooks

home / skills / openclaw / skills / karakeep

karakeep skill

/skills/jayphen/karakeep

This skill saves, lists, and searches bookmarks in a Karakeep instance, helping you organize links and discover content quickly.

npx playbooks add skill openclaw/skills --skill karakeep

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
1.3 KB
---
name: karakeep
description: 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 like "hoard this link", "save to karakeep", or "search my bookmarks".
metadata: {"clawdbot":{"emoji":"📦","requires":{"bins":["uv"]}}}
---

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

Overview

This skill manages bookmarks and links in a Karakeep instance and lets you save, list, and search your collection from the command line. It integrates with a configured instance URL and API key so you can add links, view recent bookmarks, and run advanced searches. Use it to quickly capture links or query your archive with flexible filters.

How this skill works

Authenticate by configuring your instance URL and API key (or run the built-in login step). The skill provides commands to add a URL, list recent bookmarks with a limit, and run complex searches using Karakeep's query syntax (tags, title:, is:, date filters, etc.). Results are returned as a concise list that you can review or pipe to further tools.

When to use it

  • Save a web page or resource quickly from the command line or bot trigger
  • Review the most recent bookmarks you or your team saved
  • Search your archive with filters like tags, favorites, titles, or date ranges
  • Back up or export links from a Karakeep instance
  • Audit or curate collections for a project or research task

Best practices

  • Set KARAKEEP_API_KEY (or HOARDER_API_KEY) in your environment to avoid repeated logins
  • Verify your instance URL in the config (~/.config/karakeep/config.json) before running commands
  • Use tags and title: filters when saving to make future searches precise
  • Limit list output with --limit when you only need recent items
  • Test complex search queries interactively to refine syntax (is:fav, #tag, after:YYYY-MM-DD)

Example use cases

  • Quickly hoard an interesting article during research with a single save command
  • List the last 10 bookmarks to catch up on recently saved resources
  • Search for all favorite items tagged with a project name using title: and #tag filters
  • Export or back up a set of links by running filtered lists and piping to a file
  • Curate shared team resources by filtering by date and tag to create a reading list

FAQ

How do I authenticate the skill with my Karakeep instance?

Run the login command with your instance URL and API key or set KARAKEEP_API_KEY / HOARDER_API_KEY in your environment; the config is stored at ~/.config/karakeep/config.json.

How do I perform advanced searches?

Use Karakeep query syntax in the search flag, e.g., title:react is:fav #tag after:2023-01-01, and run the list command with --search.