Comment connecter votre agent IA à SiteSeeker

1
Introduction : L'automatisation au service de la prospection

Les agents IA peuvent désormais chercher des prospects pour vous, pendant que vous dormez.

Si vous utilisez Claude, Cursor, Windsurf ou n'importe quel outil IA dans votre workflow quotidien, vous pouvez maintenant leur donner accès à SiteSeeker. Résultat : votre agent peut rechercher des entreprises sans site web, récupérer leurs coordonnées, et vous préparer une liste de prospects — sans que vous n'ayez à ouvrir un navigateur.

Ce guide vous montre comment configurer la connexion en moins de 5 minutes, que vous passiez par MCP (pour Claude Desktop, Cursor, Windsurf) ou par l'API REST (pour n8n, Make, vos propres scripts).

2
Étape 1 — Créer votre clé API

Toute l'authentification repose sur une clé API personnelle. Elle remplace votre session web et permet à vos agents d'agir en votre nom.

Générer votre clé dans le profil

Connectez-vous à votre profil SiteSeeker
Cliquez sur l'onglet Développeur
Donnez un nom à votre clé (ex : "Mon agent Claude")
Cliquez sur Générer
Copiez la clé immédiatement — elle ne sera plus affichée après fermeture

La clé ressemble à : sk_live_a1b2c3d4e5f6...

Vous pouvez créer jusqu'à 10 clés différentes et révoquer chacune individuellement.

Sécurité

Traitez votre clé API comme un mot de passe. Ne la partagez pas, ne la commitez pas dans Git. Si elle est compromise, révoquez-la depuis votre profil et régénérez-en une nouvelle.

3
Étape 2 — Configurer Claude Desktop (via MCP)

Le protocole MCP (Model Context Protocol) permet à Claude Desktop d'appeler SiteSeeker comme un outil natif, directement depuis vos conversations.

Configuration MCP pour Claude Desktop

Ouvrez le fichier de configuration de Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez la section mcpServers :

