# searchio

> searchio is an open-source MCP server for web search and scraping. Keyless web search, page reading and product lookup for agents, with a bot-wall ladder. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://www.ioservices.io/searchio
- **Repository:** https://github.com/ioserviceslabs/searchio
- **MCP Registry name:** io.github.IOServicesLabs/searchio
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-16

## About

Search and page reading need no API keys. Results are fused and ranked across several keyless providers, and each answer reports which providers were used, failed or skipped, so a walled page returns a 451 and a provider failure a 502 or 503 instead of an empty result.

The distinctive part is the three-tier fetch ladder: plain HTTP first, then TLS impersonation, then a Rust engine sidecar or Chromium for challenge pages, with the tier learned and cached per domain. The vendor positions this as getting past bot walls, which some site operators will object to, so use it within the terms of the sites you read. The MCP server offers six tools for search, URL reading, product and local listings, research and health stats. Product lookup merges prices across retailers and can read Facebook Marketplace by city anonymously. A research swarm plans, searches, reads and cross-checks with citations, and it is the only part that calls a paid model.

It is Apache-2.0, runs from pip, Docker or npx, can also serve HTTP, and speaks the x402 payment shape when hosted.

## Features

- **Keyless search:** Fused, ranked results from multiple providers with no API keys.
- **Three-tier fetch ladder:** HTTP, TLS impersonation, then browser engine for challenge pages.
- **Honest status codes:** Reports 451 and 502 or 503 instead of empty pages.
- **Product lookup:** Prices merged across retailers and marketplace listings.
- **Research swarm:** Multi-step research with citations to pages read.
- **Three interfaces:** CLI, MCP and HTTP share one engine and cache.

## Good for

- Give an agent web search without API keys
- Read a JavaScript-only or bot-protected page
- Compare a product's price across retailers
- Run a cited multi-step research question

## Install

### Claude Code (Terminal)

```sh
claude mcp add searchio -- npx -y @ioserviceslabs/searchio-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "searchio": {
      "command": "npx",
      "args": [
        "-y",
        "@ioserviceslabs/searchio-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "searchio": {
      "command": "npx",
      "args": [
        "-y",
        "@ioserviceslabs/searchio-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "searchio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ioserviceslabs/searchio-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "searchio": {
      "command": "npx",
      "args": [
        "-y",
        "@ioserviceslabs/searchio-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "searchio": {
      "command": "npx",
      "args": [
        "-y",
        "@ioserviceslabs/searchio-mcp"
      ]
    }
  }
}
```

## FAQ

### Does it need API keys?

No for search and reading; only the research swarm needs a paid model key.

### How do I install it?

pip, Docker or the npx launcher.

### What happens when a page is blocked?

It returns a 451 rather than an empty page.

### What license is it?

Apache-2.0.

### Is searchio free?

Yes. searchio is open source, so you can use and self-host it for free.

### How do I add searchio to Claude Code?

Run this command in your terminal: claude mcp add searchio -- npx -y @ioserviceslabs/searchio-mcp

### What are the best alternatives to searchio?

The closest alternatives to searchio are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/searchio
