ScraperCity

officiel

Serveur MCP de génération de leads B2B - Apollo, Google Maps, email finder, skip trace, et plus de 15 outils.

Que pouvez-vous faire avec ScraperCity MCP ?

Scrape local businesses — Pull Google Maps listings with phones, emails, and reviews for a search and location, then poll the run and download a CSV.
Find B2B contacts — Query the lead database or scrape Apollo for people by job title, industry, and location.
Validate and find emails — Verify deliverability with validate_emails or find a business email from a name and company.
Look up mobile numbers — Find phone numbers from a LinkedIn profile or email, or skip trace by name, email, phone, or address.
Check run status and download — Track a scrape's progress and save finished results as CSV once it succeeds.

Documentation

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

Récupérez des leads, validez des adresses e-mail, trouvez des numéros de mobile et extrayez des données d’entreprises, le tout depuis votre agent IA, votre CLI ou votre code. Un seul package : le serveur MCP, la CLI et le SDK JavaScript. Le SDK Python est pip install scrapercity.

ScraperCity donne aux agents IA accès à plus de 15 outils de données B2B : extraction de données Apollo, extraction de Google Maps, recherche et validation d’adresses e-mail, recherche de numéros de mobile, recherche de personnes, données de boutiques e-commerce, casiers judiciaires et bien plus encore.

Commencez ici (aucune clé API requise)

npx scrapercity start "dentists in Austin"

Vous pouvez aussi demander à votre agent d’appeler l’outil MCP start_here ou GET https://app.scrapercity.com/api/v1/start?query=.... Sans clé, vous bénéficiez d’une visite guidée : présentation de ScraperCity, instructions d’inscription, forfaits et essai avec leurs conditions en vigueur, ainsi que des recherches réelles avec des décomptes en temps réel. Avec une clé, l’outil établit un plan adapté à votre compte et renvoie l’appel suivant exact.

