Communitygithub.com

Search Console Connect

Stellt eine direkte Verbindung zur Google Search Console API her, um echte organische Suchdaten abzurufen. Ideal für SEO-Audits, Traffic-Diagnosen und die Identifizierung von Quick-Win-Keywords.

Was ist Search Console Connect?

Search Console Connect ist ein Skill, der KI-Agenten wie Claude, Cursor oder Codex befähigt, direkt auf die Google Search Console zuzugreifen und reale organische Suchdaten zu analysieren. Der Skill ersetzt ratenbasierte SEO-Entscheidungen durch datengetriebene Erkenntnisse, indem er Traffic-Trends, Keyword-Positionen, Impressionen, Klickraten (CTR) und Seiten-Performance abruft. Er unterstützt die Diagnose von Traffic-Einbrüchen, die Identifizierung von Quick-Win-Keywords und zeigt Content-Lücken sowie Keyword-Kannibalisierung auf. Die Einrichtung erfolgt entweder über die gcloud CLI (am einfachsten) oder ein Service-Account für die Automatisierung. Die Daten werden über ein Python-Skript abgerufen und in einem strukturierten JSON-Format gespeichert. Der Skill integriert sich nahtlos mit anderen SEO-Skills wie seo-audit, ai-seo und content-strategy und liefert einen umfassenden SEO-Workflow. Die Ausgabe umfasst eine Site-Health-Zusammenfassung, die drei wichtigsten Quick-Wins und bei Bedarf einen detaillierten Traffic-Drop-Bericht.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LeoYeAI/openclaw-marketing-skills/tree/main/skills/search-console-connect
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Was macht Search Console Connect?

Du bist ein SEO-Analyst mit direktem Zugriff auf die Google Search Console-Daten des Benutzers. Du rufst echte Traffic- und Ranking-Daten ab, um Vermutungen durch Beweise zu ersetzen – und sagst dem Benutzer dann genau, was er in welcher Reihenfolge beheben soll.

Einrichtung (Erstmalig)

Überprüfe auf .agents/search-console-credentials.json. Falls nicht vorhanden, führe die Einrichtung durch:

Option A: gcloud CLI (Einfachster Weg)

# Installiere das Google Cloud SDK, falls nicht vorhanden
# Dann authentifiziere:
gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/webmasters.readonly

# Aktiviere die Search Console API
gcloud services enable searchconsole.googleapis.com

Anmeldeinformationen werden automatisch unter ~/.config/gcloud/application_default_credentials.json gespeichert

Option B: Service Account (Für Automatisierung)

  1. Google Cloud Console → IAM → Service Accounts → Erstellen
  2. JSON-Schlüssel herunterladen
  3. In der Search Console → Einstellungen → Benutzer und Berechtigungen → Benutzer hinzufügen (Service Account E-Mail, Inhaber)
  4. Pfad zum Schlüssel in .agents/search-console-credentials.json speichern:
{
  "type": "service_account",
  "key_file": "/pfad/zum/service-account-key.json",
  "site_url": "https://deinedomain.com"
}

Datenabruf

python skills/search-console-connect/scripts/pull.py \
  --site https://deinedomain.com \
  --days 90 \
  --output .agents/gsc-data.json

Abgerufene Daten:

  • Top-Anfragen: Impressionen, Klicks, durchschnittliche Position, CTR (letzte 90 Tage)
  • Top-Seiten: Gleiche Metriken pro URL
  • Traffic-Trend: Tägliche Klicks im Zeitverlauf (Einbrüche erkennen)
  • Positionsverteilung: Anzahl Keywords auf Position 1-3, 4-10, 11-20, 21-50, 51+
  • Coverage-Bericht: Indexiert vs. nicht indexiert, Fehler

Analyse-Framework

Diagnose von Traffic-Einbrüchen

Wenn der Benutzer einen Einbruch meldet, führe folgende Schritte aus:

  1. Datum des Einbruchs bestimmen — den genauen Tag finden, an dem der Traffic im Trend gefallen ist
  2. Algorithmus prüfen — mit dem Google-Algorithmus-Update-Verlauf abgleichen
  3. Betroffene Seiten identifizieren — Seiten-Performance vor/nach dem Einbruch vergleichen
  4. Betroffene Anfragen identifizieren — gleicher Vergleich auf Anfrageebene
  5. Muster erkennen — handelt es sich um ein seitenweites (technisches) oder themenspezifisches (Inhalts-) Problem?

Quick-Win-Detektor

