🚀 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: MCP Web Tools 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

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:

• Google Chrome: https://www.google.com/chrome/

• Microsoft Edge: https://www.microsoft.com/edge

• Chromium: https://www.chromium.org/getting-involved/download-chromium/

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.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• one_extractA
• one_mapB
• one_scrapeC
• one_searchB