Comment automatiser Residual Reach avec Claude Code (API + MCP)

Claude Code peut déclencher vos campagnes Reach, lire vos stats et exporter vos prospects directement depuis le terminal. Voici comment.

Pourquoi utiliser Claude Code avec Reach

Claude Code (l'outil CLI d'Anthropic) peut contrôler votre compte Residual Reach directement depuis le terminal : lancer une campagne, lire les stats, exporter des prospects. Zéro clic dans l'interface.

C'est utile pour : automatiser des workflows répétitifs, intégrer Reach dans un pipeline de scripts, ou simplement préférer le terminal à l'UI.

Prérequis

Méthode 1 : Via l'API REST directement

Reach expose une API REST complète documentée sur /docs.

Lancer une campagne depuis Claude Code :

# Dans votre session Claude Code
> Appelle POST /api/campaigns/[mon-id]/run et dis-moi le résultat

Claude va utiliser l'outil Bash pour exécuter la requête curl et parser le JSON de retour.

Récupérer les stats d'une campagne :

> Récupère les stats de ma campagne "Plombiers Paris" et affiche le taux de conversion

Méthode 2 : Via un MCP server (avancé)

Un MCP (Model Context Protocol) server vous permet d'exposer les fonctions Reach à Claude Code comme des outils natifs.

Structure d'un MCP server Reach :

// mcp-reach-server.ts
import { Server } from '@modelcontextprotocol/sdk/server/index.js'

const server = new Server({
  name: 'residual-reach',
  version: '1.0.0',
})

server.setRequestHandler('tools/list', async () => ({
  tools: [
    { name: 'run_campaign', description: 'Lance le pipeline d'une campagne' },
    { name: 'get_stats',    description: 'Récupère les stats d'une campagne' },
    { name: 'export_prospects', description: 'Exporte les prospects en CSV' },
  ],
}))

Configurer Claude Code pour utiliser le MCP :

// .claude/settings.json
{
  "mcpServers": {
    "reach": {
      "command": "npx",
      "args": ["ts-node", "mcp-reach-server.ts"]
    }
  }
}

Exemple de workflow automatisé

# Prompt Claude Code
> Chaque lundi matin :
> 1. Lance toutes mes campagnes actives
> 2. Attends le résultat Trigger.dev
> 3. Envoie-moi un résumé Telegram
> 4. Exporte les prospects "envoyé" de la semaine en CSV

Claude va décomposer cette tâche, appeler les bons endpoints dans l'ordre et gérer les erreurs.

Bonnes pratiques

*La documentation complète de l'API est sur /docs. Créer un compte →*

Prêt à automatiser votre prospection ?

Residual Reach scrape, audite et rédige vos emails de prospection en autonomie. BYOK, RGPD, délivrabilité intégrée.