Steuern Sie Localnord mit Ihrem Code oder Agenten.Steuern Sie Localnordmit Ihrem Code oder Agenten.

# Localnord · developers
 
## MCP-Server von Localnord
 
Verbinden Sie Claude, Claude Code oder jeden MCP-Client mit dem Localnord-Server: Ihr Agent listet Ihre Google-Einträge auf, führt Audits durch, schreibt Beiträge, antwortet auf Bewertungen und erstellt White-Label-Berichte.
 
- Endpoint: https://app.localnord.io/api/mcp/mcp
- Transport: Streamable HTTP
- Authentifizierung: OAuth 2.1
- Manifest: https://www.localnord.io/.well-known/mcp.json
 
### Tool-Familien
 
- `listings`: Google-Einträge auflisten, auditieren, synchronisieren und bearbeiten.
- `reviews`: Bewertungen lesen, Antworten erstellen und veröffentlichen, Kampagnen starten.
- `publications`: Google-Beiträge, Fotos und Videos verfassen, planen und veröffentlichen.
- `rankings`: Lokales Ranking-Tracking, Keywords und Wettbewerber-Benchmarks.
- `prospecting`: Leads suchen und anreichern, White-Label-Audits, Lead-Marktplatz.
- `reporting`: White-Label-PDF-Berichte, Kundenportal, Agenturstatistiken.
- `account`: Credits, Kontingente, Rechnungen, Team und Branding der Organisation.
 
## REST-API v1
 
Ein API-Schlüssel ist an genau eine Organisation gebunden: Jede Anfrage wird automatisch gefiltert, ein Schlüssel kann nie die Daten einer anderen Agentur lesen. Der Schlüssel wird nur einmal angezeigt und gehasht gespeichert.
 
- Basis-URL: https://app.localnord.io/api/v1
- Authentifizierung: Authorization: Bearer lnk_…
- Rate Limit: 10 000 req/day/key · reset 00:00 UTC
- Paginierung: ?page=1&per_page=50 (max 100)
- Kontingent-Header: X-RateLimit-Limit / -Remaining / -Reset
- Vollständige Referenz: https://app.localnord.io/api/v1/docs.md
 
### Statuscodes
 
- `400`: Ungültiger Body oder Parameter
- `401`: API-Schlüssel fehlt oder ist unbekannt
- `402`: Nicht genügend Credits (Audits, Kampagnen)
- `403`: Schlüssel widerrufen oder Eintrag pausiert
- `404`: Nicht gefunden oder außerhalb Ihrer Organisation
- `409`: Statuskonflikt (bereits veröffentlicht, bereits beantwortet)
- `429`: Kontingent oder Rate Limit überschritten
- `500`: Serverfehler
- `502`: Google hat abgelehnt oder ist nicht erreichbar
 
### Antwortstruktur
 
```
{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 50, "total": 134, "total_pages": 3 }
}
```
 
## Webhooks
 
Abonnieren Sie Localnord-Events mit einer HTTPS-URL (maximal 20 Webhooks pro Organisation). Ist ein Secret konfiguriert, wird jede Zustellung mit dem Header X-Webhook-Signature per HMAC-SHA256 signiert.
 
### Ereignisse
 
- `review.created`: Ein Kunde hinterlässt eine Google-Bewertung zu einem Eintrag
- `review.negative`: Eine Bewertung mit 3 Sternen oder weniger geht ein: das Signal für eine Warnmeldung
- `publication.published`: Ein geplanter Google-Beitrag geht online
- `publication.failed`: Ein Google-Beitrag konnte nicht veröffentlicht werden, mit Ablehnungsgrund
- `photo.published`: Ein geplantes Foto ist im Google-Eintrag online
- `ranking.completed`: Ein geolokalisierter Ranking-Scan ist abgeschlossen
- `ranking.dropped`: Die durchschnittliche Position hat sich seit dem letzten Scan um mindestens 1,5 Plätze verschlechtert
- `audit.completed`: Ein Eintrags-Audit ist fertig, ohne dass Sie die API abfragen müssen
- `listing.google_changed`: Google hat eine Angabe im Eintrag geändert, ohne Ihr Zutun
- `listing.disconnected`: Ein Google-Zugang wurde widerrufen oder ist abgelaufen: Die Einträge werden nicht mehr synchronisiert
- `game.played`: Ein Spieler versucht sein Glück bei einem Ihrer Spiele
- `lead_magnet.lead`: Ein Interessent füllt einen Lead-Magneten aus und sein Scan ist fertig
 
## Für KI-Agenten
 
Jede Seite von localnord.io hat eine Markdown-Darstellung: Senden Sie den Header Accept: text/markdown, und dieselbe URL antwortet in text/markdown mit Vary: Accept. Nicht unterstützte Medientypen liefern 406.
 
### Ressourcen
 
- `https://app.localnord.io/api/v1/docs.md`: Vollständige API-Referenz, öffentlich und ohne Schlüssel
- `/llms.txt`: Seitenindex für KI-Systeme
- `/kb/developers.md`: Diese Referenz in Markdown
- `/.well-known/mcp.json`: Manifest des MCP-Servers
- `/sitemap.xml`: Vollständige Sitemap
 
### Beispiel
 
```
curl -H "Accept: text/markdown" https://www.localnord.io/en/pricing
```