Outscraper

Extraer datos de Google Maps, incluyendo lugares y reseñas, utilizando la API de Outscraper.

GitHub
3
Prueba este MCPPatrocinado

Documentación

MseeP.ai Security Assessment Badge

Servidor MCP de Outscraper

smithery badge PyPI version Python 3.10+

Un servidor Model Context Protocol (MCP) optimizado que proporciona acceso a los servicios de extracción de datos de Google Maps de Outscraper. Este servidor implementa 2 herramientas esenciales para extraer datos de Google Maps con alta fiabilidad.

Outscraper Server MCP server

🚀 Características

Extracción de datos de Google Maps

  • 🗺️ Búsqueda en Google Maps - Busca negocios y lugares con información detallada
  • ⭐ Reseñas de Google Maps - Extrae reseñas de clientes de cualquier lugar de Google Maps

Capacidades avanzadas

  • Enriquecimiento de datos - Mejora los resultados con información de contacto adicional mediante el parámetro de enriquecimiento
  • Soporte multilingüe - Busca y extrae datos en diferentes idiomas
  • Filtrado regional - Apunta a países/regiones específicos para obtener resultados localizados
  • Ordenación flexible - Ordena las reseñas por relevancia, fecha, calificación, etc.
  • Filtrado por tiempo - Filtra las reseñas por fecha usando el parámetro de corte
  • Soporte de alto volumen - Gestiona el procesamiento asíncrono para solicitudes grandes automáticamente

📦 Instalación

Instalación mediante Smithery (Recomendado)

Para instalar el servidor MCP de Outscraper para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install outscraper-mcp --client claude

Instalación mediante PyPI

# Using pip
pip install outscraper-mcp

# Using uv (recommended)
uv add outscraper-mcp

# Using uvx for one-time execution
uvx outscraper-mcp

Instalación manual

git clone https://github.com/jayozer/outscraper-mcp
cd outscraper-mcp

# Using uv (recommended)
uv sync

# Using pip
pip install -e .

🔧 Configuración

Obtén tu clave de API

  1. Regístrate en Outscraper
  2. Obtén tu clave de API desde la página de perfil

Configura la variable de entorno

export OUTSCRAPER_API_KEY="your_api_key_here"

O crea un archivo .env:

OUTSCRAPER_API_KEY=your_api_key_here

🛠️ Configuración del cliente

Claude Desktop

Añade a tu claude_desktop_config.json:

Mediante Smithery (Automático):

{
  "mcpServers": {
    "outscraper": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Mediante instalación local:

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Mediante instalación manual:

{
  "mcpServers": {
    "outscraper": {
      "command": "uv",
      "args": ["run", "python", "-m", "outscraper_mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor AI

Instalación automática con UVX (Recomendado):

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Instalación manual:

{
  "mcpServers": {
    "outscraper": {
      "command": "outscraper-mcp",
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Nota para usuarios de Cursor: El archivo de configuración normalmente se encuentra en:

  • macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

🛠️ Referencia de herramientas

google_maps_search

Busca negocios y lugares en Google Maps

# Parameters:
query: str              # Search query (e.g., 'restaurants brooklyn usa')
limit: int = 20         # Number of results (max: 400)
language: str = "en"    # Language code
region: str = None      # Country/region code (e.g., 'US', 'GB')
drop_duplicates: bool = False  # Remove duplicate results
enrichment: List[str] = None   # Additional services ['domains_service', 'emails_validator_service']

google_maps_reviews

Extrae reseñas de lugares de Google Maps

# Parameters:
query: str              # Place query, place ID, or business name
reviews_limit: int = 10 # Number of reviews per place (0 for unlimited)
limit: int = 1          # Number of places to process
sort: str = "most_relevant"  # Sort order: 'most_relevant', 'newest', 'highest_rating', 'lowest_rating'
language: str = "en"    # Language code
region: str = None      # Country/region code
cutoff: int = None      # Unix timestamp for reviews after specific date

🚀 Ejecución del servidor

Desarrollo y pruebas

# FastMCP Inspector - Web-based testing dashboard
fastmcp dev outscraper_mcp/server.py

# Then open your browser to: http://127.0.0.1:6274
# Interactive testing of Google Maps tools with real-time responses

Transporte Stdio (predeterminado)

# Via PyPI installation
outscraper-mcp

# Via uv
uv run python -m outscraper_mcp

# Via manual installation
python -m outscraper_mcp

Transporte HTTP

from outscraper_mcp import mcp

if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="127.0.0.1", port=8000)

💡 Ejemplos de uso

Ejemplo 1: Encuentra restaurantes y obtén reseñas

# 1. Search for restaurants
results = google_maps_search(
    query="italian restaurants manhattan nyc",
    limit=5,
    language="en",
    region="US"
)

# 2. Get reviews for a specific place
reviews = google_maps_reviews(
    query="ChIJrc9T9fpYwokRdvjYRHT8nI4",  # Place ID from search results
    reviews_limit=20,
    sort="newest"
)

Ejemplo 2: Generación de clientes potenciales con enriquecimiento

# Find businesses with enhanced contact information
businesses = google_maps_search(
    query="digital marketing agencies chicago",
    limit=20,
    enrichment=["domains_service", "emails_validator_service"]
)

# Get detailed reviews for sentiment analysis
for business in businesses:
    if business.get('place_id'):
        reviews = google_maps_reviews(
            query=business['place_id'],
            reviews_limit=10,
            sort="newest"
        )

Ejemplo 3: Investigación de mercado

# Research competitors in specific area
competitors = google_maps_search(
    query="coffee shops downtown portland",
    limit=50,
    region="US"
)

# Analyze recent customer feedback
recent_reviews = google_maps_reviews(
    query="coffee shops downtown portland",
    reviews_limit=100,
    sort="newest"
)

🔄 Integración con clientes MCP

Este servidor es compatible con cualquier cliente MCP, incluyendo:

📊 Límites de velocidad y precios

  • Consulta Precios de Outscraper para conocer las tarifas actuales
  • El uso de la clave de API se registra por solicitud
  • Considera implementar caché para los datos a los que se accede con frecuencia

🐛 Solución de problemas

Problemas comunes

  1. Error de importación: Asegúrate de haber instalado el paquete correctamente

    pip install --upgrade outscraper-mcp

  2. Error de clave de API: Verifica que tu clave de API esté configurada correctamente

    echo $OUTSCRAPER_API_KEY

  3. Sin resultados: Comprueba si tus parámetros de consulta son válidos

  4. Límites de velocidad: Implementa retrasos entre solicitudes si es necesario

Habilitar registro de depuración

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Añade pruebas
  5. Envía una solicitud de extracción (pull request)

📄 Licencia

Licencia de software experimental: consulta el archivo LICENSE para obtener más detalles.

Aviso: Este software es experimental y de uso gratuito para todos los fines. Creado por Jay Ozer.

🔗 Enlaces

Construido con Blu Goldens