Google Search Console integration

Agent-WebmasterID reads verified search-visibility data from the official Google Search Console API. The agent does not scrape Google search results, does not invent keyword volume or difficulty, and does not guarantee rankings.

What you get

Verified clicks, impressions, CTR, and average position per keyword.
Page mapping — which page Google associated with each query.
Period-over-period comparison across operator-selected windows.
Optional country / device filters when supported by GSC.
Manual entries kept separately — operator-typed positions are never blended with verified averages.

OAuth scope

Agent-WebmasterID requests one scope only:

https://www.googleapis.com/auth/webmasters.readonly

That scope is read-only. The agent cannot edit your property, submit sitemaps, request re-indexing, or change any setting on your Search Console account.

Connecting Search Console

Sign in to your workspace, open Keyword Intelligence, and click Connect Google Search Console.
Sign in with the Google account that owns at least one verified Search Console property.
Pick the verified property you want the workspace to read from. The workspace can switch between properties later.
Click Fetch verified data to pull the last 28 days of search analytics.

What gets stored

Per workspace, the agent stores only the operator-facing scalars from the API response (query, page, clicks, impressions, CTR, average position, fetch window). The OAuth refresh token is encrypted server-side and never returned to the browser. Raw Google API responses are never logged.

What we never do

No SERP scraping — only the official Search Analytics API.
No invented keyword volume, difficulty, or SERP positions beyond GSC’s average position.
No background polling — the workspace fetches on demand.
No write access to your Search Console property.