ScraperCity MCP Server

ScraperCity - Génération de leads B2B pour agents IA

Extrayez des leads, validez des emails, trouvez des numéros de mobile et collectez des données commerciales - le tout depuis votre agent IA, votre CLI ou votre code.

ScraperCity donne aux agents IA l'accès à plus de 15 outils de données B2B : extraction Apollo, extraction Google Maps, recherche/validation d'emails, recherche de numéros de mobile, skip tracing, données de boutiques e-commerce, casiers judiciaires, et plus encore.

Démarrage rapide

Option 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

Option 2 : Serveur MCP (Claude Code, Cursor, Windsurf, etc.)

Ajoutez à votre configuration MCP (ex. ~/.claude/claude_desktop_config.json) :

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

Puis dites à votre IA : "Trouve 1000 plombiers à Denver avec leurs emails en utilisant ScraperCity"

Option 3 : Fichier de compétences (Claude Code)

Copiez le fichier de compétences dans votre projet :

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

Ou téléchargez-le depuis : https://scrapercity.com/agents/SKILL.md

Puis dans Claude Code : "Lis SCRAPERCITY_SKILL.md et trouve-moi 2000 directeurs marketing dans des entreprises SaaS en Californie, valide leurs emails et enregistre-les dans leads.csv"

Option 4 : API directe

# 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"

Outils disponibles

Outil	Fonction	Coût
Apollo	Contacts B2B par intitulé de poste, secteur, localisation	0,0039 $/lead
Google Maps	Entreprises locales avec téléphones, emails, avis	0,01 $/établissement
Validateur d'emails	Vérifie la délivrabilité, catch-all, enregistrements MX	0,0036 $/email
Recherche d'email	Trouve l'email professionnel à partir du nom + entreprise	0,05 $/contact
Recherche de mobile	Numéros de téléphone à partir de LinkedIn ou d'un email	0,25 $/entrée
Recherche de personnes	Skip trace par nom, email, téléphone, adresse	0,02 $/résultat
Store Leads	Boutiques Shopify/WooCommerce avec contacts	0,0039 $/lead
BuiltWith	Tous les sites utilisant une technologie	4,99 $/recherche
Casiers judiciaires	Vérification des antécédents par nom	1,00 $ si trouvé
Base de données de leads	Plus de 3M de contacts B2B, requête instantanée (forfait 649 $)	Inclus

Fonctionnement

1. Lancez une extraction → obtenez un runId
2. Vérifiez le statut (ou utilisez des webhooks) → attendez SUCCEEDED
3. Téléchargez le CSV → leads avec informations de contact complètes

Les extractions Apollo prennent de 11 à plus de 48 heures. Tous les autres extracteurs : 1 à 30 minutes. Les Store Leads sont instantanés.

Authentification

Obtenez votre clé API sur app.scrapercity.com/dashboard/api-docs

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

# Or save to config file
npx scrapercity login

Webhooks

Pour Apollo et les extractions longues, configurez un webhook sur app.scrapercity.com/dashboard/webhooks pour être notifié lorsque les résultats sont prêts.

Forfaits

Forfait	Prix	Crédits
Essai	Gratuit	5 $
Starter	49 $/mois	49 $
Growth	149 $/mois	149 $ + bonus de 10 %
Professional	649 $/mois	649 $ + bonus de 30 % + API Database

Achetez des crédits supplémentaires à tout moment. scrapercity.com/pricing

Liens

• Documentation Agent - guide de configuration
• Référence API - documentation complète
• Fichier de compétences - pour Claude Code
• Liste des serveurs MCP - configuration

Licence

MIT