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.

Créer une clé APIRéférence en Markdown

MCP

Streamable HTTP

REST v1

JSON, clé API

12

events webhook

MCP

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.

REST v1

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 · reset 00:00 UTC
Pagination
?page=1&per_page=50 (max 100)
En-têtes de quota
X-RateLimit-Limit / -Remaining / -Reset
Référence complète
https://app.localnord.io/api/v1/docs.md

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é
500Erreur serveur
502Google a rejeté ou est indisponible
Webhooks

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.

review.createdUn client laisse un avis Google sur une fiche
review.negativeUn avis de 3 étoiles ou moins arrive : le signal à router vers une alerte
publication.publishedUn Google Post planifié part en ligne
publication.failedUn Google Post n'a pas pu être publié, avec la cause du refus
photo.publishedUne photo planifiée est arrivée sur la fiche Google
ranking.completedUn scan géolocalisé de positions est terminé
ranking.droppedLa position moyenne s'est dégradée d'au moins 1,5 rang depuis le scan précédent
audit.completedUn audit de fiche est prêt, sans interroger l'API en boucle
listing.google_changedGoogle a modifié une information de la fiche sans passer par vous
listing.disconnectedUn accès Google a été révoqué ou a expiré : les fiches ne se synchronisent plus
game.playedUn joueur tente sa chance sur un de vos jeux
lead_magnet.leadUn prospect remplit un aimant à leads et son scan est prêt
Agents

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
Développeurs et agents

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.

Créer mon compteParler à l'équipe