gmapsscraper

Extrae leads de negocios de Google Maps (nombres, teléfonos, correos electrónicos, sitios web, calificaciones) desde Claude, Cursor o cualquier cliente MCP a través de la API de gmapsscraper.io.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP de gmapsscraper

npm version license

Servidor MCP (Protocolo de Contexto de Modelo) para gmapsscraper.io — permite a Claude, Cursor, Windsurf y cualquier cliente MCP extraer datos de empresas de Google Maps en conversación natural: nombres, direcciones, teléfonos, correos electrónicos, sitios web, calificaciones, cantidad de reseñas, categorías y coordenadas.

"Encuentra 50 dentistas en Chicago con sus correos electrónicos" → hecho, directamente en tu chat de IA.

Herramientas

HerramientaQué hace
scrape_google_mapsBusca en Google Maps y devuelve prospectos de empresas (se bloquea hasta terminar, ~30–120 s)
start_scrape_jobVersión de "dispara y olvida" — devuelve un ID de trabajo inmediatamente
get_scrape_resultsObtiene los resultados de un trabajo iniciado previamente
get_creditsVerifica el saldo de créditos restante

Cada extracción cuesta 2 créditos; varias palabras clave en una sola llamada cuestan lo mismo. Nivel gratuito: 10 créditos (5 búsquedas, sin tarjeta de crédito) — obtén una clave de API en gmapsscraper.io/dashboard.

Configuración

Claude Code

claude mcp add gmapsscraper -e GMAPSSCRAPER_API_KEY=your_key -- npx -y @gmapsscraper/mcp

Claude Desktop / Cursor / Windsurf

Agrega a tu configuración de MCP (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "gmapsscraper": {
      "command": "npx",
      "args": ["-y", "@gmapsscraper/mcp"],
      "env": {
        "GMAPSSCRAPER_API_KEY": "your_key"
      }
    }
  }
}

Directorio de Cursor / Open Plugins

Instalar desde un directorio de plugins usa el mcp.json incluido, que deliberadamente se distribuye sin un bloque env — la especificación de Open Plugins solo expande ${PLUGIN_ROOT} y ${PLUGIN_DATA}, por lo que un marcador de secreto se pasaría literalmente y el servidor no podría autenticarse.

Configura la clave en tu propio entorno antes de iniciar el cliente:

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
export GMAPSSCRAPER_API_KEY=your_key

# Windows PowerShell
setx GMAPSSCRAPER_API_KEY "your_key"

Reinicia el cliente después para que tome la variable. Si una extracción devuelve un error de autenticación, ejecuta get_credits primero — falla rápido y confirma si la clave está siendo detectada.

Requiere Node.js ≥ 18. El servidor se ejecuta localmente a través de stdio y se comunica con la API de gmapsscraper.io — no involucra otra infraestructura.

Ejemplos de indicaciones

  • "Extrae cafeterías en Austin TX con correos electrónicos y dame una tabla"
  • "Encuentra plomeros en Miami, luego redacta un correo en frío para los 5 mejores por calificación"
  • "Inicia una extracción para 'fotógrafo de bodas en Denver CO', volveré más tarde"
  • "¿Cuántos créditos de gmapsscraper me quedan?"

Datos devueltos por empresa

title, address, phone, email, website, rating, reviews_count, category, latitude, longitude, google_maps_url, opening_hours

Los resultados están limitados a 100 empresas por respuesta para mantener tu contexto ordenado; el CSV completo siempre está disponible desde el panel de control.

Relacionados

Licencia

MIT © gmapsscraper.io