Skip to main content
Glama
OneSearch MCP Server

OneSearch MCP Server

by yokingma

🚀 Servidor MCP OneSearch: Búsqueda Web, Rastreo, Scraper y Preparación de Contenido

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que se integra con múltiples proveedores de búsqueda para realizar búsquedas web, búsquedas en navegador local y capacidades de scraping con agent-browser.

Características

  • Búsqueda web, scraping, rastreo y preprocesamiento de contenido de sitios web.

  • Soporte para múltiples motores de búsqueda y scrapers web: SearXNG, Tavily, DuckDuckGo, Bing, Google, Zhipu (智谱), Exa, Bocha (博查), etc.

  • Búsqueda web local (búsqueda en navegador), soporte para múltiples motores de búsqueda: Bing, Google, Baidu, Sogou, etc.

    • Utiliza agent-browser para la automatización del navegador.

    • Gratuito, no requiere claves API.

  • Herramientas habilitadas: one_search, one_scrape, one_map, one_extract

Related MCP server: Firecrawl MCP Server

Migración desde v1.1.0 y versiones anteriores

Cambios importantes en la v1.1.0:

  • Se eliminó Firecrawl: La integración con Firecrawl se ha eliminado en favor de agent-browser, que proporciona una funcionalidad similar sin requerir servicios API externos.

  • Nuevo requisito de navegador: Debe instalar el navegador Chromium (consulte la sección de Requisitos previos).

  • Variables de entorno: FIRECRAWL_API_URL y FIRECRAWL_API_KEY ya no se utilizan.

Qué ha cambiado:

  • one_scrape y one_map ahora utilizan agent-browser en lugar de Firecrawl

  • one_extract ahora preprocesa el contenido de páginas con múltiples URL para análisis posterior en lugar de realizar una extracción LLM integrada

  • Todas las operaciones basadas en navegador ahora se manejan localmente, proporcionando una mejor privacidad y sin costos de API

Pasos de migración:

  1. Instale el navegador Chromium (consulte Requisitos previos)

  2. Elimine FIRECRAWL_API_URL y FIRECRAWL_API_KEY de sus variables de entorno

  3. Actualice a la última versión: npm install -g one-search-mcp@latest

Requisitos previos

Requisito de navegador: Este servidor utiliza agent-browser para el web scraping y la búsqueda local, lo cual requiere un navegador basado en Chromium.

Buenas noticias: El servidor detectará y utilizará automáticamente los navegadores ya instalados en su sistema:

  • ✅ Google Chrome

  • ✅ Microsoft Edge

  • ✅ Chromium

  • ✅ Google Chrome Canary

Si no tiene instalado ninguno de estos navegadores, puede:

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

Instalación

Usando la CLI de Claude Code (Recomendado)

# Add to Claude Code with default settings (local search)
claude mcp add one-search-mcp -- npx -y one-search-mcp

# Add with custom search provider (e.g., SearXNG)
claude mcp add one-search-mcp -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 -- npx -y one-search-mcp

# Add with Tavily API
claude mcp add one-search-mcp -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key -- npx -y one-search-mcp

Instalación manual

# Install globally (Optional)
npm install -g one-search-mcp

# Or run directly with npx
npx -y one-search-mcp

Usando Docker

La imagen de Docker incluye todas las dependencias (navegador Chromium) preinstaladas, no se requiere configuración adicional.

Descargue la imagen:

# From GitHub Container Registry
docker pull ghcr.io/yokingma/one-search-mcp:latest

# Or from Docker Hub
docker pull zacma/one-search-mcp:latest

Configure con Claude Desktop:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yokingma/one-search-mcp:latest"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Con un proveedor de búsqueda personalizado:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARCH_PROVIDER=tavily",
        "-e", "SEARCH_API_KEY=your_api_key",
        "ghcr.io/yokingma/one-search-mcp:latest"
      ]
    }
  }
}

Variables de entorno

