Was macht SEOG — Lokales SEO via MCP?
Überblick
SEOG (seog.ai) ist eine KI-gestützte lokale SEO-Plattform für Unternehmen, die auf Google Maps präsent sind. Ihr entfernter MCP-Server macht das gesamte Produkt als 90 Tools verfügbar – dieselben Domain-Dienste, die auch die Knöpfe der Web-App aufrufen –, sodass ein Agent eine vollständige lokale SEO-Praxis durchführen kann, ohne einen Browser zu öffnen: ein Unternehmen importieren, Keywords verfolgen und ranken, die Map-Sichtbarkeit auf einem Geo-Raster scannen, Google-Bewertungen synchronisieren und beantworten, Wettbewerber beobachten, die Website und die Search Console prüfen, Google-Beiträge veröffentlichen und PDF-Berichte erstellen.
Endpunkt: https://api.seog.ai/mcp (streamable HTTP), authentifiziert mit einem persönlichen Token. Jeder Aufruf läuft als dieses SEOG-Konto – es gibt keinen anonymen Modus.
Anleitung
Einrichtung
Melden Sie sich unter https://app.seog.ai an, dann Einstellungen → MCP-Zugriff, um ein persönliches Token auszustellen (wird einmalig angezeigt). Installieren Sie entweder so:
Als Claude Code-Plugin (empfohlen – bündelt dieses Skill und die Serverkonfiguration):
/plugin marketplace add TerminalSkills/skills
/plugin install seog@terminal-skills
Claude Code fragt während der Installation nach dem Token und speichert es im Credential Store. Nicht-interaktiv (Skripte, CI):
claude plugin marketplace add TerminalSkills/skills
claude plugin install seog@terminal-skills --config mcp_token="$SEOG_MCP_TOKEN"
Überprüfen Sie mit /plugin list (seog → enabled) und /mcp (seog → connected).
Als Skill + manuell registrierter MCP-Server (jeder Client):
npx terminal-skills install seog
claude mcp add --transport http seog https://api.seog.ai/mcp \
--header "Authorization: Bearer $SEOG_MCP_TOKEN"
Für Codex / Gemini CLI / Cursor registrieren Sie einen HTTP-MCP-Server mit derselben URL und dem Authorization: Bearer-Header. Überprüfen Sie mit tools/list – 90 Tools vom Server seog-platform (weniger bei White-Label-Konten; siehe Richtlinien).
Konto, Tarif und Credits – vor der Nutzung kostenpflichtiger Tools lesen
- Das Token identifiziert ein SEOG-Konto; die Tools wirken nur auf die Daten dieses Kontos.
- SEOG berechnet in Credits (CR) nach einer Regel: alles, was eine externe API aufruft, ist kostenpflichtig, zum gleichen Preis wie der entsprechende Klick in der App. Das Lesen bereits gespeicherter Daten ist kostenlos. Das gilt auch für Rückgängig machen und Löschen – jeder Vorgang wiederholt einen Aufruf an Google.
get_credit_balancegibt den Kontostand + Tarif zurück;list_feature_pricesbepreist jedes kostenpflichtige Tool. Überprüfen Sie beides vor einem Multi-Business-Durchlauf.- Ein kostenpflichtiges Tool, das fehlschlägt, wird nicht berechnet (Liefer-oder-Rückerstattung), sodass ein fehlgeschlagener Durchlauf niemals stillschweigend Geld kostet.
create_reportist der eine asynchrone Fall: Es gibt sofort einen QUEUED-Bericht zurück, und die Belastung erfolgt, wenn das PDF generiert wird (wird rückerstattet, wenn es fehlschlägt). Fragen Sie daherget_reportab, anstatt anzunehmen, dass die Credits beim Einreihen abgebucht wurden.
Tool-Übersicht
Vollständige Parameterschemata und Preisangaben: references/mcp-tools.md.
💳 = verbraucht Credits.
| Bereich | Tools |
|---|---|
| Unternehmen | list_businesses, get_business, search_places💳, import_business💳, update_business, delete_business |
| Profil-Gesundheit | get_business_audit, get_action_plan, list_recommendations, analyze_business_profile, set_recommendation_status |
| Profilbearbeitung (schreibt auf Google) | apply_profile_fix💳, undo_profile_fix💳, draft_business_description💳, apply_business_description💳, undo_business_description💳, list_profile_photos, delete_profile_photo💳, get_profile_fix_options, list_recent_profile_edits |
| Rankings | list_keywords, add_keyword💳, check_keyword💳, refresh_rankings💳, keyword_history, keyword_recommendations💳, keyword_recommendations_cache, toggle_keyword, remove_keyword |
| Kartenraster + KI-Antworten | run_grid_scan💳, get_latest_grid_scan, get_keyword_grid_scan, get_grid_history, get_grid_snapshot, check_ai_overview💳, get_ai_overview |
| Bewertungen | list_reviews, review_stats, sync_reviews💳, draft_review_response, generate_review_reply💳, publish_review_reply💳, verify_review_reply💳 |
| Wettbewerber | discover_competitors💳, get_discovered_competitors, list_competitors, add_competitor💳, remove_competitor, set_competitor_watchlist, snapshot_competitor💳, refresh_competitors💳, compare_competitors, list_competitor_alerts, mark_competitor_alerts_read, scan_competitor_spam |
| KI-Sichtbarkeit | get_ai_visibility, get_ai_visibility_pillars, get_ai_presence_matrix, check_ai_visibility💳, list_citations, check_citations💳 |
| Website + Search Console | get_website_analysis, refresh_website_analysis💳, refresh_website_all💳, get_search_performance, get_search_console_status, load_search_performance💳 |
| Google-Beiträge | list_posts, get_post_templates, validate_post, draft_post_content💳, publish_post💳, refresh_posts💳, delete_post💳 |
| Google-Verbindung | get_google_connection_status, get_gbp_performance, load_gbp_performance💳, load_gbp_keyword_history💳, list_gbp_import_locations, import_gbp_business💳 |
| Konto + Berichte | get_dashboard, get_credit_balance, list_feature_prices, get_metrics_history, list_reports, create_report💳, get_report, delete_report, refresh_business_profile💳, refresh_business_overview💳 |
Kern-Workflows
Onboarding – search_places → import_business mit der gewählten placeId. Wenn das Google-Konto des Benutzers bereits verbunden ist, bevorzugen Sie list_gbp_import_locations → import_gbp_business: Es bindet die Inhaberverbindung, die für Bewertungsantworten und Beiträge erforderlich ist.
Rankings verfolgen – Lesen Sie keyword_recommendations_cache (kostenlos), bevor Sie für keyword_recommendations bezahlen; add_keyword (optional locationLabel, um aus einem Stadtteil zu ranken); check_keyword für eine einzelne Live-Überprüfung oder refresh_rankings für jedes aktive Keyword in einer einzigen Gebühr; keyword_history für den Trend; run_grid_scan für die Kartenabdeckung über ein Raster (der Preis skaliert mit der gridSize).
Bewertungen bearbeiten – sync_reviews → list_reviews(filter="needs-response") → generate_review_reply für einen Entwurf → Benutzer fragen → publish_review_reply (öffentlich auf Google sichtbar) → verify_review_reply, um zu bestätigen, dass es angekommen ist. draft_review_response speichert einen lokalen Entwurf und veröffentlicht nichts.
Profil korrigieren – get_action_plan / get_business_audit, um Lücken zu finden, dann apply_profile_fix (Telefon, Website, Öffnungszeiten, Name, Status) oder draft_business_description → apply_business_description. Beide schreiben in den Live-Eintrag; undo_profile_fix / undo_business_description machen dies rückgängig.
Über das Profil hinaus diagnostizieren – get_website_analysis + get_search_performance (kostenloses Lesen der letzten Durchläufe), refresh_website_all, um beide in einer Gebühr erneut auszuführen; get_ai_visibility_pillars und list_citations für die KI-Antwortbereitschaft und NAP-Konsistenz.
Beispiele
Beispiel 1: Wöchentlicher Bericht, credit-bewusst
„Wie läuft es diese Woche bei meinen Kunden?“
1. get_credit_balance → 180 CR (Growth-Plan) – genug für den Durchlauf
2. list_businesses → 15 Unternehmen
3. pro Unternehmen: refresh_rankings # eine Gebühr für alle aktiven Keywords
sync_reviews → list_reviews(filter="needs-response")
compare_competitors + list_competitor_alerts # beide kostenlos
4. generate_review_reply für jede negative unbeantwortete Bewertung → Entwürfe präsentieren
5. get_action_plan(businessId) → priorisierte Korrekturen für den Bericht
Die Veröffentlichung (publish_review_reply) wartet auf das ausdrückliche Ja des Inhabers.
Beispiel 2: Credits gehen mitten im Durchlauf aus
> run_grid_scan(businessId, keywordId, gridSize=7)
✗ Nicht genügend Credits: Diese Aktion kostet 45 CR und der Kontostand beträgt 12 CR.
Es wurde nichts ausgeführt und nichts berechnet. Laden Sie Guthaben auf oder upgraden Sie unter
https://app.seog.ai/billing, und versuchen Sie es erneut.
Richtiges Verhalten: Geben Sie die Zahlen und den Link weiter, stoppen Sie den kostenpflichtigen Durchlauf (nicht in einer Schleife wiederholen) und beenden Sie den Bericht mit kostenlosen Lesevorgängen – list_keywords,
get_latest_grid_scan, review_stats, get_action_plan funktionieren alle weiterhin.
Richtlinien
- Geld ist real. Führen Sie niemals ein kostenpflichtiges Tool aus, das der Benutzer nicht angefordert hat. Preisen Sie einen Batch mit
list_feature_pricesund prüfen Sie zuerstget_credit_balance. Bevorzugen Sie gebündelte Gebühren (refresh_rankings,refresh_website_all,refresh_business_overview) gegenüber Einzelposition-Schleifen – sie kosten weniger für die gleiche Arbeit. - Veröffentlichen ist öffentlich und schwer rückgängig zu machen.
publish_review_reply,publish_post,apply_profile_fixundapply_business_descriptionschreiben in den Live-Google-Eintrag. Zitieren Sie den genauen Text und holen Sie zuerst die Zustimmung ein. Das Ändern des UnternehmensNAMENS kann dazu führen, dass der Eintrag in die Google-Neuverifizierung geht – sagen Sie dies, bevor Sie es tun. - Irreversible Tools erfordern
confirm: true–delete_business,delete_profile_photo,delete_post,remove_keyword,remove_competitor,delete_report. Ohne das Flag weigern sie sich, ausgeführt zu werden, und das ist beabsichtigt: Zitieren Sie genau, was gelöscht wird, holen Sie ein Ja ein und übergeben Sie es dann.delete_businesswirkt sich kaskadierend auf Bewertungen, Keywords, Rankings und Wettbewerber aus; gelöschte Fotos und Beiträge können nicht wiederhergestellt werden. Bevorzugen Sietoggle_keyword, wenn der Benutzer nur das Tracking pausieren möchte. - Lesen Sie den Fehler, anstatt es erneut zu versuchen. Tool-Fehler erklären sich selbst:
INSUFFICIENT_CREDITSgibt Preis, Kontostand und die Aufladungs-URL an;PLAN_REQUIREDbedeutet, die Testversion ist abgelaufen oder es existiert kein Plan;FEATURE_NOT_IN_PLANnennt die Funktion und den Plan. Geben Sie diese weiter – eine Wiederholungsschleife schlägt nur erneut fehl. - Einige Tools fehlen bewusst. White-Label-/Agenturkonten erhalten nicht die Tools, die rohe Google-Inhalte zurückgeben (
search_places,check_keyword,sync_reviews,discover_competitors,run_grid_scan,import_gbp_business, …). Wenn ein Tool „nicht gefunden“ wird, sagen Sie, dass das Konto nicht dafür freigegeben ist, anstatt zu raten. - Fotoupload und Google / Search Console OAuth bleiben in der Web-App (Dateibytes und ein Browser). Alles andere ist hier verfügbar.
- IDs sind UUIDs, die auf das Konto des Tokens beschränkt sind – eine 404 bei einer gültig aussehenden UUID bedeutet normalerweise, dass sie zu einem anderen Konto gehört.
- Das Token ist eine Anmeldeinformation: Comitten Sie es niemals und entfernen Sie es aus Protokollen und Transkripten. Ein 401 bedeutet, dass es in den Einstellungen widerrufen wurde – bitten Sie den Benutzer, es neu auszustellen.