{
  "mcpServers": {
    "siteseeker": {
      "url": "https://siteseeker.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_VOTRE_CLE_ICI"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous verrez apparaître l'icône 🔌 dans l'interface indiquant que SiteSeeker est connecté.

Ajout via Claude Code CLI (une commande)
Recommandé

Si vous utilisez Claude Code dans votre terminal, ajoutez SiteSeeker avec votre clé API en une seule commande :

claude mcp add --transport http siteseeker https://siteseeker.fr/api/mcp \
  --header "Authorization: Bearer sk_live_VOTRE_CLE_ICI"

Remplacez sk_live_VOTRE_CLE_ICI par la clé générée dans votre profil. Les outils SiteSeeker sont immédiatement disponibles dans toutes vos sessions Claude Code.

Une fois configuré, vous pouvez simplement écrire dans Claude :

Exemples de prompts pour Claude

Recherche simple :"Cherche des plombiers à Lyon qui n'ont pas de site web et donne-moi leurs numéros de téléphone."

Recherche avec contexte commercial :"J'ai besoin de 20 prospects pour ma prospection de la semaine. Trouve des restaurants à Bordeaux sans site web, avec une note supérieure à 4 étoiles."

Workflow complet :"Vérifie mon solde de crédits, puis cherche des coiffeurs à Marseille sans site web, et présente-moi les 10 meilleurs selon le nombre d'avis."

Claude appelera automatiquement get_balance, puis search_businesses, puis get_task pour vous retourner les résultats formatés.

4
Étape 3 — Configurer Cursor ou Windsurf (via MCP)

Cursor et Windsurf supportent également le protocole MCP. La configuration est quasiment identique.

Cursor

Dans les paramètres Cursor, allez dans Features → MCP Servers et ajoutez :

{
  "name": "SiteSeeker",
  "url": "https://siteseeker.fr/api/mcp",
  "headers": {
    "Authorization": "Bearer sk_live_..."
  }
}

Windsurf

Ouvrez ~/.codeium/windsurf/mcp_config.json et ajoutez :

{
  "mcpServers": {
    "siteseeker": {
      "serverUrl": "https://siteseeker.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

5
Étape 4 — Utiliser l'API REST (n8n, Make, scripts)

Si vous préférez intégrer SiteSeeker dans vos automatisations sans passer par MCP, l'API REST est disponible directement.

Appels REST avec curl

Vérifier votre solde :

curl https://siteseeker.fr/api/credits/balance \
  -H "Authorization: Bearer sk_live_..."

Lancer une recherche :

curl https://siteseeker.fr/api/tasks \
  -X POST \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "restaurants Paris sans site web",
    "country": "FR",
    "lang": "fr"
  }'

Récupérer les résultats :

curl https://siteseeker.fr/api/tasks/TASK_ID \
  -H "Authorization: Bearer sk_live_..."

Quand utiliser MCP

Conversation naturelle avec Claude
Pas besoin de coder
Claude gère la logique de plusieurs appels
Idéal pour une utilisation quotidienne

Quand utiliser l'API REST

Automatisations dans n8n ou Make

Scripts Python ou Node.js

Intégrations avec d'autres outils

Workflows planifiés (cron jobs)

6
Exemples de workflows concrets

Workflow : Liste de prospection hebdomadaire
Populaire

Chaque lundi matin, votre agent génère automatiquement une liste de 50 prospects frais.

Avec n8n : Planifiez un nœud HTTP POST vers /api/tasks avec votre query habituelle. Connectez-le à un nœud Google Sheets pour alimenter votre CRM directement.

Avec Claude : "Chaque fois que je te demande 'liste du lundi', cherche 50 restaurants sans site web à Paris et formate la liste avec nom, téléphone et adresse."

Workflow : Recherche à la demande dans Cursor

Pendant que vous codez un site client, demandez à Cursor :

"Cherche d'autres entreprises similaires à mon client actuel (boulangerie, Lyon) sans site web. Je vais leur proposer le même template."

Cursor utilise SiteSeeker pour trouver 20 prospects que vous pouvez contacter dès que le site est livré.

Workflow : Analyse de marché avant un pitch

Avant de prospecter une nouvelle ville ou un nouveau secteur :

"Combien y a-t-il de plombiers sans site web à Toulouse ? Donne-moi leur note moyenne et le nombre total pour que j'évalue le potentiel du marché."

Votre agent fait la recherche, analyse les données, et vous donne un résumé opérationnel.

7
Suivre vos requêtes API

Toutes les recherches effectuées via API ou agent IA sont tracées séparément dans votre compte. Dans votre liste de tâches, vous verrez un indicateur "API" distinguant les recherches automatisées de vos recherches manuelles.

Ce que vous pouvez suivre

Nombre de recherches effectuées par vos agents vs manuellement
Quelle clé API a été utilisée (utile si vous avez plusieurs agents)
Les crédits consommés par chaque workflow automatisé
L'historique complet des résultats, accessible depuis /app/tasks

Chaque crédit consommé est identique qu'il vienne d'une action manuelle ou d'un agent IA. Consultez votre solde avant de lancer des workflows intensifs.

8
Les 4 outils disponibles pour vos agents

Voici exactement ce que votre agent IA peut faire avec SiteSeeker :

Outils MCP disponibles

Votre agent a accès à ces 4 actions :

search_businesses — Lance une recherche et retourne jusqu'à 60 entreprises avec leurs coordonnées

get_task — Récupère le résultat complet d'une recherche précédente (nom, adresse, téléphone, email, site web)

list_tasks — Liste vos recherches récentes pour y retrouver des résultats

get_balance — Vérifie votre solde de crédits avant de lancer une recherche

Conclusion

Connecter un agent IA à SiteSeeker transforme votre prospection : au lieu de chercher manuellement, votre agent travaille pour vous — à la demande ou de manière planifiée.

Créez votre clé API depuis l'onglet Développeur de votre profil

Configurez votre agent (Claude Desktop, Cursor, ou API REST)

Testez avec un prompt simple : "Cherche des restaurants à votre ville sans site web"

Automatisez vos workflows de prospection hebdomadaire

Prêt à connecter votre agent IA ?

Créez votre clé API depuis votre profil et commencez à automatiser votre prospection dès aujourd'hui.

1Introduction : L'automatisation au service de la prospection

2Étape 1 — Créer votre clé API