Aufbau einer SEO-Automatisierungspipeline mit der Google Search Console API

Die GSC API ist eine der nützlichsten kostenlosen Datenquellen für SEO. Statt sie jeden Tag manuell zu prüfen, zeigt dieser Leitfaden, wie sich die Daten über eine Pipeline automatisch sammeln und analysieren lassen.

Kernaussage: Mit SEO-Automatisierung über die Google Search Console API können Sie die Effizienz um 100% steigern.

Voraussetzungen

1. 1Google Cloud Console-Projekt
2. 2Service Account erstellen + JSON-Schlüssel herunterladen
3. 3Google Search Console API aktivieren
4. 4E-Mail-Adresse des Service Accounts in GSC als Property-Nutzer hinzufügen

Schritt 1: Authentifizierung per Service Account

import { SignJWT } from "jose"

async function getAccessToken(saJson: string) {
  const key = JSON.parse(saJson)
  const now = Math.floor(Date.now() / 1000)
  const jwt = await new SignJWT({
    scope: "https://www.googleapis.com/auth/webmasters.readonly",
  })
    .setProtectedHeader({ alg: "RS256", typ: "JWT" })
    .setIssuer(key.client_email)
    .setAudience("https://oauth2.googleapis.com/token")
    .setIssuedAt(now)
    .setExpirationTime(now + 3600)
    .sign(await importPrivateKey(key.private_key))

  const res = await fetch("https://oauth2.googleapis.com/token", {
    method: "POST",
    body: new URLSearchParams({
      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
      assertion: jwt,
    }),
  })
  const { access_token } = await res.json()
  return access_token
}

Schritt 2: Leistungsdaten abfragen

async function queryGSC(token: string, siteUrl: string) {
  const url = `https://searchconsole.googleapis.com/webmasters/v3/sites/${encodeURIComponent(siteUrl)}/searchAnalytics/query`

  const body = {
    startDate: "2026-03-25",
    endDate: "2026-04-21",
    dimensions: ["query", "page"],
    rowLimit: 1000,
  }

  const res = await fetch(url, {
    method: "POST",
    headers: { Authorization: `Bearer ${token}` },
    body: JSON.stringify(body),
  })
  return res.json()
}

Schritt 3: Automatisierte Pipeline (CF Workers + D1)

// 매일 새벽 3시 실행
export default {
  async scheduled(event: ScheduledEvent, env: Env) {
    const token = await getAccessToken(env.GSC_SA_JSON)
    const data = await queryGSC(token, env.GSC_SITE_URL)

    // D1에 저장
    for (const row of data.rows) {
      await env.DB.prepare(
        "INSERT INTO gsc_daily (date, query, page, clicks, impressions, ctr, position) VALUES (?, ?, ?, ?, ?, ?, ?)"
      ).bind(new Date().toISOString().slice(0, 10), row.keys[0], row.keys[1], row.clicks, row.impressions, row.ctr, row.position).run()
    }
  },
}

wrangler.toml:

[triggers]
crons = ["0 18 * * *"]

# 매일 KST 03:00

Schritt 4: Alarm-Automatisierung

// 급락 키워드 감지
const sql = `
  SELECT query, SUM(clicks) as recent_clicks,
    (SELECT SUM(clicks) FROM gsc_daily WHERE query=g.query AND date BETWEEN DATE(?, '-14 days') AND DATE(?, '-8 days')) as prev_clicks
  FROM gsc_daily g
  WHERE date >= DATE(?, '-7 days')
  GROUP BY query
  HAVING prev_clicks > 10 AND recent_clicks < prev_clicks * 0.5
`
const dropped = await env.DB.prepare(sql).bind(today, today, today).all()

if (dropped.results.length > 0) {
  await fetch(telegramUrl, {
    method: "POST",
    body: JSON.stringify({
      chat_id: env.CHAT_ID,
      text: `급락 키워드 ${dropped.results.length}개 감지`,
    }),
  })
}

Anwendungsfälle

