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.
https://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
listingsLister, auditer, synchroniser et modifier les fiches Google.
reviewsLire les avis, générer et publier les réponses, lancer les campagnes.
publicationsRédiger, programmer et publier posts, photos et vidéos.
rankingsSuivi de positions locales, mots-clés et benchmarks concurrents.
prospectingChercher et enrichir des prospects, audits en marque blanche, marketplace.
reportingRapports PDF marque blanche, portail client, statistiques d'agence.
accountCré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
| Code | Signification |
|---|---|
| 400 | Corps ou paramètre invalide |
| 401 | Clé API absente ou inconnue |
| 402 | Crédits insuffisants (audits, campagnes) |
| 403 | Clé révoquée ou fiche en pause |
| 404 | Introuvable, ou hors de votre organisation |
| 409 | Conflit d'état (déjà publié, déjà répondu) |
| 429 | Quota 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.
| Event | Déclenché quand |
|---|---|
| review.created | Un nouvel avis est détecté |
| publication.published | Un Google Post est publié |
| ranking.completed | Un scan de classement se termine |
| game.played | Une partie du jeu de collecte d'avis est jouée |
| lead_magnet.lead | Un 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
- /llms.txt
Index du site pour les IA
- /kb/developers.md
Cette référence en Markdown
- /.well-known/mcp.json
Manifeste du serveur MCP
- /sitemap.xml
Sitemap complet
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.