# SearXNG Search

> SearXNG Search is an open-source MCP server for web search and scraping. MCP server for web search and page reading through a SearXNG instance. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://www.npmjs.com/package/mcp-searxng
- **Repository:** https://github.com/ihor-sokoliuk/mcp-searxng
- **GitHub stars:** 1,368
- **License:** MIT
- **MCP Registry name:** io.github.ihor-sokoliuk/mcp-searxng
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-14

## About

This MCP server connects AI assistants to a SearXNG search instance. It offers web search with pagination and filters, reading of web pages, structured text and PDF text, and discovery of the instance's capabilities.

It does not install SearXNG; you need an instance with JSON search enabled, either self-run or trusted. It runs locally over stdio via npx or Docker, or as a Streamable HTTP service with bearer or OAuth protection. Privacy depends on the SearXNG deployment you choose.

It is for developers who want search in Claude, Cursor and similar clients without a paid search API.

## Features

- **Paginated search:** Web search with filters and direct answers.
- **URL reading:** Reads HTML, text and bounded PDF content.
- **Instance discovery:** Reports instance capabilities and query suggestions.
- **Flexible transports:** Local stdio or Streamable HTTP.
- **Resilience options:** Optional failover, caching, proxies and HTML fallback.

## Good for

- Give an assistant web search without a vendor API key
- Read a page's content during research
- Use a self-hosted private search backend
- Run a shared HTTP search service for a team

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxng
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-searxng": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `searxng_web_search`: Search the web through SearXNG
- `searxng_instance_info`: Report instance capabilities
- `searxng_search_suggestions`: Get query suggestions

## FAQ

### What do I need first?

A SearXNG instance with JSON search enabled; the server does not install one.

### Does it need a paid search API key?

No, but you operate or choose the SearXNG instance.

### Is it private?

Privacy depends on the SearXNG deployment; a public instance may log queries.

### Is SearXNG Search free?

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

### How do I add SearXNG Search to Claude Code?

Run this command in your terminal: claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxng

### What are the best alternatives to SearXNG Search?

The closest alternatives to SearXNG Search are Scrapling MCP Server, Firecrawl MCP Server, NeuralVerge, AI-Powered directory and Shopify MCP Server (any store).

## 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.
- [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.
- [Vidtrawl: YouTube Search Scraper & Trending Videos (Official API)](https://ai-powered.com/mcp/vidtrawl-youtube-search-scraper-and-trending-videos-official): Vidtrawl: YouTube Search Scraper & Trending Videos (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/searxng-search
