Google Search Console

What is the GSC Integration?

The Google Search Console integration connects your real search performance data directly into Publish Owl. It works in two ways: as a research tool on the Research page and as a workflow step that feeds live search data into your content generation pipeline.

Unlike third-party keyword tools, GSC data comes from Google itself — actual clicks, impressions, CTR, and ranking positions for your site. This means your AI-generated content can be informed by exactly what queries your site is already appearing for.

Setup

Connecting Google Search Console requires a one-time OAuth setup:

Research Report

Once connected, a Search Console tab appears on the Research page. Click Fetch Report to pull your search performance data. The report includes an overview dashboard, opportunity analysis tabs, and a full sortable/filterable data table.

Overview Dashboard

Four stat cards at the top show your totals for the selected period, each with a percentage change compared to the previous period of equal length:

• Clicks — total clicks from search results
• Impressions — how many times your pages appeared in search
• Avg CTR — overall click-through rate
• Avg Position — average ranking position across all queries

Analysis Tabs

Below the overview, a tab bar lets you view the same data through different lenses. Each tab pre-filters the table to a specific category. The count badge on each tab shows how many queries match.

Computed Columns

Beyond the standard GSC metrics (clicks, impressions, CTR, position), the report adds computed columns to help you prioritize:

• Page — the URL ranking for each query (shown as pathname)
• Expected CTR — the average CTR for your ranking position based on industry studies. When your actual CTR is significantly below this, the cell highlights in red.
• Traffic Potential — estimated additional clicks if the query ranked #1, calculated as (impressions × 28%) minus current clicks. High values highlight in green.
• Trend — click change vs. the previous period, shown as an up/down arrow with the number of clicks gained or lost.

Filters & Tools

• Filters — filter by query text, page URL, clicks range, impressions range, and position range
• Unique pages only — deduplicates to show only the top query per page (by impressions), giving a page-level view
• Sortable columns — click any column header to sort ascending/descending
• Pagination — 100 rows per page with First/Prev/Next/Last navigation
• Export CSV — download results with all metrics, named after the selected property and tab
• Copy Queries — copy selected query strings to clipboard
• Rewrite Page — select a single query and click Rewrite Page to create a rewrite workflow pre-filled with the ranking URL

Workflow Step

Add a Google Search Console step to your workflow pipeline to feed real search data into subsequent LLM steps. The GSC step fetches data from the API, formats it as structured Markdown with opportunity analysis and traffic potential estimates, and passes it as context to the next step.

Configuration Options

Example: Data-Driven Content Update Workflow

A practical 2-step workflow that uses GSC data to write better content:

Caching

GSC API responses are cached for 24 hours to avoid redundant API calls. Since GSC data is inherently 2–3 days stale, caching doesn't reduce freshness. If you run the same query parameters within 24 hours (same site, date range, and filters), the cached result is returned instantly.

External API

You can add a GSC workflow step via the External API by including gscConfig in a workflow agent object:

{
  "provider": "gsc",
  "model": "",
  "prompt": "",
  "enabled": true,
  "gscConfig": {
    "siteUrl": "https://yoursite.com/",
    "dateRange": "28d",
    "sortBy": "impressions",
    "rowLimit": 100,
    "analysisType": "raw",
    "filters": {
      "queryContains": "best",
      "device": "MOBILE",
      "minImpressions": 50
    }
  }
}