{
  "markdown": "<!-- mcp-name: io.github.telly6/searchpin -->\n\n[English](./README.md) | [简体中文](./README_zh.md)\n\n# Searchpin\n\n[![PyPI version](https://img.shields.io/pypi/v/searchpin)](https://pypi.org/project/searchpin/)\n[![Python](https://img.shields.io/pypi/pyversions/searchpin)](https://pypi.org/project/searchpin/)\n[![License](https://img.shields.io/pypi/l/searchpin)](LICENSE)\n[![Docker](https://img.shields.io/badge/docker-ghcr.io-blue)](https://github.com/telly6/searchpin/pkgs/container/searchpin)\n\nSelf-hosted web search for AI agents — zero API keys, zero cost. In 2026, the center of gravity in AI development is shifting from \"chatting\" to \"autonomous task execution\" — locally deployed, long-running agents are becoming the norm. When an agent runs 24/7, every web search must not be interrupted by API quotas or billing. Searchpin was designed for this from day one: zero external dependencies, zero usage limits. Agents can search, fetch, and verify without restriction, and developers never worry about cost.\n\n## Why Searchpin\n\n### 🇨🇳 Optimized for Chinese Network Environments\n\nDefaults to **Baidu, Sogou, Bing CN, and Bing Intl** — four search engines queried in parallel. Works natively within China's network, no proxy or VPN needed. Most overseas alternatives rely on Google, DuckDuckGo, or Brave, which are largely inaccessible inside China.\n\n### 🧠 Semantic Re-ranking — a Differentiator Few Offer\n\nResults from all four engines are not simply concatenated. They are merged and re-ranked by an embedding model based on semantic similarity to the query. What your AI receives is a curated list of high-quality results, not a pile of noisy links. Among free MCP search servers, very few offer this capability.\n\n### 💰 Completely Free, Zero Barrier\n\nNo account registration, no API key application, no usage limits. No dependency on any commercial API — no risk of sudden paywalls or quota restrictions. The entire pipeline runs on your own machine.\n\n### 🔍 Built for Modern Websites\n\nBuilt-in SSR content extraction can parse pages rendered by Next.js, Nuxt, and similar frameworks, and extract JSON-LD structured data and microdata. Plain HTML scraping gets nothing from these sites.\n\n### 🛡️ Pollution Detection + Cross-Verification\n\nAutomatically detects and flags results unrelated to your query. Four independent search engines provide cross-verifiable results, enabling your LLM to corroborate information across sources for more credible answers.\n\n### ⚡ Deliberate Engineering Trade-offs\n\nEvery design decision was made with real-world usage in mind:\n\n- **Token-conscious** — Search results return only titles, URLs, and snippets. Structured extraction data is compact and truncated. Your LLM decides which pages are worth fetching in full, without wasting context window.\n- **Fast response** — Four engines queried asynchronously in parallel. Total time depends on the slowest engine, not the sum of all four. A typical search completes in 1–2 seconds.\n- **Memory-friendly** — The embedding model (~118MB) is downloaded once through hf-mirror.com (HuggingFace mirror for China), then reused from local cache.\n\n## Quick Start\n\n```bash\npip install searchpin && searchpin-setup\n```\n\nOn first run, the embedding model (~118MB) is downloaded once via hf-mirror.com (HuggingFace mirror for China). That is the only one-time setup.\n\n## Configuration\n\n### Claude Desktop / Cursor / any MCP client\n\nAdd to your `mcpServers` config:\n\n```json\n{\n  \"mcpServers\": {\n    \"Searchpin\": {\n      \"command\": \"searchpin-server\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### VS Code\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Searchpin&config=%7B%22command%22%3A%22searchpin-server%22%2C%22args%22%3A%5B%5D%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Searchpin&config=%7B%22command%22%3A%22searchpin-server%22%2C%22args%22%3A%5B%5D%7D&quality=insiders)\n\nOr manually, add to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"Searchpin\": {\n      \"command\": \"searchpin-server\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### Docker\n\n```bash\ndocker run -i --rm ghcr.io/telly6/searchpin:latest\n```\n\n### Python API\n\n```python\nfrom searchpin import SearchEngine\n\nengine = SearchEngine()\nresults = engine.search(\"Python 3.13 新特性\")\npage = engine.fetch(\"https://docs.python.org/3/whatsnew/3.13.html\")\nengine.close()\n```\n\n\n\n",
  "bytes": 4602,
  "sha": "2402c727d1adc9c1eea736b3e8ee23fb467b92a11cf142c9aa9127b1c6388518",
  "repo_slug": "telly6/searchpin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_telly6_searchpin_cede63de/readme"
}