ScraperCity

oficial

Servidor MCP de generación de leads B2B - Apollo, Google Maps, buscador de correos electrónicos, skip trace y más de 15 herramientas adicionales.

GitHub

¿Qué puedes hacer con ScraperCity MCP?

Extraer negocios locales — Obtener listados de Google Maps con teléfonos, correos electrónicos y reseñas para una búsqueda y ubicación, luego consultar el estado de la ejecución y descargar un CSV.
Encontrar contactos B2B — Consultar la base de datos de clientes potenciales o extraer datos de Apollo para encontrar personas por cargo, sector y ubicación.
Validar y encontrar correos electrónicos — Verificar la entregabilidad con validate_emails o encontrar el correo electrónico de una empresa a partir de un nombre y una empresa.
Buscar números de móvil — Encontrar números de teléfono a partir de un perfil de LinkedIn o un correo electrónico, o realizar una búsqueda inversa por nombre, correo electrónico, teléfono o dirección.
Comprobar el estado de la ejecución y descargar — Seguir el progreso de una extracción y guardar los resultados finalizados como CSV cuando se complete correctamente.

Documentación

ScraperCity - Generación de leads B2B para agentes de IA

Obtén leads, valida correos electrónicos, encuentra números de móvil y extrae datos de empresas, todo desde tu agente de IA, CLI o código. Un paquete: el servidor MCP, la CLI y el SDK de JavaScript. El SDK de Python es pip install scrapercity.

ScraperCity ofrece a los agentes de IA acceso a más de 15 herramientas de datos B2B: extracción de datos de Apollo, extracción de Google Maps, búsqueda y validación de correos electrónicos, búsqueda de números de móvil, skip tracing, datos de tiendas de comercio electrónico, antecedentes penales y mucho más.

Empieza aquí (no se necesita clave de API)

npx scrapercity start "dentists in Austin"

O pídele a tu agente que invoque la herramienta MCP start_here o GET https://app.scrapercity.com/api/v1/start?query=.... Sin una clave, obtendrás un recorrido guiado: qué es ScraperCity, cómo registrarte, los planes y la prueba con sus condiciones vigentes, y búsquedas reales con recuentos actualizados. Con una clave, planifica para tu cuenta y devuelve la siguiente llamada exacta.

La prueba, sin rodeos: La prueba consiste en uso real, no es una demostración ni un nivel gratuito: $5 de crédito durante 7 días, válido para todas las herramientas y bases de datos a los precios habituales, para que puedas obtener registros reales desde el primer día y evaluar los datos. Se requiere una tarjeta al registrarse. Al terminar los 7 días, se activa el plan elegido al registrarte; cancélalo antes desde la sección de facturación y no se te cobrará nada más. Si el crédito se agota antes, las consultas a las bases de datos quedan en espera (no se cobra nada por ellas); si una ejecución del scraper supera el crédito, el plan se activa antes. Las búsquedas de planificación y la consulta de recuentos son gratuitas. start_here devuelve las condiciones vigentes.

Inicio rápido

Opción 1: CLI

npx scrapercity login            # enter your API key
npx scrapercity wallet           # check balance
npx scrapercity maps -q "plumbers" -l "Denver, CO"
npx scrapercity poll <runId>     # wait for results
npx scrapercity download <runId> # save CSV

Opción 2: Servidor MCP (Claude Code, Cursor, Windsurf, etc.)

