Files
marketingskills/tools/integrations/google-search-console.md
Corey Haines edcc34aa6d feat: add marketing tools registry for agent discovery
Create centralized tools/ directory with REGISTRY.md index and 29
integration guides covering analytics, SEO, CRM, payments, referral,
email, ads, automation, and commerce platforms.

Each guide includes API endpoints, authentication, common operations,
and links to relevant skills. Updated AGENTS.md and key skills
(referral-program, analytics-tracking, email-sequence, paid-ads)
with tool integration references.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 18:33:51 -08:00

2.8 KiB

Google Search Console

Free tool for monitoring website search performance and indexing.

Capabilities

Integration Available Notes
API Search Analytics API, URL Inspection API
MCP - Not available
CLI - Use gcloud or API scripts
SDK Google API client libraries

Authentication

  • Type: OAuth 2.0 or Service Account
  • Scopes: https://www.googleapis.com/auth/webmasters.readonly
  • Setup: Create credentials in Google Cloud Console

Common Agent Operations

Get search analytics

POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["query"],
  "rowLimit": 100
}

Get performance by page

POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page"],
  "rowLimit": 50
}

Get performance by country

POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["country", "query"],
  "rowLimit": 100
}

Inspect URL

POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect

{
  "inspectionUrl": "https://example.com/page",
  "siteUrl": "https://example.com/"
}

List sitemaps

GET https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/sitemaps

Authorization: Bearer {access_token}

Submit sitemap

PUT https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/sitemaps/{sitemap_url}

Authorization: Bearer {access_token}

Request indexing

POST https://indexing.googleapis.com/v3/urlNotifications:publish

{
  "url": "https://example.com/new-page",
  "type": "URL_UPDATED"
}

Dimensions

  • query - Search query
  • page - Page URL
  • country - Country code
  • device - Device type (MOBILE, DESKTOP, TABLET)
  • date - Date
  • searchAppearance - Search result type

Metrics

  • clicks - Clicks from search
  • impressions - Search impressions
  • ctr - Click-through rate
  • position - Average position

Filters

{
  "dimensionFilterGroups": [{
    "filters": [{
      "dimension": "query",
      "operator": "contains",
      "expression": "keyword"
    }]
  }]
}

When to Use

  • Analyzing search performance
  • Finding keyword opportunities
  • Monitoring indexing status
  • Submitting new pages for indexing
  • Identifying crawl issues
  • Tracking position changes

Rate Limits

  • 200 queries per minute
  • 1,200 requests per minute

Relevant Skills

  • seo-audit
  • programmatic-seo
  • analytics-tracking