Skip to main content
Use Google Search Console through Corsair: one client, typed API calls. The Search Console API reports on how Google sees a property: the queries and pages that earn clicks and impressions, what Google knows about a single URL, and the sitemaps submitted for it. Calls are made with an OAuth token belonging to an account that has access to the property. The only scope this plugin needs is https://www.googleapis.com/auth/webmasters, which covers the reads and the sitemap writes. Things to know before you call:
  • A property is named the way Search Console names it. https://example.com/ for a URL-prefix property, or sc-domain:example.com for a domain property. Both travel in the path, and the plugin encodes them.
  • Dates are Pacific Time. startDate and endDate are YYYY-MM-DD in the API’s own time zone, and the end date is included in the range.
  • rowLimit is 1 to 25,000, default 1,000. There is no page token: page with startRow, and a startRow past the end answers a successful empty page.
  • Results are grouped by the dimensions you ask for, sorted by clicks descending. ctr is a fraction, so 0.05 is 5%.
  • HOUR needs dataState: 'HOURLY_ALL', and hourly data only goes back 10 days. The plugin refuses the combination without the state rather than letting the API reject it.
  • type and searchType are the same setting. Send one; the plugin rejects both.
  • A sitemap’s feedpath is a full URL, not a path, and it is submitted with a PUT that has no body. Google fetches it.
  • URL inspection has its own quota: 2,000 per day and 600 per minute per site. Search Analytics allows 1,200 per minute per site, and a load-quota refusal asks for a 15 minute wait.
  • No inbound webhooks. The API does not send any.
What you get:
  • 10 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Read the top queries for a property over a month
Submit a sitemap
See the full list on the API page.

What’s next

API reference

Every googlesearchconsole.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.