Pilotez Localnord depuis votre code ou votre agent.Pilotez Localnord depuisvotre code ou votre agent.

# Localnord · developers
 
## 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.
 
- 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 · 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
 
### Codes de statut
 
- `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é
- `500` : Erreur serveur
- `502` : Google a rejeté ou est indisponible
 
### Enveloppe de réponse
 
```
{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 50, "total": 134, "total_pages": 3 }
}
```
 
## 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.
 
### Événements
 
- `review.created` : Un client laisse un avis Google sur une fiche
- `review.negative` : Un avis de 3 étoiles ou moins arrive : le signal à router vers une alerte
- `publication.published` : Un Google Post planifié part en ligne
- `publication.failed` : Un Google Post n'a pas pu être publié, avec la cause du refus
- `photo.published` : Une photo planifiée est arrivée sur la fiche Google
- `ranking.completed` : Un scan géolocalisé de positions est terminé
- `ranking.dropped` : La position moyenne s'est dégradée d'au moins 1,5 rang depuis le scan précédent
- `audit.completed` : Un audit de fiche est prêt, sans interroger l'API en boucle
- `listing.google_changed` : Google a modifié une information de la fiche sans passer par vous
- `listing.disconnected` : Un accès Google a été révoqué ou a expiré : les fiches ne se synchronisent plus
- `game.played` : Un joueur tente sa chance sur un de vos jeux
- `lead_magnet.lead` : Un prospect remplit un aimant à leads et son scan est prêt
 
## 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.
 
### Ressources
 
- `https://app.localnord.io/api/v1/docs.md` : Référence API complète, publique et sans clé
- `/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
 
### Exemple
 
```
curl -H "Accept: text/markdown" https://www.localnord.io/en/pricing
```