L’essai, en toute transparence : l’essai correspond à une utilisation réelle, pas à une démo ni à une offre gratuite : 5 $ de crédit pendant 7 jours, utilisables avec tous les outils et toutes les bases de données aux tarifs habituels. Vous pouvez donc récupérer de véritables données dès le premier jour et évaluer leur qualité. Une carte bancaire est requise lors de l’inscription. À la fin des 7 jours, le forfait choisi lors de l’inscription démarre ; annulez-le avant cette échéance depuis la facturation pour ne rien payer de plus. Si le crédit est épuisé avant, les extractions depuis les bases de données sont suspendues (elles ne sont pas facturées) ; une extraction qui dépasse le crédit déclenche le forfait plus tôt. Les recherches de planification et la vérification des décomptes sont gratuites. start_here renvoie les conditions en vigueur.

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 ceci à votre configuration MCP (par exemple, ~/.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 adresses e-mail à l’aide de ScraperCity »

Option 3 : fichier de compétence (Claude Code)

Copiez le fichier de compétence 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 adresses e-mail 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"

Option 5 : SDK 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()

Option 6 : SDK 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

Les deux SDK proposent la même liste d’outils que le serveur MCP, régénérée à partir de la documentation de l’API en vigueur à chaque version. Guide : scrapercity.com/sdk. Package Python : pypi.org/project/scrapercity.

Tarifs (générés automatiquement à partir du catalogue en vigueur — ne pas modifier)

Outil	Endpoint	Prix
`scrape_apollo`	/api/v1/scrape/apollo	0,0039 $ par lead
`scrape_website_finder`	/api/v1/scrape/website-finder	0,0499 $ par contact trouvé
`find_people`	/api/v1/scrape/skip-trace	0,0199 $ par résultat (les recherches sans correspondance sont facturées comme 1 résultat)
`scrape_distress_list`	/api/v1/scrape/distress-list	0,05 $ par bien immobilier
`validate_emails`	/api/v1/scrape/email-validator	0,0017 $ par adresse e-mail
`scrape_maps`	/api/v1/scrape/maps	0,0099 $ par entreprise
`scrape_airbnb`	/api/v1/scrape/airbnb-email	0,019 $ par résultat (19,00 $ pour 1 000)
`scrape_bizbuysell`	/api/v1/scrape/bizbuysell-scraper	0,0099 $ par annonce
`scrape_crexi`	/api/v1/scrape/crexi-scraper	0,029 $ par bien immobilier
`scrape_angi`	/api/v1/scrape/angi-angies-list-scraper	0,0099 $ par annonce
`scrape_yelp`	/api/v1/scrape/yelp-scraper	0,0099 $ par résultat
`scrape_zillow_agents`	/api/v1/scrape/zillow-agents	0,029 $ par agent
`scrape_property_lookup`	/api/v1/scrape/property-lookup	0,15 $ par bien immobilier (+0,10 $ pour les coordonnées du propriétaire)
`search_criminal_records`	/api/v1/scrape/criminal-records	1,00 $ par recherche (facturée uniquement si des dossiers sont trouvés)
`scrape_store_leads`	/api/v1/scrape/store-leads	0,0039 $ par lead
`scrape_builtwith`	/api/v1/scrape/techstack	4,99 $ par technologie
`scrape_signals`	/api/v1/scrape/signals	0,0094 $ par entreprise diffusant des publicités, 0,0009 $ par site web et par plateforme vérifiée, 0,0043 $ par entreprise recrutant ; frais minimum par recherche
`find_emails`	/api/v1/scrape/email-finder	0,05 $ par adresse e-mail trouvée (GRATUIT si aucune n’est trouvée)
`find_mobiles`	/api/v1/scrape/mobile-finder	0,25 $ par numéro trouvé (GRATUIT si aucun n’est trouvé)

Outils disponibles

Outil	Fonction	Coût
Apollo	Coordonnées B2B par intitulé de poste, secteur et lieu	0,0039 $/lead
Google Maps	Entreprises locales avec numéros de téléphone, adresses e-mail et avis	0,01 $/lieu
Email Validator	Vérification de la délivrabilité, des domaines catch-all et des enregistrements MX	0,0036 $/adresse e-mail
Email Finder	Recherche d’une adresse e-mail professionnelle à partir du nom et de l’entreprise	0,05 $/contact
Mobile Finder	Numéros de téléphone à partir de LinkedIn ou d’une adresse e-mail	0,25 $/entrée
People Finder	Recherche de personnes à partir d’un nom, d’une adresse e-mail, d’un numéro de téléphone ou d’une adresse	0,02 $/résultat
Store Leads	Boutiques Shopify/WooCommerce avec coordonnées	0,0039 $/lead
BuiltWith	Tous les sites utilisant une technologie	4,99 $/recherche
Criminal Records	Vérification des antécédents à partir d’un nom	1,00 $ si un résultat est trouvé
Base de données de leads	Coordonnées B2B, requête instantanée	Inclus à partir du forfait à 149 $/mois ; facturation par nouveau lead à partir des crédits pour les forfaits inférieurs
Base de données d’entreprises locales	Entreprises locales avec numéros de téléphone, adresses e-mail et notes, requête instantanée	Incluse à partir du forfait à 149 $/mois ; facturation par nouvelle entreprise à partir des crédits pour les forfaits inférieurs

Avant l’envoi

Pour les leads issus de n’importe quelle base de données : vérifiez-les avant toute prise de contact. Chaque fiche contient email_check_status (notre propre vérificateur d’adresses e-mail : valid, valid_catch_all, invalid, unknown, not_checked) : envoyez des messages UNIQUEMENT aux adresses e-mail valid vérifiées au cours des 30 derniers jours (email_checked_on), et faites d’abord vérifier toutes les autres adresses avec validate_emails. Pour les personnes (base de données de leads), transmettez replaceLeftContacts: true à query_lead_database (query_local_business_database et query_ecommerce_database l’acceptent aussi, pour la personne à contacter de chaque entreprise ou boutique) ; la réponse ajoute replacement.run_id, une exécution qui vérifie chaque adresse e-mail et remplace toute personne ayant quitté son poste par la personne qui l’occupe actuellement. Attendez son résultat avec check_run_status, puis envoyez le CSV depuis download_results (0,02 $ par contact remplacé, gratuit avec le forfait à 649 $). Au minimum, faites vérifier les adresses e-mail avec validate_emails et n’envoyez des messages qu’aux adresses valides.

Fonctionnement

Lancez une extraction → obtenez un runId
Vérifiez l’état (ou utilisez des webhooks) → attendez SUCCEEDED
Téléchargez le CSV → des leads avec toutes leurs coordonnées

Les extractions Apollo prennent généralement 15 à 30 minutes. Toutes les autres extractions prennent de 1 à 30 minutes. Les leads de boutiques 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 de longue durée, configurez un webhook sur app.scrapercity.com/dashboard/webhooks afin d’être averti lorsque les résultats sont prêts.

Forfaits

Forfait	Prix	Crédits
Essai	7 jours, carte bancaire requise, puis activation du forfait choisi lors de l’inscription	5 $ de crédit d’utilisation
Starter	49 $/mois	49 $ (bases de données facturées par fiche à partir des crédits)
Growth	149 $/mois	149 $ + 10 % de bonus, bases de données incluses
Scale	649 $/mois	649 $ + 30 % de bonus, bases de données incluses, limites supérieures

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

Liens

Documentation pour les agents - guide de configuration
Référence de l’API - documentation complète
Guide du SDK - SDK JavaScript et Python
SDK Python sur PyPI - pip install scrapercity
Fichier de compétence - pour Claude Code
Fiche du serveur MCP - configuration

Licence

MIT