Karakeep Semantic Search
Semantic search sidecar for Karakeep bookmarks. Find bookmarks by meaning, not just keywords. Uses vector embeddings for intent-aware retrieval.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add karakeep-semantic npx -- -y @trustedskills/karakeep-semantic
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"karakeep-semantic": {
"command": "npx",
"args": [
"-y",
"@trustedskills/karakeep-semantic"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
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_KEYorOLLAMA_URLin the.envfile. - Ensure your Karakeep instance is accessible and that you have a valid API key configured within the service.
Requirements
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Installing this skill downloads the exact code at commit ed1fa2d4, not the current state of the repository. This prevents supply-chain attacks from unauthorized updates.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.
Install command fetches the verified snapshot, not the live repository.