1. 1Automatisierte tägliche Erfassung der Performance: In D1 speichern, um Trendanalysen zu ermöglichen
2. 2Früherkennung von Indexierungsproblemen: Benachrichtigungen senden, wenn Impressionen stark einbrechen
3. 3Opportunity-Keywords entdecken: Keywords auf den Positionen 11-20 (Seite 2) automatisch extrahieren -> Priorität für Überarbeitung
4. 4Rankings zur Seitenperformance: Top-Seiten nach Klicks automatisch melden

Kostenloses Kontingent

• Standardmäßig 50.000 Abfragen pro Tag (pro Projekt)
• Für den praktischen Einsatz nahezu unbegrenzt

💡 Praxiserkenntnisse

Andere Blogs sagen oft nur, dass „die Integration der GSC API nützlich ist“. Beim Betrieb einer koreanischen Website ist jedoch am wichtigsten: automatisierte Handlungsauslöser, nicht die Datensammlung. Nachdem ich dies sechs Monate lang betrieben hatte, stellte ich fest, dass der größte Wert der GSC API in Punkt 3 liegt: der automatischen Extraktion von Opportunity-Keywords. Laut offizieller Google-Dokumentation haben Keywords auf den Positionen 11-20 eine durchschnittliche CTR von unter 1,5%, aber allein durch Verbesserungen an Meta-Tags, H1 und internen Links lässt sich die CTR auf 7-12% erhöhen. Anders gesagt: Mit demselben Traffic können Sie mehr als das Fünffache an Wirkung erzielen. Bei koreanischsprachigen Websites entfallen etwa 60% des Traffics auf Naver (basierend auf der Internet Usage Survey 2024). Daher ist es effizient, Naver Search Advisor RSS und Sitemap-Einreichungen zusammen mit GSC in derselben Pipeline zu verarbeiten. Da außerdem das Feld position ein Durchschnittswert und damit verrauscht ist, sollten Trends anhand von mindestens 14 Tagen kumulierter Daten bewertet werden. Bei 7-Tage-Fenstern ist es schwierig, einen „starken Einbruch“ von „Wochentagsschwankungen“ zu unterscheiden.

Fazit

Sobald die GSC API angebunden ist, können Sie „jedes Problem erkennen, ohne das GSC-Dashboard zu öffnen.“ Mit dem kostenlosen Tarif von CF Workers lassen sich Cron-Jobs, D1 und Benachrichtigungen komplett ohne Betriebskosten ausführen. Wenn Sie SEO ernst nehmen, lohnt es sich definitiv, eine Woche zu investieren.

Referenz: Google Search Central

Häufig gestellte Fragen (FAQ)

F1. Was kann ich mit der Google Search Console API automatisieren?

A: Sie können Suchanfragen, Seiten, Klicks, Impressionen, CTR und Rankingdaten erfassen, um Berichte und Optimierungsaufgaben zu automatisieren.

F2. Was brauche ich, um die GSC API zu nutzen?

A: Sie benötigen Berechtigungen für die Search Console-Property, ein Google Cloud-Projekt und entweder einen Service Account oder eine OAuth-Authentifizierung.

F3. Wie sollte ich eine SEO-Automatisierungspipeline strukturieren?

A: Bauen Sie sie in dieser Reihenfolge auf: tägliche Datenerfassung, Speicherung, Anomalieerkennung, Keyword-Clustering und Berichtszustellung.

F4. Wie genau sind GSC-Daten?

A: Es kann Sampling und Verzögerungen geben, aber für die tatsächliche Google Search-Performance ist sie die nützlichste kostenlose Datenquelle.

F5. Wie finde ich Keyword-Chancen mit der GSC API?

A: Priorisieren Sie die Analyse von Suchanfragen mit hohen Impressionen und niedriger CTR, Seiten mit Rankings auf den Positionen 4-15 sowie URLs, die stark gefallen sind.

F6. Worauf sollte ich bei SEO-Automatisierung achten?

A: Sie müssen Datenverzögerungen berücksichtigen, Brand-Queries trennen, Länder- und Gerätefilter anwenden und doppelte URLs kanonisieren.