Añádelo a tu configuración de MCP (por ejemplo, ~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "scrapercity": {
      "command": "npx",
      "args": ["-y", "--package", "scrapercity", "scrapercity-mcp"],
      "env": {
        "SCRAPERCITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Luego dile a tu IA: "Busca 1000 fontaneros en Denver con correos electrónicos usando ScraperCity"

Opción 3: Archivo de skill (Claude Code)

Copia el archivo de skill en tu proyecto:

npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md

O descárgalo desde: https://scrapercity.com/agents/SKILL.md

Luego, en Claude Code: "Lee SCRAPERCITY_SKILL.md y encuentra 2000 directores de marketing de empresas SaaS en California, valida sus correos electrónicos y guárdalos en leads.csv"

Opción 4: API directa

# Start a Maps scrape
curl -X POST https://app.scrapercity.com/api/v1/scrape/maps \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"searchStringsArray":["plumbers"],"locationQuery":"Denver, CO","maxCrawledPlacesPerSearch":500}'

# Check status
curl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

# Download CSV when SUCCEEDED
curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

Opción 5: SDK de JavaScript

npm install scrapercity

import { configure, wallet, dbLeads, callTool, TOOLS, openaiTools, anthropicTools } from 'scrapercity'

configure({ apiKey: process.env.SCRAPERCITY_API_KEY })
await wallet()
await dbLeads({ title: 'CEO', country: ['United States'], hasEmail: 'true', limit: 25 })

// Every tool the MCP server offers, by name, with the same arguments
await callTool('plan_search', { query: 'dentists in Austin, Texas' })

// Hand the whole tool list to OpenAI or Anthropic tool calling
const tools = openaiTools()        // or anthropicTools()

Opción 6: SDK de Python

pip install scrapercity                 # add [langchain] or [openai] for agent tools

from scrapercity import ScraperCity, langchain_tools
sc = ScraperCity()                      # reads SCRAPERCITY_API_KEY
sc.call_tool("query_lead_database", {"title": "CEO", "limit": 10})
tools = langchain_tools()               # LangChain / LangGraph

Ambos SDK incluyen la misma lista de herramientas que el servidor MCP, regenerada a partir de la documentación de la API en vivo con cada versión. Guía: scrapercity.com/sdk. Paquete de Python: pypi.org/project/scrapercity.

Precios (generados automáticamente a partir del catálogo en vivo; no editar)

Herramienta	Endpoint	Precio
`scrape_apollo`	/api/v1/scrape/apollo	$0.0039 por lead
`scrape_website_finder`	/api/v1/scrape/website-finder	$0.0499 por contacto encontrado
`find_people`	/api/v1/scrape/skip-trace	$0.0199 por resultado (las búsquedas sin coincidencias se cobran como 1 resultado)
`scrape_distress_list`	/api/v1/scrape/distress-list	$0.05 por propiedad
`validate_emails`	/api/v1/scrape/email-validator	$0.0017 por correo electrónico
`scrape_maps`	/api/v1/scrape/maps	$0.0099 por empresa
`scrape_airbnb`	/api/v1/scrape/airbnb-email	$0.019 por resultado ($19.00 por cada 1,000)
`scrape_bizbuysell`	/api/v1/scrape/bizbuysell-scraper	$0.0099 por anuncio
`scrape_crexi`	/api/v1/scrape/crexi-scraper	$0.029 por propiedad
`scrape_angi`	/api/v1/scrape/angi-angies-list-scraper	$0.0099 por anuncio
`scrape_yelp`	/api/v1/scrape/yelp-scraper	$0.0099 por resultado
`scrape_zillow_agents`	/api/v1/scrape/zillow-agents	$0.029 por agente
`scrape_property_lookup`	/api/v1/scrape/property-lookup	$0.15 por propiedad (+$0.10 por contacto del propietario)
`search_criminal_records`	/api/v1/scrape/criminal-records	$1.00 por búsqueda (solo se cobra si se encuentran registros)
`scrape_store_leads`	/api/v1/scrape/store-leads	$0.0039 por lead
`scrape_builtwith`	/api/v1/scrape/techstack	$4.99 por tecnología
`scrape_signals`	/api/v1/scrape/signals	$0.0094 por empresa que publica anuncios, $0.0009 por sitio web y plataforma consultada, $0.0043 por empresa que está contratando; cargo mínimo por búsqueda
`find_emails`	/api/v1/scrape/email-finder	$0.05 por correo electrónico encontrado (GRATIS si no se encuentra)
`find_mobiles`	/api/v1/scrape/mobile-finder	$0.25 por número encontrado (GRATIS si no se encuentra)

Herramientas disponibles

Herramienta	Función	Coste
Apollo	Contactos B2B por cargo, sector y ubicación	$0.0039/lead
Google Maps	Empresas locales con teléfonos, correos electrónicos y reseñas	$0.01/lugar
Email Validator	Verifica la entregabilidad, los dominios catch-all y los registros MX	$0.0036/correo electrónico
Email Finder	Encuentra el correo electrónico profesional a partir del nombre y la empresa	$0.05/contacto
Mobile Finder	Números de teléfono a partir de LinkedIn o del correo electrónico	$0.25/entrada
People Finder	Skip tracing por nombre, correo electrónico, teléfono o dirección	$0.02/resultado
Store Leads	Tiendas Shopify/WooCommerce con contactos	$0.0039/lead
BuiltWith	Todos los sitios que usan una tecnología	$4.99/búsqueda
Criminal Records	Verificación de antecedentes por nombre	$1.00 si se encuentran registros
Lead Database	Contactos B2B, consulta instantánea	Incluido en los planes de $149/mes o superiores; cada lead nuevo se cobra con los créditos de los planes inferiores
Local Business Database	Empresas locales con teléfonos, correos electrónicos y valoraciones, consulta instantánea	Incluido en los planes de $149/mes o superiores; cada empresa nueva se cobra con los créditos de los planes inferiores

Antes de enviar

Comprueba los leads de cualquier base de datos antes de contactarlos. Cada registro incluye email_check_status (nuestro propio verificador de correo electrónico: valid, valid_catch_all, invalid, unknown, not_checked): envía SOLO a correos electrónicos valid verificados en los últimos 30 días (email_checked_on) y pasa primero todos los demás por validate_emails. Para personas (Lead Database), pasa replaceLeftContacts: true a query_lead_database (query_local_business_database y query_ecommerce_database también lo aceptan, para la persona de contacto de cada empresa o tienda); la respuesta añade replacement.run_id, una ejecución que comprueba todos los correos electrónicos y sustituye a cada persona que ya no trabaja allí por quien ocupa ese puesto actualmente. Espera a que termine con check_run_status y luego envía el CSV desde download_results ($0.02 por contacto sustituido, gratis en el plan de $649). Como mínimo, verifica los correos electrónicos con validate_emails y envía solo a los válidos.

Cómo funciona

Inicia una extracción → obtén un runId
Consulta el estado (o usa webhooks) → espera a que esté SUCCEEDED
Descarga el CSV → leads con toda la información de contacto

Las extracciones de Apollo suelen tardar entre 15 y 30 minutos. Todos los demás scrapers tardan entre 1 y 30 minutos. Los leads de tiendas son instantáneos.

Autenticación

Obtén tu clave de API en app.scrapercity.com/dashboard/api-docs

# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"

# Or save to config file
npx scrapercity login

Webhooks

Para Apollo y las extracciones de larga duración, configura un webhook en app.scrapercity.com/dashboard/webhooks para recibir una notificación cuando los resultados estén listos.

Planes

Plan	Precio	Créditos
Prueba	7 días, se requiere tarjeta; después, se activa el plan elegido al registrarse	$5 de crédito de uso
Starter	$49/mes	$49 (bases de datos cobradas por registro con los créditos)
Growth	$149/mes	$149 + 10% de bonificación, bases de datos incluidas
Scale	$649/mes	$649 + 30% de bonificación, bases de datos incluidas, límites más altos

Compra créditos adicionales cuando quieras. scrapercity.com/pricing

Enlaces

Documentación para agentes - guía de configuración
Referencia de la API - documentación completa
Guía del SDK - SDK de JavaScript y Python
SDK de Python en PyPI - pip install scrapercity
Archivo de skill - para Claude Code
Listado del servidor MCP - configuración

Licencia

MIT