Add Google Search Console plugin

[Daniel-Hodgson-SquaredUp]

What does this change do?

Adds a new Google Search Console plugin that enables users to connect a GSC property via OAuth 2.0 and visualize search performance data directly within SquaredUp.

The plugin includes the following data streams. along with default dashboards for both site-level and page-level SEO analysis:

• Country breakdown
• Device breakdown
• Page distribution
• Page performance over time
• Page performance summary
• Page URLs
• Pages
• Queries
• Queries by page
• Site performance over time
• Site performance summary

Why is it useful?

Google Search Console contains valuable SEO data and is one of the most widely used tools in the industry. It is also currently a gap in the SquaredUp plugin catalog.

This plugin allows users to:

• Monitor clicks, impressions, CTR, and average position over time
• Identify top-performing and under-performing pages
• Analyse search queries driving traffic to specific pages
• Break down performance by country and device
• Scope dashboards to indexed GSC page objects
• Compare current performance against previous periods

The included dashboards provide an out-of-the-box SEO reporting experience with minimal configuration required.

Testing performed

Validation

• Plugin successfully validated when deployed via the CLI
• Confirmed all plugin components were bundled correctly

Manual testing

Tested against a live Google Search Console property. A Google Pages test site was created and populated with content, with impressions and clicks generated over several weeks to produce representative Search Console data:

https://danielchodgson.github.io/gsc-lcp-test-site/index.html

Verified:

• Authentication and configuration flow
• All data streams return expected data
• Page indexing returns all discovered pages
• Dashboard variable integration using indexed GSC page objects
• Default Site Overview dashboard loads successfully
• Default Page Overview dashboard loads successfully
• Timeframe handling functions correctly
• Page scoping functions correctly

Screenshots

Known limitations / follow-ups

• Search Console API data is subject to Google's normal reporting delays and sampling behavior
• Testing has only been performed against a relatively small dataset; additional validation against larger Search Console properties would be beneficial

[github-actions]

🧩 Plugin PR Summary

📦 Modified Plugins

• plugins/GoogleSearchConsole/v1

📋 Results

Step	Status
Validation	✅ Passed
Deployment	🚀 Deployed

🔍 Validation Details

✅ google-search-console

{
  "valid": true,
  "pluginName": "google-search-console",
  "pluginType": "hybrid",
  "summary": {
    "Data Streams": 14,
    "Import Definitions": 1,
    "UI Configuration": true,
    "Has Icon": true,
    "Has Default Content": true,
    "Config Validation": false,
    "Custom Types": false
  }
}

[clarkd]

@claude review

[clarkd]

Could you clarify the intent here? You're rounding/stringifying and then converting back to a number which might lose some precision.

[clarkd]

As above

[clarkd]

As above

[clarkd]

This doesn't look quite right - the timeframe is 'now -> whatever end date selected in SquaredUp'

[clarkd]

Do this or other streams need paging configured?

[clarkd]

Can't quite get my head around what happens if selected yearly ranges or something here - do we need to restrict the available timeframes?

[clarkd]

Given we have data/time selection in SquaredUp - do we need these 'previous period' streams, or can the user effectively create them by setting the date appropriately on two tiles?

[clarkd]

Worth renaming this script name (and script1) to be more identifiable