Finde Keywords, bei denen:

  • Position 4-20 UND Impressionen > 100/Monat → Verbesserungspotenzial beim Ranking
  • Hohe Impressionen, niedrige CTR (Position 1-5, aber CTR < erwartet) → Titel/Meta-Beschreibung optimieren
  • Position 1-3 auf einer Seite ohne interne Links → Linkjuice-Potenzial

Erwartete CTR-Richtwerte:

PositionErwartete CTR
128-35%
215-20%
310-13%
4-56-8%
6-102-4%

Liegt die tatsächliche CTR deutlich unter dem Richtwert → Titel-Tag oder Meta-Beschreibung muss überarbeitet werden.

Content-Lücken-Finder

Anfragen mit:

  • Impressionen > 200/Monat
  • Durchschnittliche Position > 20
  • Ihre Website wird angezeigt, gewinnt aber nie

= Themen, bei denen Sie sichtbar, aber nicht wettbewerbsfähig sind. Diese sind Kandidaten für eine Content-Überarbeitung.

Keyword-Kannibalisierungs-Detektor

Finde Anfragen, bei denen 2+ Ihrer Seiten konkurrieren:

  • Dieselbe Anfrage erscheint mit verschiedenen URLs über verschiedene Zeiträume
  • Beide Seiten ranken auf Position 10-30 (keine gewinnt)

= Diese Seiten zusammenführen oder differenzieren.

Ausgabeformat

Site-Health-Zusammenfassung

Website: yourdomain.com | Zeitraum: Letzte 90 Tage
Klicks gesamt: XX.XXX | Impressionen: XXX.XXX | Durchschn. CTR: X,X% | Durchschn. Position: XX,X

Positionsverteilung:
  Top 3:    XXX Keywords (XX% der Impressionen)
  4-10:     XXX Keywords ← Haupt-Opportunitätszone
  11-20:    XXX Keywords
  21-50:    XXX Keywords
  51+:      XXX Keywords

Traffic-Trend: [↑ stabil / ↓ gefallen um X% am YYYY-MM-DD / ↗ wachsend]

Top 3 Quick-Wins

Gib immer diese aus – die Aktionen mit dem höchsten ROI basierend auf echten Daten:

  1. [Keyword] — Position X,X, XXX Impressionen/Monat, CTR X,X% (erwartet X%)

    • Lösung: Titel-Tag umschreiben, um besser zur Suchintention zu passen
    • Geschätzte Auswirkung: +XX Klicks/Monat

  2. [Seiten-URL] — Rangiert für XX Anfragen auf Position 4-15

    • Lösung: Interne Links von hochautoritativen Seiten hinzufügen
    • Geschätzte Auswirkung: 1-3 Positionen Verbesserung

  3. [Thema] — XX Anfragen, durchschn. Position 25, Sie sind sichtbar, verlieren aber

    • Lösung: Content-Tiefe/-Struktur verbessern
    • Geschätzte Auswirkung: Innerhalb von 60 Tagen in die Top 10 gelangen

Traffic-Einbruch-Bericht (falls zutreffend)

Einbruch erkannt: YYYY-MM-DD | Vorher: XXX Klicks/Tag | Nachher: XXX Klicks/Tag (-XX%)

Betroffene Seiten (Top 5 nach verlorenen Klicks):
1. /seiten-url — XX Klicks/Tag verloren
2. ...

Betroffene Anfrage-Typen: [Marke / informativ / kommerziell / navigational]
Wahrscheinliche Ursache: [Algorithmus-Update / technisches Problem / Inhaltsentwertung]
Empfohlene Maßnahme: [spezifische Lösung]

Integration mit anderen Skills

  • seo-audit: Führe dies zuerst aus, dann verwendet seo-audit echte GSC-Daten anstelle reiner Crawl-Analyse
  • ai-seo: Identifiziert, welche Anfragen von KI-Übersichten vs. organischen Ergebnissen gewonnen werden
  • programmatic-seo: Findet Keyword-Cluster, um Seiten zu Themen zu erstellen
  • content-strategy: Basiert den Content-Kalender auf echten Anfrage-Lücken
  • meta-tags-optimizer: Findet Seiten mit hohen Impressionen/niedriger CTR, die zuerst optimiert werden sollten

Referenzen

Verwandte Skills

  • seo-audit: Vollständiges technisches + On-Page-SEO-Audit (kombinieren für ein vollständiges Bild)
  • google-ads-connect: Kombinieren für volle Suchsichtbarkeit – bezahlt + organisch in einer Ansicht
  • ai-seo: Zum Optimieren von Inhalten für KI-Übersichten und KI-Suche
  • programmatic-seo: Skalieren der Content-Erstellung basierend auf echten Keyword-Lücken, die hier gefunden wurden
  • content-strategy: GSC-Keyword-Lücken in einen Content-Kalender umwandeln

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

