Développeurs et agents

Pilotez Localnord depuis votre code ou votre agent

Trois surfaces d'intégration : un serveur MCP pour les agents IA, une API REST v1 pour vos outils, des webhooks pour vos automatisations. Tout est scopé à votre organisation.

  • MCPStreamable HTTP
  • REST v1JSON, clé API
  • 5events webhook

Localnord developer documentation for FR agencies.

Serveur MCP Localnord

Connectez Claude, Claude Code ou tout client MCP au serveur Localnord : votre agent liste le portefeuille de fiches, audite, rédige les posts, répond aux avis et sort les rapports en marque blanche.

Serveur MCPhttps://app.localnord.io/api/mcp/mcp
Endpoint
https://app.localnord.io/api/mcp/mcp
Transport
Streamable HTTP
Authentification
OAuth 2.1
Manifeste
https://www.localnord.io/.well-known/mcp.json

Familles d'outils

  • listings

    Lister, auditer, synchroniser et modifier les fiches Google.

  • reviews

    Lire les avis, générer et publier les réponses, lancer les campagnes.

  • publications

    Rédiger, programmer et publier posts, photos et vidéos.

  • rankings

    Suivi de positions locales, mots-clés et benchmarks concurrents.

  • prospecting

    Chercher et enrichir des prospects, audits en marque blanche, marketplace.

  • reporting

    Rapports PDF marque blanche, portail client, statistiques d'agence.

  • account

    Crédits, quotas, factures, équipe et branding de l'organisation.

API REST v1

Une clé API est liée à une seule organisation : chaque requête est filtrée automatiquement, une clé ne peut jamais lire les données d'une autre agence. La clé n'est affichée qu'une fois, elle est stockée hachée.

Base URL
https://app.localnord.io/api/v1
Authentification
Authorization: Bearer lnk_…
Rate limit
10 000 req/day/key
Pagination
?page=1&per_page=50 (max 100)

Enveloppe de réponse

{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 50, "total": 134, "total_pages": 3 }
}

Codes de statut

CodeSignification
400Corps ou paramètre invalide
401Clé API absente ou inconnue
402Crédits insuffisants (audits, campagnes)
403Clé révoquée ou fiche en pause
404Introuvable, ou hors de votre organisation
409Conflit d'état (déjà publié, déjà répondu)
429Quota ou rate-limit dépassé

Webhooks

Abonnez une URL HTTPS aux events Localnord (20 webhooks maximum par organisation). Avec un secret configuré, chaque livraison est signée par un en-tête X-Webhook-Signature en HMAC-SHA256.

EventDéclenché quand
review.createdUn nouvel avis est détecté
publication.publishedUn Google Post est publié
ranking.completedUn scan de classement se termine
game.playedUne partie du jeu de collecte d'avis est jouée
lead_magnet.leadUn aimant à leads capture un contact

Pour les agents IA

Chaque page de localnord.io a une représentation Markdown : envoyez l'en-tête Accept: text/markdown et la même URL répond en text/markdown avec Vary: Accept. Les types non gérés renvoient 406.

curl -H "Accept: text/markdown" https://www.localnord.io/en/pricing

Prêt à intégrer Localnord ?

Créez votre compte, générez une clé API dans le tableau de bord et connectez votre agent au serveur MCP. 7 jours d'essai, sans carte bancaire.