Leadmaps pour Claude — la donnée business européenne dans vos conversations

Claude parle MCP nativement. Une commande — ou un bloc de config — et il peut compter, chercher et exporter 13,2M+ d'entreprises locales européennes (13 233 049 fiches) — le comptage est gratuit, Claude évalue donc chaque requête avant de dépenser un crédit.

Le chemin le plus rapide : une commande

La CLI leadmaps sur npm (zéro dépendance, rien à installer) valide votre clé en direct contre l'endpoint de comptage gratuit — une clé invalide s'arrête sans rien écrire — puis enregistre le serveur MCP dans Claude Code au scope user :

claude — leadmaps connect — 80×24
$ npx leadmaps connect --agent claude
Validating your key against api.leadmaps.io …
✓ 13,233,049 listings reachable
✓ Registered with Claude Code (claude mcp add --transport http --scope user)
Available in every Claude Code session. For Claude Desktop or claude.ai, see https://leadmaps.io/agents/claude.
 
Try this first prompt:
"Find 150 real-estate agencies in Lille rated ≥ 4.4 with a website, export to CSV."

Installation manuelle

  1. Créez votre clé API sur app.leadmaps.io/keys (une clé de test lm_test_ gratuite suffit, sans carte).
  2. Claude Code : lancez `claude mcp add --transport http leadmaps https://mcp.leadmaps.io/mcp --header "Authorization: Bearer lm_live_xxx"`.
  3. Claude Desktop : ajoutez le bloc JSON ci-dessous via mcp-remote dans claude_desktop_config.json.
  4. Demandez à Claude un `count_places` sur votre cible — c'est gratuit — puis cherchez ou exportez.
{
  "mcpServers": {
    "leadmaps": {
      "type": "http",
      "url": "https://mcp.leadmaps.io/mcp",
      "headers": { "Authorization": "Bearer lm_live_xxx" }
    }
  }
}

3 prompts copiables

  • Compte les plombiers notés ≥ 4,5 à Nantes, puis livre-moi les 20 premiers avec téléphone et site web.
  • Trouve 150 agences immobilières à Lille avec note ≥ 4,4 et un site web, exporte en CSV.
  • Liste les catégories disponibles autour de « restauration », puis compte les pizzerias sans site web dans le Rhône.

Les tools MCP

ToolCoût
count_placesGratuit — à appeler en premier
search_places1 crédit par fiche retournée (re-livraison 30 j gratuite)
get_place1 crédit (dédup)
list_categoriesGratuit
create_export1 crédit par ligne livrée
get_export_statusGratuit

Pourquoi Claude + Leadmaps fonctionne si bien

Claude est le client MCP le plus capable du marché : il planifie seul des recherches multi-étapes. Avec le serveur Leadmaps, un prompt comme « Construis-moi une liste de 150 agences immobilières à Lille notées 4,4+, avec site web, exportée en CSV » devient un pipeline budgété et sûr :

  1. count_places (gratuit) — Claude vérifie d'abord la taille du résultat : 612 correspondances.
  2. create_export — Claude lance un export asynchrone limité à 150 lignes.
  3. get_export_status — Claude vérifie une fois, puis vous donne l'URL de téléchargement.
  4. 150 crédits débités, et relancer la même requête sous 30 jours est gratuit (dédup).

Le plafond de dépenses, côté agent

Si votre compte atteint son plafond en plein export, le job se met en pause (paused_cap) au lieu d'échouer. Claude reçoit la consigne explicite : « ne poll plus ; dis à l'utilisateur de relever le plafond sur app.leadmaps.io/billing puis appelle resume ». Pas de boucle infinie, pas de facture surprise.

Claude Code en une ligne

claude mcp add --transport http leadmaps https://mcp.leadmaps.io/mcp \
  --header "Authorization: Bearer lm_live_xxx"

Claude Desktop (via mcp-remote)

{
  "mcpServers": {
    "leadmaps": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.leadmaps.io/mcp",
               "--header", "Authorization: Bearer lm_live_xxx"]
    }
  }
}

Un prompt d'agent prospection qui marche

Tu es mon agent de prospection locale. Appelle toujours count_places avant toute recherche. Ne livre jamais plus de 200 fiches sans me demander. Préfère create_export au-delà de 50 résultats. Annonce credits_charged après chaque appel payant.

FAQ

Le MCP Leadmaps fonctionne-t-il avec claude.ai, Claude Desktop et Claude Code ?

Oui, les trois. claude.ai : connecteur personnalisé pointé sur https://mcp.leadmaps.io/mcp avec le header Authorization. Claude Desktop : bloc mcp-remote dans claude_desktop_config.json. Claude Code : `claude mcp add --transport http leadmaps …` en une ligne.

Claude peut-il dépenser mes crédits sans me demander ?

Le comptage, les facettes et le statut d'export sont gratuits ; seuls search_places, get_place et create_export débitent des crédits. Ajoutez à votre prompt système « appelle toujours count_places d'abord et demande-moi avant de livrer plus de 200 fiches » — et le plafond de dépenses de votre compte reste la garde ultime.

Que se passe-t-il si Claude relance deux fois le même export ?

Rien de grave : toute fiche déjà livrée et facturée à votre compte est re-livrable gratuitement pendant 30 jours, tous canaux confondus. Un retry ou une relance du même prompt ne coûte donc aucun crédit supplémentaire.

Puis-je tester avec Claude sans carte bancaire ?

Oui : créez une clé lm_test_ gratuite sur app.leadmaps.io/keys — elle donne accès à une sandbox d'environ 5 000 fiches réelles via le MCP, pour 0 crédit et sans carte.

Que modifie exactement `npx leadmaps connect --agent claude` sur ma machine ?

La CLI valide d'abord votre clé via un GET /v1/places/count gratuit (clé invalide : elle s'arrête sans rien écrire). Puis elle lance `claude mcp add --transport http --scope user`, ou fusionne l'entrée leadmaps dans ~/.claude.json en préservant tout le reste, avec un backup .bak. Pour revenir en arrière : `claude mcp remove leadmaps -s user`.