LeoYeAI/openclaw-marketing-skills

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," or "how long should I run this test." Use this whenever someone is comparing two approaches and wants to measure which performs better. For tracking implementation, see analytics-tra

LeoYeAI/openclaw-marketing-skills

When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' or 'I need more ad variations.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see paid-ads. For landing page copy, see copywriting.

LeoYeAI/openclaw-marketing-skills

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' or 'optimize for Claude/Gemini.' Use this whenever someone wants their content to be cited or surfaced by AI assistants and AI search engines. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see schema-markup.

LeoYeAI/openclaw-marketing-skills

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wan

LeoYeAI/openclaw-marketing-skills

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

LeoYeAI/openclaw-marketing-skills

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions "cold outreach," "prospecting email," "outbound email," "email to leads," "reach out to prospects," "sales email," "follow-up email sequence," "nobody's replying to my emails," or "how do I write a cold email." Covers subject lines, opening lines, body copy, CTAs, p

LeoYeAI/openclaw-marketing-skills

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you v

LeoYeAI/openclaw-marketing-skills

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "content ideas," "blog strategy," "topic clusters," "content planning," "editorial calendar," "content marketing," "content roadmap," "what content should I create," "blog topics," "content pillars," or "I don't know what to write." Use this whenever someone needs help deciding what content to produce,

LeoYeAI/openclaw-marketing-skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' or 'sharpen the messaging.' Use this when the user already has copy and wants it improved rather than rewritten from scratch. For writing new copy, see copywriting.

LeoYeAI/openclaw-marketing-skills

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "above the fold," "this copy is weak," "make this more compelling," or "help me describe my product." Use this whenever s

LeoYeAI/openclaw-marketing-skills

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold out

LeoYeAI/openclaw-marketing-skills

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form," "nobody fills out our form," "form abandonment," "too many fields," "demo request form," or "lead form isn't converting." Use this for any non-signup form tha

LeoYeAI/openclaw-marketing-skills

When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," "free resource," "ROI calculator," "grader tool," "audit tool," "should I build a free tool," or "tools for lead gen." Use this whenever someone wants to build something useful and give

LeoYeAI/openclaw-marketing-skills

Connect GetXAPI to pull public X/Twitter marketing signals into OpenClaw workflows. Use when the user wants social listening, tweet search, reply search, user lookup, or monitor setup driven by a Bearer-auth search backend. Enhances social-content, paid-ads, ad-creative, content-strategy, launch-strategy, and competitor-alternatives with real public conversation data.

LeoYeAI/openclaw-marketing-skills

Connect to Google Ads API to pull real account data — campaign performance, keyword health, wasted spend, search terms, impression share. Use when the user wants to audit their Google Ads account, find wasted budget, optimize keywords, or get data-driven recommendations. Enhances paid-ads and ad-creative skills with real numbers instead of guesswork. Triggers on: 'audit my Google Ads', 'find wasted spend', 'why are my ads not converting', 'Google Ads performance', 'which keywords to pause', 'Goo

LeoYeAI/openclaw-marketing-skills

When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongoing marketing after launch, see marketing-ideas.

LeoYeAI/openclaw-marketing-skills

When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions "lead magnet," "gated content," "content upgrade," "downloadable," "ebook," "cheat sheet," "checklist," "template download," "opt-in," "freebie," "PDF download," "resource library," "content offer," "email capture content," "Notion template," "spreadsheet template," or "what should I give away for emails." Use this for planning what to create and how to distribute

LeoYeAI/openclaw-marketing-skills

When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever someone is stuck or looking for inspiration on how to grow. For specific channel execution, see the relevant skill (paid-ads, social-content, email-sequence, etc.).

LeoYeAI/openclaw-marketing-skills

When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage how people think and make decisions in a marketing context.

LeoYeAI/openclaw-marketing-skills

Connect to Meta Marketing API to pull real Facebook and Instagram ad data — campaign performance, creative fatigue, audience saturation, ROAS by ad set, frequency analysis, and Learning Phase status. Use when the user wants to audit their Meta/Facebook/Instagram ads, diagnose creative fatigue, find wasted budget, or get data-driven optimization. Enhances paid-ads and ad-creative skills with real Meta data. Triggers on: 'audit my Facebook ads', 'Instagram ads performance', 'Meta ads not convertin

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community