Karakeep

通过 uv 运行 Python 脚本调用 Karakeep 实例 API：先 login 配置实例 URL 与 API Key，再用 add 保存链接、list 列出最近书签，并支持 is:fav、title:word、#tag、after:YYYY-MM-DD 等语法搜索书签；密钥来自环境变量或本地配置文件。

jayphen

热度 97.79

最近更新 2026-05-19 06:54:10

分类：知识依赖：代码执行 / 第三方 API / 读写文件应用场景：笔记整理 / 研究 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add karakeep

Metadata

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:

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:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py add <url>

List Bookmarks

Show the most recent bookmarks:

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.:

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