Motor de búsqueda:

  • SEARCH_PROVIDER (Opcional): El proveedor de búsqueda a utilizar, admite searxng, duckduckgo, bing, tavily, google, zhipu, exa, bocha, local, el valor predeterminado es local.

  • SEARCH_API_URL (Opcional): La URL de la API de SearxNG, o el ID del Motor de Búsqueda Personalizado de Google para google.

  • SEARCH_API_KEY (Opcional): La clave API para el proveedor de búsqueda, requerida para tavily, bing, google, zhipu, exa, bocha.

// supported search providers
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'google' | 'zhipu' | 'exa' | 'bocha' | 'local';

Configuración del proveedor de búsqueda

Proveedor

Clave API requerida

URL API requerida

Notas

local

No

No

Gratuito, utiliza automatización de navegador

duckduckgo

No

No

Gratuito, no se necesita clave API

searxng

Opcional

Sí

Motor de metabúsqueda autohospedado

bing

Sí

No

Bing Search API

tavily

Sí

No

Tavily API

google

Sí

Sí (ID de motor de búsqueda)

Google Custom Search

zhipu

Sí

No

智谱 AI

exa

Sí

No

Exa AI

bocha

Sí

No

博查 AI

Configuración para otros clientes MCP

Claude Desktop

Agréguelo a su archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Cursor

Agréguelo a su archivo mcp.json:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Windsurf

Agréguelo a su archivo ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Autohospedaje de SearXNG (Opcional)

Si desea utilizar SearXNG como su proveedor de búsqueda, puede desplegarlo localmente usando Docker:

Requisitos previos:

  • Docker instalado y en ejecución (versión 20.10.0 o superior)

  • Al menos 4GB de RAM disponibles

Inicio rápido:

# Clone SearXNG Docker repository
git clone https://github.com/searxng/searxng-docker.git
cd searxng-docker

# Start SearXNG
docker compose up -d

Después del despliegue, SearXNG estará disponible en http://127.0.0.1:8080 de forma predeterminada.

Configure OneSearch para usar SearXNG:

# Set environment variables
export SEARCH_PROVIDER=searxng
export SEARCH_API_URL=http://127.0.0.1:8080

Para obtener más detalles, consulte la documentación oficial de SearXNG Docker.

Solución de problemas

Error de navegador no encontrado

Si ve un error como "Browser not found", el servidor no pudo detectar ningún navegador basado en Chromium instalado. Por favor, instale uno de los siguientes:

O instálelo a través de agent-browser:

npx agent-browser install

Licencia

Licencia MIT - consulte el archivo LICENSE para obtener más detalles.

Available Tools

4 tools
one_extractA

Fetch and preprocess page content from one or more URLs. Returns cleaned text blocks that can be passed to downstream tools or models.

Inputs: urls (required).

one_mapA

Discover URLs from a starting point by loading a page in the browser and extracting links from its HTML.

Inputs: url (required), limit, search, includeSubdomains.

one_scrapeA

Scrape a single webpage and return markdown, HTML, links, or a screenshot. Supports navigation timeout, TLS verification control, full-page screenshots, bounded pre-scrape actions, and advanced executeJavascript only when allowExecuteJavascript is true.

Inputs: url (required), actions, formats, timeout, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool has a distinct core function: search returns SERP results, extract preprocesses multiple URLs, scrape handles single-page advanced operations, and map discovers links. There is minor overlap between extract and scrape for fetching page content, but their descriptions make the intended use cases clear.

    Naming Consistency5/5

    All tool names follow the consistent pattern 'one_' prefix followed by a lowercase action verb (search, extract, scrape, map), with underscores between words. No mixed conventions or camelCase.

    Tool Count5/5

    Four tools is well within the ideal range for a focused search/scraping server. Each tool covers a distinct aspect of web research, making the set feel appropriately scoped without being bloated.

    Completeness4/5

    The tool set covers the primary workflows: searching, extracting content, single-page scraping with advanced options, and link discovery. Minor gaps exist, such as no dedicated batch scraping tool, but the combined functionality handles most common use cases.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
      5
      34 npm
      16
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables web scraping, crawling, and content extraction capabilities through integration with Firecrawl.
      8
      2
      MIT