Skip to content
TrustedSkillsbeta
Back to all skills

Karakeep Semantic Search

Listed
jamesbrooksco·v1.0.0·ai-ml·MIT

Semantic search sidecar for Karakeep bookmarks. Find bookmarks by meaning, not just keywords. Uses vector embeddings for intent-aware retrieval.

Repository

Install on your platform

Showing OpenClaw.

  1. 1

    Run this in your terminal

    terminal
    $ openclaw skills install karakeep-semantic

What we know about this skill

Publisher

jamesbrooksco

Taken from the source listing. We haven't verified who controls this account.

Install target

Pinned to ed1fa2d4

Installs fetch a stored snapshot of that commit, so the code can't change after the fact.

No human has reviewed this code. The checks below are a static scan of the files at one commit — nobody has run this skill or judged whether it works. A skill runs with whatever access you give your agent, so read the source before you install it.

Automated safety checks

scanned

This skill failed 2 of 6 checks. A failure is not proof of bad intent; it means something in the code needs a human to look at it before you run it.

  • Declares what it does: failed

    SKILL.md has no YAML frontmatter, so it declares nothing machine-readable.

    SKILL.md exists, its frontmatter parses, and it declares a name and a description.

  • No undeclared network calls: failed

    Contacts 1 host that is neither well-known infrastructure nor declared in the skill's frontmatter: 192.168.1.105.

    Every host the skill dials — from its scripts, its config endpoints or the commands it tells the agent to run — is either well-known package and API infrastructure or declared in its own frontmatter. Links in documentation are not counted.

    Hosts contacted

    192.168.1.105undeclared

    What it found

    • skill/SKILL.md:9contacts 192.168.1.105
      KARAKEEP_SEMANTIC_URL=http://192.168.1.105:3001

  • No obfuscated payloads: passed

    No encoded or obfuscated payloads.

    No base64, hex or compressed blob is decoded and then executed, and no encoded shell commands.

  • No credential access: passed

    Reads no keys, tokens, keychains or credential files.

    Neither the code nor the SKILL.md instructions read SSH keys, cloud credentials, keychains, token stores, browser cookie databases or dotfiles that hold secrets.

  • No pipe-to-shell installers: passed

    No pipe-to-shell or download-and-run installers.

    No `curl … | sh` pattern, in the code or in the instructions, that runs code fetched at run time.

  • Pinned to a commit: passed

    Scanned jamesbrooksco/karakeep-semantic-search at ed1fa2d4d2.

    The exact upstream commit SHA that was scanned is recorded, so the result refers to specific bytes.

Commit
ed1fa2d4d2
Manifest
skill/SKILL.md
Scanned
1 file, 56 lines
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

What it does

Karakeep Semantic Search enhances your Karakeep bookmark manager with powerful semantic search capabilities. It converts the content of your bookmarks into vector embeddings, allowing you to find relevant bookmarks based on meaning rather than just keyword matches. The service automatically synchronizes with Karakeep and provides a simple API for querying and integration.

When to use it

  • Find related articles: Discover bookmarks that cover similar topics even if they don't share the same keywords.
  • Recall forgotten information: Locate bookmarks based on vague memories of their content ("that article about project management").
  • Integrate with other tools: Use the API to search your Karakeep bookmarks from within Clawdis or custom applications.
  • Keep your bookmark index up-to-date: The auto-sync feature ensures new bookmarks are immediately indexed for searching.

Key capabilities

  • Semantic Search: Searches based on meaning, not just keywords.
  • Vector Embeddings: Converts bookmark content into searchable vectors using OpenAI or Ollama models.
  • Automatic Synchronization: Automatically indexes new Karakeep bookmarks.
  • REST API: Provides endpoints for searching, syncing, and health checks.

Example prompts

  • /search?q=time management techniques&limit=5 - Find the top 5 bookmarks related to time management.
  • /sync – Manually trigger a synchronization of Karakeep bookmarks.
  • /health – Check the service's health status.

Tips & gotchas

  • You need either an OpenAI API key or Ollama running for embedding generation. Choose your preferred method by configuring OPENAI_API_KEY or OLLAMA_URL in the .env file.
  • Ensure your Karakeep instance is accessible and that you have a valid API key configured within the service.

Requirements

Environment variables

KARAKEEP_SEMANTIC_URL

This skill expects these to be set in its environment — it will have access to their values.

Tags

bookmarkssearchsemantickarakeepembeddingsrag