DataForSEO: Live-SEO-Daten (Erweiterung)
Live-Suchdaten über den DataForSEO MCP-Server. Bietet Echtzeit-SERP-Ergebnisse (organisch + Bilder), Keyword-Kennzahlen, Backlink-Profile, On-Page-Analyse, Inhaltsanalyse, Brancheneinträge, KI-Sichtbarkeitsprüfung und LLM-Erwähnungs-Tracking über 9 API-Module mit 79+ MCP-Werkzeugen.
Voraussetzungen
Diese Fähigkeit erfordert die Installation der DataForSEO-Erweiterung:
./extensions/dataforseo/install.sh
Verfügbarkeit prüfen: Bevor Sie ein DataForSEO-Werkzeug verwenden, vergewissern Sie sich, dass der MCP-Server verbunden ist, indem Sie prüfen, ob serp_organic_live_advanced oder ein anderes DataForSEO-Werkzeug verfügbar ist. Wenn Werkzeuge nicht verfügbar sind, informieren Sie den Benutzer, dass die Erweiterung nicht installiert ist, und geben Sie Installationsanweisungen.
API-Kredit-Bewusstsein
DataForSEO berechnet pro API-Aufruf. Seien Sie effizient:
- Bevorzugen Sie Bulk-Endpunkte gegenüber mehreren Einzelaufrufen
- Verwenden Sie Standardparameter (USA, Englisch), sofern der Benutzer nichts anderes angibt
- Zwischenspeichern Sie Ergebnisse innerhalb einer Sitzung; rufen Sie dieselben Daten nicht erneut ab
- Warnen Sie den Benutzer vor teuren Operationen (vollständige Backlink-Crawls, große Keyword-Listen)
Kostenkontrollen
Vor jedem DataForSEO-MCP-Aufruf führen Sie eine Kostenschätzung durch:
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py check <endpoint> [--count N]
- Wenn
"status": "approved"→ fahren Sie mit dem API-Aufruf fort - Wenn
"status": "needs_approval"→ zeigen Sie dem Benutzer die Kostenschätzung und bitten Sie um Bestätigung, bevor Sie fortfahren - Wenn
"status": "blocked"→ informieren Sie den Benutzer, dass das Tagesbudget überschritten würde; fahren Sie NICHT fort
Nach Abschluss jedes API-Aufrufs protokollieren Sie die Kosten:
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py log <endpoint> <actual_cost>
Benutzerbefehle für Kostenverwaltung:
$seo dataforseo costs today→ zeigt die heutige Kostenaufschlüsselung$seo dataforseo costs summary→ zeigt die Kostenhistorie der letzten 7 Tage$seo dataforseo costs config --mode threshold --threshold 0.50→ konfiguriert den Freigabemodus
Laden Sie references/cost-tiers.md für die vollständige Preistabelle, Budgetvoreinstellungen und Kostensenkungstipps.
Kurzreferenz
| Befehl | Was er tut |
|---|---|
$seo dataforseo serp <keyword> | Google organische SERP-Ergebnisse |
$seo dataforseo serp-images <keyword> | Bildelemente aus der organischen SERP (der fixierte MCP-Server hat kein Google Bilder-Werkzeug) |
$seo dataforseo serp-youtube <keyword> | YouTube-Suchergebnisse |
$seo dataforseo youtube <video_id> | YouTube-Video-Tiefenanalyse |
$seo dataforseo keywords <seed> | Keyword-Ideen und -Vorschläge |
$seo dataforseo volume <keywords> | Suchvolumen für Keywords |
$seo dataforseo difficulty <keywords> | Keyword-Schwierigkeitsbewertungen |
$seo dataforseo intent <keywords> | Klassifizierung der Suchintention |
$seo dataforseo trends <keyword> | Google Trends-Daten |
$seo dataforseo backlinks <domain> | Vollständiges Backlink-Profil |
$seo dataforseo competitors <domain> | Konkurrenz-Domain-Analyse |
$seo dataforseo ranked <domain> | Ranglisten-Keywords für Domain |
$seo dataforseo intersection <domains> | Keyword-/Backlink-Überschneidungen |
$seo dataforseo traffic <domains> | Bulk-Traffic-Schätzung |
$seo dataforseo subdomains <domain> | Subdomains mit Ranglistendaten |
$seo dataforseo top-searches <domain> | Top-Anfragen, die die Domain erwähnen |
$seo dataforseo onpage <url> | On-Page-Analyse (Lighthouse + Parsing) |
$seo dataforseo tech <domain> | Erkennung des Technologie-Stacks |
$seo dataforseo whois <domain> | WHOIS-Registrierungsdaten |
$seo dataforseo content <keyword/url> | Inhaltsanalyse und Trends |
$seo dataforseo listings <keyword> | Brancheneinträge-Suche |
$seo dataforseo ai-scrape <query> | ChatGPT-Web-Scraper für GEO |
$seo dataforseo ai-mentions <keyword> | LLM-Erwähnungs-Tracking für GEO |
SERP-Analyse
$seo dataforseo serp <keyword>
Live-Google-Organische-Suchergebnisse abrufen.
MCP-Werkzeuge: serp_organic_live_advanced
Standardparameter: location_code=2840 (USA), language_code=en, device=desktop, depth=100
Unterstützt auch: Das Werkzeug serp_organic_live_advanced unterstützt Google, Bing und Yahoo über den Parameter se. Geben Sie "bing" oder "yahoo" an, um die Suchmaschine zu wechseln.
Ausgabe: Rang, URL, Titel, Beschreibung, Domain, Featured Snippets, KI-Übersichtsreferenzen, "Leute fragen auch"-Box (People Also Ask).
$seo dataforseo serp-youtube <keyword>
YouTube-Suchergebnisse abrufen. Wertvoll für GEO. YouTube-Erwähnungen korrelieren am stärksten mit KI-Zitaten.
MCP-Werkzeuge: serp_youtube_organic_live_advanced
Ausgabe: Video-Titel, Kanal, Aufrufe, Upload-Datum, Beschreibung, URL.
$seo dataforseo youtube <video_id>
Tiefenanalyse eines bestimmten YouTube-Videos: Informationen, Kommentare und Untertitel. Behandeln Sie YouTube-Erwähnungen als nützliches GEO-Signal, aber KI-Sichtbarkeitskorrelationen sind methodenabhängig.
MCP-Werkzeuge: serp_youtube_video_info_live_advanced, serp_youtube_video_comments_live_advanced, serp_youtube_video_subtitles_live_advanced
Parameter: video_id (die YouTube-Video-ID, z.B. "dQw4w9WgXcQ")
Ausgabe: Video-Metadaten (Titel, Kanal, Aufrufe, Likes, Beschreibung), Top-Kommentare mit Engagement, Untertitel-/Transkripttext.
$seo dataforseo serp-images <keyword>
Melden Sie die Bildelemente, die Google in den organischen Ergebnissen für ein Keyword anzeigt (der fixierte MCP-Server hat kein Google Bilder-Werkzeug, dies ist also keine vollständige Bilder-SERP). Sehen Sie, welche Bilder erscheinen, welche Domains sie dominieren, und identifizieren Sie visuelle Content-Möglichkeiten.
MCP-Werkzeuge: keine. Der fixierte [email protected] stellt kein Google Bilder-SERP-Werkzeug bereit (überprüft gegen das Paket, 23.09.2026). Sagen Sie, dass Bilder-SERP-Daten über das MCP nicht verfügbar sind, und nennen Sie niemals ein Werkzeug mit diesem Namen; ein images-Element in den Ergebnissen von serp_organic_live_advanced ist, wenn vorhanden, der beste Ersatz.
Standardparameter: location_code=2840 (USA), language_code=en, device=desktop, depth=100
Parameter: keyword (erforderlich), depth (optional, maximal 700, abgerechnet pro 100-Ergebnisse-Schritt), search_param (optional, z.B. "site:example.com")
Kostenwarnung: Die Verwendung der Operatoren site: oder filetype: verursacht 5-fache API-Kosten. Warnen Sie den Benutzer, bevor Sie gefilterte Abfragen ausführen.
Ausgabe: Position, Titel, Alt-Text, Quellseiten-URL, direkte Bild-URL, Domain, codierte URL.
Zu liefernde Analyse:
- Domain-Dominanz: welche Websites die meisten Bild-Positionen besitzen (Top 10 Domains nach Anzahl)
- Alt-Text-Muster: häufige Titel-/Alt-Text-Muster in den bestplatzierten Bildern
- Formatverteilung: WebP vs. JPEG vs. PNG in den Top-Ergebnissen (aus der Bild-URL-Erweiterung ableiten)
- Chancenidentifikation: Keywords, bei denen der Benutzer organische Rankings hat, aber keine Bild-Präsenz
Keyword-Recherche
$seo dataforseo keywords <seed>
Keyword-Ideen, Vorschläge und verwandte Begriffe aus einem Seed-Keyword generieren.
MCP-Werkzeuge: dataforseo_labs_google_keyword_ideas, dataforseo_labs_google_keyword_suggestions, dataforseo_labs_google_related_keywords
Standardparameter: location_code=2840 (USA), language_code=en, limit=50
Ausgabe: Keyword, Suchvolumen, CPC, Wettbewerbsniveau, Keyword-Schwierigkeit, Trend.
$seo dataforseo volume <keywords>
Suchvolumen und Metriken für eine Liste von Keywords abrufen.
MCP-Werkzeuge: kw_data_google_ads_search_volume
Parameter: keywords (Array, kommagetrennt), location_code, language_code
Ausgabe: Keyword, monatliches Suchvolumen, CPC, Wettbewerb, monatliche Trenddaten.
$seo dataforseo difficulty <keywords>
Keyword-Schwierigkeitsbewertungen für die Ranking-Konkurrenzberechnung.
MCP-Werkzeuge: dataforseo_labs_bulk_keyword_difficulty
Parameter: keywords (Array), location_code, language_code
Ausgabe: Keyword, Schwierigkeitsbewertung (0-100), Interpretation (Einfach/Mittel/Schwer/Sehr Schwer).
$seo dataforseo intent <keywords>
Klassifizieren Sie Keywords nach der Suchintention des Benutzers.
MCP-Werkzeuge: dataforseo_labs_search_intent
Parameter: keywords (Array), location_code, language_code
Ausgabe: Keyword, Intentionstyp (informational, navigational, commercial, transactional), Konfidenzwert.
$seo dataforseo trends <keyword>
Analysieren Sie Keyword-Trends im Zeitverlauf mit Google Trends-Daten.
MCP-Werkzeuge: kw_data_google_trends_explore
Parameter: keywords (Array), location_code, date_from, date_to, language_code
Ausgabe: Keyword, Zeitreihendaten, Trendrichtung, Saisonalitätssignale.
Domain- & Wettbewerbsanalyse
$seo dataforseo backlinks <domain>
Umfassende Backlink-Profilanalyse.
MCP-Werkzeuge: backlinks_summary, backlinks_backlinks, backlinks_anchors, backlinks_referring_domains, backlinks_bulk_spam_score, backlinks_timeseries_summary
Standardparameter: limit=100 pro Unteraufruf
Ausgabe: Gesamtanzahl Backlinks, rückverweisende Domains, Domain-Rang, Spam-Score, Top-Anker, neue/verlorene Backlinks im Zeitverlauf, Dofollow-Verhältnis, Top-rückverweisende Domains.
$seo dataforseo competitors <domain>
Konkurrierende Domains identifizieren und Traffic schätzen.
MCP-Werkzeuge: dataforseo_labs_google_competitors_domain, dataforseo_labs_google_domain_rank_overview, dataforseo_labs_bulk_traffic_estimation
Ausgabe: Konkurrenz-Domains, Keyword-Überschneidungsprozentsatz, geschätzter Traffic, Domain-Rang, gemeinsame Keywords.
$seo dataforseo ranked <domain>
Listen Sie Keywords auf, für die eine Domain rankt, einschließlich Positionen und Seitendaten.
MCP-Werkzeuge: dataforseo_labs_google_ranked_keywords, dataforseo_labs_google_relevant_pages
Standardparameter: limit=100, location_code=2840
Ausgabe: Keyword, Position, URL, Suchvolumen, Traffic-Anteil, SERP-Features.
$seo dataforseo intersection <domain1> <domain2> [...]
Finden Sie gemeinsame Keywords und Backlink-Quellen über 2-20 Domains hinweg.
MCP-Werkzeuge: dataforseo_labs_google_domain_intersection, backlinks_domain_intersection
Parameter: domains (2-20 Array)
Ausgabe: Gemeinsame Keywords mit Positionen pro Domain, gemeinsame Backlink-Quellen, einzigartige Keywords pro Domain.
$seo dataforseo traffic <domains>
Schätzen Sie den organischen Suchverkehr für eine oder mehrere Domains.
MCP-Werkzeuge: dataforseo_labs_bulk_traffic_estimation
Parameter: domains (Array)
Ausgabe: Domain, geschätzter organischer Traffic, geschätzte Verkehrskosten, Top-Keywords.
$seo dataforseo subdomains <domain>
Zählen Sie Subdomains mit ihren Ranglistendaten und Traffic-Schätzungen auf.
MCP-Werkzeuge: dataforseo_labs_google_subdomains
Parameter: target (domain), location_code, language_code
Ausgabe: Subdomain, Anzahl der platzierten Keywords, geschätzter Traffic, organische Kosten.
$seo dataforseo top-searches <domain>
Finden Sie die beliebtesten Suchanfragen, die eine bestimmte Domain in den Ergebnissen erwähnen.
MCP-Werkzeuge: dataforseo_labs_google_top_searches
Parameter: target (domain), location_code, language_code
Ausgabe: Anfrage, Suchvolumen, Domain-Position, SERP-Features, Traffic-Anteil.
Technisch / On-Page
$seo dataforseo onpage <url>
Führen Sie eine On-Page-Analyse durch, einschließlich Lighthouse-Prüfung und Inhalts-Parsing.
MCP-Werkzeuge: on_page_instant_pages, on_page_content_parsing, on_page_lighthouse
Verwendung:
on_page_instant_pages: Schnelle Seitenanalyse (Statuscodes, Meta-Tags, Inhaltsgröße, Seitenladezeiten, defekte Links, On-Page-Prüfungen)on_page_content_parsing: Seiteninhalt extrahieren und parsen (Klartext, Wortanzahl, Struktur)on_page_lighthouse: Vollständige Lighthouse-Prüfung (Performance-Score, Barrierefreiheit, Best Practices, SEO, Core Web Vitals)
Ausgabe: Gecrawlte Seiten, Statuscodes, Meta-Tags, Titel, Inhaltsgröße, Ladezeiten, Lighthouse-Ergebnisse, defekte Links, Ressourcenanalyse.
$seo dataforseo tech <domain>
Erkennen Sie die auf einer Domain verwendeten Technologien.
MCP-Werkzeuge: domain_analytics_technologies_domain_technologies
Ausgabe: Technologiename, Version, Kategorie (CMS, Analytics, CDN, Framework usw.).
$seo dataforseo whois <domain>
WHOIS-Registrierungsdaten abrufen.
MCP-Werkzeuge: domain_analytics_whois_overview
Ausgabe: Registrar, Erstellungsdatum, Ablaufdatum, Nameserver, Registranteninformationen (falls öffentlich).
Inhalts- & Geschäftsdaten
$seo dataforseo content <keyword/url>
Analysieren Sie die Inhaltsqualität, suchen Sie nach Inhalten nach Thema und verfolgen Sie Phrasen-Trends.
MCP-Werkzeuge: content_analysis_search, content_analysis_summary, content_analysis_phrase_trends
Parameter: keyword (für Suche/Trends) oder URL (für Zusammenfassung)
Ausgabe: Inhaltsübereinstimmungen mit Qualitätsbewertungen, Stimmungsanalyse, Lesbarkeitsmetriken, Phrasen-Trenddaten im Zeitverlauf.
$seo dataforseo listings <keyword>
Durchsuchen Sie Brancheneinträge für lokale SEO-Wettbewerbsanalyse.
MCP-Werkzeuge: business_data_business_listings_search
Parameter: keyword, location (optional)
Ausgabe: Firmenname, Beschreibung, Kategorie, Adresse, Telefon, Domain, Bewertung, Anzahl Bewertungen, Claim-Status.
KI-Sichtbarkeit / GEO
$seo dataforseo ai-scrape <query>
Scrapen, was die ChatGPT-Websuche für eine Anfrage zurückgibt. ChatGPT-Sichtbarkeitsprüfung: Sehen Sie, welche Quellen ChatGPT für Ihre Ziel-Keywords zitiert. Überprüfen Sie Google AI Overviews und den KI-Modus mit GSC-Gen-AI-Berichten, wenn verfügbar.
MCP-Werkzeuge: ai_optimization_chat_gpt_scraper
Parameter: query, location_code (optional), language_code (optional). Verwenden Sie ai_optimization_chat_gpt_scraper_locations, um verfügbare Standorte nachzuschlagen.
Ausgabe: ChatGPT-Antwortinhalt, zitierte Quellen/URLs, referenzierte Domains.
$seo dataforseo ai-mentions <keyword>
Verfolgen Sie, wie LLMs Marken, Domains und Themen erwähnen. Entscheidend für GEO. Misst die tatsächliche KI-Sichtbarkeit über mehrere LLM-Plattformen hinweg.
MCP-Werkzeuge: ai_opt_llm_ment_search, ai_opt_llm_ment_top_domains, ai_opt_llm_ment_top_pages, ai_opt_llm_ment_agg_metrics
Parameter: keyword, location_code (optional), language_code (optional). Verwenden Sie ai_opt_llm_ment_loc_and_lang für verfügbare Standorte/Sprachen und ai_optimization_llm_models für unterstützte LLM-Modelle.
Arbeitsablauf:
- Suchen Sie LLM-Erwähnungen mit
ai_opt_llm_ment_search(finden Sie Erwähnungen einer Marke/eines Keywords in LLM-Antworten) - Rufen Sie die Top-Domains mit
ai_opt_llm_ment_top_domainsab (welche Domains am häufigsten von LLMs zitiert werden) - Rufen Sie die Top-Seiten mit
ai_opt_llm_ment_top_pagesab (welche Seiten am häufigsten zitiert werden) - Aggregierte Metriken mit
ai_opt_llm_ment_agg_metrics(Gesamtzahl der Erwähnungen, Stimmung, Sichtbarkeits-Trends)
Ausgabe: Marken/Keyword-Erwähnungen, Quell-LLM-Modelle, Kontext der Erwähnungen, Stimmungsanalyse, Sichtbarkeitsmetriken, Top-Domains und Top-Seiten.
Fähigkeitenreferenz
Ausgabeformatierung
- Formatieren Sie Dateninspektionstabellen mit Code-Blöcken und konsistenten Spaltenbreiten
- Geben Sie immer die verwendeten Parameter an (Standort, Sprache, Suchmaschine, Tiefe)
- Heben Sie wichtige, vergrabene Erkenntnisse hervor (z.B. Featured Snippets, KI-Übersichtsreferenzen, Daten zur visuellen Inhaltsplatte)
- Wenn Sie mehrere Werkzeuge aufrufen, um eine Anfrage zu beantworten, listen Sie sie als nummerierte Liste auf, wie Sie vorgegangen sind
- Fügen Sie immer eine Zusammenfassung der wichtigsten Ergebnisse (oder einen Kurzbericht) in die Antwort ein
Tool-Argumente
Verwenden Sie keine allgemeinen location_code=2840 und language_code=en; wenn Benutzer einen anderen Standort/eine andere Sprache anfordern, schlagen Sie den passenden Code mit den entsprechenden DataForSEO-Standort-Suchwerkzeugen nach:
- ``dataforseo_labs_locations_and_languages`
Mapping von Standortnamen zu DataForSEO-Codes ist nicht erforderlich; DataForSEO-Aufrufe akzeptieren eine "location_name" als String (z. B. "United States") und einen "language_name" (z. B. "English") als Alternative zu numerischen Codes.
Annahmen
Diese Fähigkeit geht davon aus, dass der DataForSEO MCP-Server unter dem Namen dataforseo-mcp-server im Codex-MCP-Konfigurationssystem registriert ist. Sie geht auch davon aus, dass die Skripte im Verzeichnis scripts/codex-seo mit dem Befehl "${CODEX_SEO_ROOT}/scripts/codex-seo" und einem Unterbefehl ausführbar sind.