# OpenSERP

> OpenSERP is a freemium MCP server for web search and scraping. Live results from six search engines with original ranks, plus page extraction. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, self-hosted
- **Website:** https://openserp.org
- **Repository:** https://github.com/openserpapi/mcp
- **MCP Registry name:** org.openserp/mcp
- **Categories:** web search and scraping, marketing and SEO
- **Listing updated:** 2026-11-14

## About

Results keep the engine they came from and their original rank, so an agent can compare engines or pick one on purpose, such as Yandex for Russian or Baidu for Chinese. Four search modes cover different needs: a named engine, a preferred engine with ordered fallbacks, the healthiest fast engine, or a merged multi-engine search. Image search and page extraction to Markdown are included.

It runs over stdio from npm. Without an API key it talks to a self-hosted OpenSERP server at localhost:7000; with OPENSERP_API_KEY it uses OpenSERP Cloud, billed in credits that never expire, with 60 free credits to start. Failed and empty requests cost nothing.

Extraction trims long pages to 20,000 characters, or 40,000 across a batch of up to 20 URLs, and marks truncated output so the agent can ask for more.

## Features

- **Six engines:** Google, Bing, Yandex, Baidu, DuckDuckGo and Ecosia through one tool set.
- **Fallback modes:** any_search and fast_search choose a working engine for you.
- **Batch extraction:** Read up to 20 URLs at once; a dead link doesn't fail the batch.
- **Regional reads:** Pass a region such as DE to read a geo-fenced page.
- **Self-host or cloud:** Use your own OpenSERP server or the paid cloud API.

## Good for

- Ground an answer in live search results
- Compare Google and Bing rankings for a keyword
- Extract clean Markdown from a URL before prompting a model
- Search Chinese or Russian web with the matching engine

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env OPENSERP_API_KEY='<OPENSERP_API_KEY>' -- npx -y @openserp/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search`: Search one chosen engine, with paging.
- `any_search`: Preferred engine with fallbacks in your order.
- `fast_search`: Picks the healthiest, fastest engine.
- `mega_search`: Compares or merges several engines.
- `image_search`: Images from one engine.
- `mega_image`: Images merged from several engines.
- `extract`: Reads one page as Markdown.
- `batch_extract`: Reads up to 20 pages in one call.
- `list_engines`: Shows engine capabilities and health.
- `get_usage`: Cloud credit balance or last call cost.

## FAQ

### Do I need an API key?

No, if you run a self-hosted OpenSERP server. The cloud API needs OPENSERP_API_KEY.

### What does the cloud cost?

Credits start around 0.0078 USD each, one credit per web search page of up to 10 results; 60 credits are free.

### Are failed requests charged?

No. Errors, timeouts and empty result pages are free.

### Is the engine open source?

Yes. The OpenSERP engine is MIT licensed and runs from Docker or a Go binary.

### Is OpenSERP free?

OpenSERP has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add mcp --env OPENSERP_API_KEY='<OPENSERP_API_KEY>' -- npx -y @openserp/mcp

### What are the best alternatives to OpenSERP?

The closest alternatives to OpenSERP are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

## 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.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [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.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.

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