Skip to main content

Commercial-grade search quality. Zero keys. Zero bills.

Project description

Searchpin

PyPI version Python License Docker

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-setup

Configuration

Claude Desktop / Cursor / any MCP client

Add to your mcpServers config:

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

VS Code

Install in VS Code Install in VS Code Insiders

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

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

Docker

docker 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()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

searchpin-1.0.3.tar.gz (41.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

searchpin-1.0.3-py3-none-any.whl (40.4 kB view details)

Uploaded Python 3

File details

Details for the file searchpin-1.0.3.tar.gz.

File metadata

  • Download URL: searchpin-1.0.3.tar.gz
  • Upload date:
  • Size: 41.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for searchpin-1.0.3.tar.gz
Algorithm Hash digest
SHA256 4f756c7ec5b3b3adbb538f5a790c3b2b0c1ebe7c9ff757e457d1e61d5d1d219a
MD5 6ec5807ca830ce750da02d809b2b9a08
BLAKE2b-256 b620058120c0ffcd17c4cdf1c7857d43c5daabfbc22d355a6cbad4d410da8775

See more details on using hashes here.

Provenance

The following attestation bundles were made for searchpin-1.0.3.tar.gz:

Publisher: pypi-publish.yml on telly6/searchpin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file searchpin-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: searchpin-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 40.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for searchpin-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3e477b3a94b87a8be208c357af24197208bc6b7c4d759cb89ae0fd8a1dd3f23b
MD5 ad732a1d35a7e229d8428455e30fec72
BLAKE2b-256 cef7051fec24a23f18d230f54f5a5621b8c2266a371ab290d30b57eafe35f483

See more details on using hashes here.

Provenance

The following attestation bundles were made for searchpin-1.0.3-py3-none-any.whl:

Publisher: pypi-publish.yml on telly6/searchpin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page