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.5.tar.gz (45.3 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.5-py3-none-any.whl (44.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: searchpin-1.0.5.tar.gz
  • Upload date:
  • Size: 45.3 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.5.tar.gz
Algorithm Hash digest
SHA256 9ce41a2cd99a846756fb516ab5671cf851a9c3ca7520cc694abeaee361ed8a86
MD5 9e1989665fe067db2b53a652da307297
BLAKE2b-256 8dfd415c3624fd2332c0ca412aacb01750eb4b4f5e40a33bcfa9bebdf1769328

See more details on using hashes here.

Provenance

The following attestation bundles were made for searchpin-1.0.5.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.5-py3-none-any.whl.

File metadata

  • Download URL: searchpin-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 44.1 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 14c45c8731f491c36785521753cd4a6e13b97dc12f439eeb8a3bc2512499bb15
MD5 9f5d89beb0c835eeb94edc162016f6c0
BLAKE2b-256 aa0adcd958688930edfbf8ddc2e5233c94a8ccc6f635d9513b15679d3857e313

See more details on using hashes here.

Provenance

The following attestation bundles were made for searchpin-1.0.5-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