Searchpin — Claude Code MCP server: web search
A self-hosted MCP server that searches several engines and fetches pages. It suits agents that need web research without API keys or quotas.
claude mcp add searchpin -- uvx searchpinWhat Searchpin — Free Web Search for AI Agents does
Searchpin runs a local MCP server for web search and page retrieval. It queries Baidu, Sogou, Bing CN, and Bing Intl in parallel, combines the responses, then orders them by semantic similarity to the query. Search output stays compact, with titles, URLs, and snippets, while the agent chooses which pages to fetch.
The server can extract content from sites built with Next.js, Nuxt, and similar frameworks, along with JSON-LD and microdata. web_fetch identifies PDFs and returns locally extracted text with page labels. Extraction stops at 25 MiB, 200 pages, or 2 million characters. Image-only PDFs produce an error because OCR is outside the server.
Add it to Claude Code with claude mcp add searchpin -- uvx searchpin. The first launch downloads an embedding model of about 118MB through hf-mirror.com and keeps it in the local cache.
What it helps with
- search across four engines in parallel
- rank results by meaning instead of URL order
- read content from Next.js and Nuxt pages
- extract page-labelled text from PDFs
- cross-check claims across independent search results
Example prompts for the agent
- Search the web for current information about this library and compare the returned sources.
- Use
web_fetchto readhttps://docs.python.org/3/whatsnew/3.13.htmland list the relevant changes. - Find a PDF about this project and return its text with page labels.
How to install Searchpin — Free Web Search for AI Agents
Platform CLI
claude mcp add searchpin -- uvx searchpinuvx runs the command named after the package; if the README names another one, use uvx --from searchpin <command>
Platform CLI
codex mcp add searchpin-free-web-search-for-ai-agents -- uvx searchpinuvx runs the command named after the package; if the README names another one, use uvx --from searchpin <command>
Config file
{
"mcpServers": {
"searchpin-free-web-search-for-ai-agents": {
"command": "uvx",
"args": [
"searchpin"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from searchpin <command>
Config file
{
"servers": {
"searchpin-free-web-search-for-ai-agents": {
"type": "stdio",
"command": "uvx",
"args": [
"searchpin"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from searchpin <command>
Platform CLI
gemini mcp add searchpin-free-web-search-for-ai-agents uvx searchpinuvx runs the command named after the package; if the README names another one, use uvx --from searchpin <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Searchpin — Free Web Search for AI Agents
How do I install Searchpin in Claude Code?
Run claude mcp add searchpin -- uvx searchpin.
What does Searchpin do?
Searchpin is a local MCP server for web search and page retrieval. It combines results from four engines and ranks them by semantic similarity.
Can Searchpin read PDFs?
Yes. web_fetch detects PDFs and extracts text with page labels. Encrypted, unreadable, and image-only files return an error, and the server has no OCR step.
