prospector-web

Prospector Web

Interface web locale pour piloter la prospection LinkedIn via Claude AI + Airtable + Unipile.

Lancez npx prospector-web dans un dossier, ouvrez http://localhost:3001 — Claude guide le setup et gere votre pipeline de prospection en langage naturel.

Fonctionnement

Navigateur (chat-local.html)
  |  POST /chat (SSE)
  v
server.js  (Express, port 3001)
  |  genere .mcp.json depuis .prospector.json
  |  spawn: claude -p --mcp-config .mcp.json
  v
Claude CLI  (compte Pro de l'utilisateur)
  |                        |
  v                        v
Airtable API          mcp-unipile-server (VPS)
(token client)             |
                           v
                      Unipile API -> LinkedIn

• Claude CLI s'execute localement — c'est le compte Pro de l'utilisateur qui est facture
• Token Airtable : stocke sur la machine de l'utilisateur (.prospector.json), jamais transmis
• Cle API Unipile : stockee sur le VPS de l'editeur, jamais visible du client
• Rien ne transite vers le navigateur

Prerequis

• Node.js >= 18 — seule installation manuelle requise
• Claude Code connecte a votre compte Claude Pro (claude login)
• Un compte Airtable avec le template Prospector
• (Optionnel) Un compte Unipile (pour les envois LinkedIn)

Installation

Installation simplifiee (macOS / Linux / WSL)

curl -fsSL https://mcp-unipile.deers.fr/install.sh | sh

Ce script automatise :

• installation de Node.js (si absent)
• installation de Claude Code (si absent)
• claude login
• creation de ~/prospector et lancement de npx prospector-web

Si le terminal macOS bloque l'execution directe d'un script distant (curl | sh), utilisez ce fallback :

curl -fsSL -o /tmp/prospector-install.sh https://mcp-unipile.deers.fr/install.sh
sh /tmp/prospector-install.sh

Windows (PowerShell / CMD)

Option recommandee : utiliser WSL puis la commande ci-dessus.

Option native :

# 1. Telecharger et installer Node.js LTS
# https://nodejs.org

# 2. Installer Claude Code
curl -fsSL https://claude.ai/install.sh | sh

# 3. Se connecter a Claude (une seule fois)
claude login

# 4. Lancer Prospector
mkdir %USERPROFILE%\\prospector
cd %USERPROFILE%\\prospector
npx prospector-web

Relancer apres le premier demarrage

cd ~/prospector
npx prospector-web

Ouvrir http://localhost:3001

Premier lancement

Au premier message, Claude pose 3 questions et configure tout automatiquement.

Etape A — Token Airtable

Claude demande votre Personal Access Token Airtable.

1. Ouvrir : https://airtable.com/create/tokens
2. Cliquer "Create new token"
3. Remplir :
   - Nom    : Prospector Claude
   - Scopes : data.records:read / write + schema.bases:read / write
   - Access : "All current and future bases"
4. Cliquer "Create token"
5. Copier le token (commence par "pat...")
   Il ne sera affiche qu'une seule fois.

Etape B — Base ID Airtable

Claude demande l'ID de votre base Airtable Prospector.

1. Ouvrir votre base Airtable dans le navigateur
2. L'URL ressemble a : https://airtable.com/appXXXXXXXXXXXXXX/...
3. Copier la partie "appXXXXXXXXXXXXXX"

Etape C — Compte Unipile (optionnel)

Claude demande, si vous souhaitez activer l'envoi LinkedIn :

• Unipile Account ID — identifiant de votre compte LinkedIn dans Unipile
• MCP Secret — fourni par l'administrateur Prospector

Ces 3 valeurs sont enregistrees dans .prospector.json (local, jamais committe).

Fichier de configuration .prospector.json

Cree automatiquement par Claude dans le dossier de lancement :

{
  "AIRTABLE_API_KEY": "pat...",
  "baseId": "appXXXXXXXXXXXXXX",
  "UNIPILE_ACCOUNT_ID": "...",
  "UNIPILE_MCP_SECRET": "..."
}

Securiser le fichier apres creation :

chmod 600 ~/prospector/.prospector.json

Commandes disponibles

Commande	Description
pipeline	Vue kanban du pipeline par statut
hot-leads	Prospects chauds a traiter en priorite
relances	Relances a effectuer
meeting	Gestion des rendez-vous
quota	Quotas LinkedIn restants + etat des automatisations
toggle	Activer / mettre en pause les automatisations
search [nom]	Rechercher un prospect
add-lead	Ajouter un prospect manuellement
new-campaign	Creer une offre + campagne
list-offers	Lister les offres
list-campaigns	Lister les campagnes
edit-offer	Modifier une offre existante
edit-campaign	Modifier / piloter une campagne
stats	Dashboard statistiques

Toute demande hors commande est traitee via les outils Unipile (messages LinkedIn, conversations, profils...).

Depannage

Symptome	Cause	Solution
"Failed to fetch"	Serveur non demarre	npx prospector-web
"Claude CLI introuvable"	claude absent du PATH	curl -fsSL https://claude.ai/install.sh | sh
"claude login" necessaire	Pas authentifie	claude login puis relancer
Port 3001 deja utilise	Autre instance en cours	Fermer l'ancienne instance ou changer de port
Airtable ne repond pas	Token manquant ou invalide	Verifier .prospector.json
Unipile ne repond pas	Secret incorrect ou VPS inaccessible	Verifier UNIPILE_MCP_SECRET
Setup ne se declenche pas	CLAUDE.md deja present	Supprimer CLAUDE.md du dossier -> relancer
"Claude a quitte avec le code 1"	Erreur interne Claude	Voir logs dans le terminal

Guide editeur

Structure des repertoires

	PKG_DIR (__dirname)	USER_DIR (process.cwd())
Contenu	Code du package npm	Config utilisateur
Fichiers	server.js, chat-local.html, CLAUDE.md	.prospector.json, .mcp.json
Dans git	oui	non (gitignored)

Publication npm

npm login
npm publish

Mise a jour de version :

npm version patch   # 1.0.1 -> 1.0.2
npm publish

Modifier le prompt systeme

Editer CLAUDE.md : il est copie dans USER_DIR au premier lancement si absent. Pour forcer la mise a jour chez un client : supprimer CLAUDE.md de son dossier et relancer.

Deploiement du serveur MCP Unipile

Le serveur MCP Unipile est un composant separe a deployer sur votre VPS. Voir le repository mcp_unipile_server.

Une fois deploye, l'URL du serveur est configuree dans server.js :

const unipileMcpUrl = cfg.UNIPILE_MCP_URL || 'https://mcp-unipile.deers.fr/mcp/unipile';

Modifier cette valeur avant de publier sur npm si vous changez de domaine.

Securite

Donnee	Stockee ou	Visible par
AIRTABLE_API_KEY	.prospector.json (client)	Client uniquement
UNIPILE_API_KEY	.env VPS	Serveur VPS uniquement
UNIPILE_ACCOUNT_ID	.prospector.json (client)	Client + Unipile API
MCP_SECRET	.env VPS + .prospector.json client	Les deux
Cles dans le navigateur	—	jamais

Architecture des fichiers

prospector_web_airtable/
|-- server.js           <- serveur Express + spawn claude CLI
|-- chat-local.html     <- interface web (markdown, mode jour/nuit)
|-- CLAUDE.md           <- prompt systeme Prospector (setup + commandes)
|-- package.json        <- bin: prospector-web, files, dependances
|-- doc.md              <- documentation technique complete
|-- README.md
`-- .gitignore

Generes dans USER_DIR (dossier ou le client lance la commande) :
|-- CLAUDE.md           <- copie depuis le package si absent
|-- .mcp.json           <- regenere a chaque requete /chat
`-- .prospector.json    <- cree par Claude lors du setup initial