searchpin 1.0.0

Self-hosted web search for AI agents — zero API keys, embedding re-rank, multi-engine parallel search

Searchpin

Self-hosted web search for AI agents — zero API keys, zero cost. pip install searchpin and you're done.

• Search quality rivals commercial products — four search engines in parallel (Baidu, Sogou, Bing CN, Bing Intl), merged and re-ranked by semantic similarity. A rare capability among free MCP search tools.
• Zero-cost agent development — no API keys, no sign-ups, no usage limits. Pair with a local LLM and your entire development loop costs nothing. Run 24/7 agent experiments without worrying about quotas.
• Pollution detection — automatically flags results that are unrelated to your query, so your agent doesn't chase irrelevant content.
• Cross-verification — results from four independent sources let your LLM corroborate information across engines, raising the credibility of what it finds.
• Content extraction that handles modern sites — goes beyond basic HTML-to-text to extract SSR hydration payloads (Next.js, Nuxt), JSON-LD structured data, and microdata from pages that would otherwise return empty.
• Token-conscious output — results are titles, URLs, and snippets only. Your LLM decides which pages are worth fetching in full. Structured extraction data is compact and truncated, keeping token overhead under control.

Quick Start

pip install searchpin
searchpin-server

Configuration

Claude Desktop / Cursor / any MCP client

Add to your mcpServers config:

{
  "mcpServers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}

VS Code

Or manually, add to .vscode/mcp.json:

{
  "servers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}

Docker

docker run -i --rm ghcr.io/telly6/searchpin:latest

{
  "mcpServers": {
    "Searchpin": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/telly6/searchpin:latest"]
    }
  }
}

Python API

from searchpin import SearchEngine

engine = SearchEngine()
results = engine.search("Python 3.13 new features")
page = engine.fetch("https://docs.python.org/3/whatsnew/3.13.html")
engine.close()