← All agent tools

Developer tools Google

Google Search Console API

Read search performance and indexing information for website properties your Google account is allowed to access.

Source review: 2026-10-18 · Imported: 1 November 2026

A practical starting point

What could you build?

A site owner’s assistant can compare query impressions and identify pages whose search traffic changed.

Before you connect

Request only the OAuth scopes you need. Access to the API does not grant access to somebody else’s website property.

Capabilities & requirements

Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.

Google Search Console API specifications
CapabilityDetails and source
StatusNot published

The API docs (v3 / webmasters) carry no stage label.

Source (external) · Not published by vendor: checked 2026-10-18 on https://developers.google.com/webmaster-tools/about
API key requiredOAuth 2.0 token

Scopes webmasters.readonly or webmasters; our request without a token returned HTTP 401.

Source (external) · Verified 2026-10-18 by test request to https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Free tierFree of charge

Google says all use is free, subject to usage limits.

Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/pricing
Rate limit1,200/min per site and per user

Search Analytics; 40,000/min and 30M/day per project, plus load quotas. URL Inspection: 2,000/day per site.

Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/limits
Official MCP serverCommunity servers only

No Google MCP server; AminForou/mcp-gsc is an MIT-licensed community option.

Source (external) · Verified 2026-10-18 on https://github.com/AminForou/mcp-gsc
Official SDKGoogle API client libraries

Google recommends its client libraries, which also handle OAuth.

Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/about
Data license / termsGoogle APIs Terms of Service

Plus the API Services User Data Policy for apps that handle other people’s data.

Source (external) · Verified 2026-10-18 on https://developers.google.com/terms
Commercial use allowedAllowed under Google APIs ToS

The terms carry no non-commercial restriction; the data is about sites you manage.

Source (external) · Verified 2026-10-18 on https://developers.google.com/terms
CORS / browser useOrigin echoed back

A preflight to www.googleapis.com/webmasters/v3 returned Access-Control-Allow-Origin for our origin.

Source (external) · Verified 2026-10-18 by test request to https://www.googleapis.com/webmasters/v3/sites
Freshness / coverageFinalized by default; “all” adds fresh

dataState all includes fresh, partial data; hourly_all gives hourly rows.

Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/v1/searchanalytics/query

Operational reference

Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.

Price

Free: Google says all use of the Search Console API is free of charge, subject to usage limits.

Provider reference (external)

API key / auth

OAuth 2.0 access token with scope webmasters.readonly (read-only) or webmasters (read/write), for a Google account with owner, full or read access to the property. Our request without a token on 2026-10-18 returned HTTP 401 UNAUTHENTICATED.

Provider reference (external)

Rate limit

Search Analytics: 1,200 queries a minute per site and per user, 40,000 a minute and 30,000,000 a day per project, plus short- and long-term load quotas. URL Inspection: 2,000 a day and 600 a minute per site. Other resources: 20 a second and 200 a minute per user.

Provider reference (external)

Row limit

rowLimit is 1–25,000 (default 1,000); page with startRow. Google says the API returns top rows, not necessarily every row. Dates are in Pacific Time.

Provider reference (external)

Terms

Google APIs Terms of Service (last modified Nov 9, 2021) apply, including the API Services User Data Policy if your app handles other people’s data.

Provider reference (external)

MCP server (community)

No official Google MCP server for Search Console. A widely used open-source one is AminForou/mcp-gsc (MIT license, about 1,965 GitHub stars on 2026-10-18).

Provider reference (external)

Setup references

HTTP request example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

# Not run: needs an OAuth token for a property you manage
curl -X POST \
  "https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query" \
  -H "Authorization: Bearer $GSC_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startDate":"2026-10-01","endDate":"2026-10-15","dimensions":["query"],"rowLimit":10}'
Agent connection example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

// Claude Desktop / Cursor: community MCP server AminForou/mcp-gsc (MIT), per its README
// Create an OAuth desktop client in Google Cloud first and download client_secrets.json.
{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json" }
    }
  }
}
// For reporting only, give the Google account behind it read access to the property, not owner.

A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.

Other connections to explore

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.