01 / Getting Started

1-Line Quickstart

# ⚡ 1-Line Universal Installer
curl -fsSL https://gsc.builditwithai.xyz/install | bash

# 📦 Run directly via Python (uvx)
uvx google-search-console-mcp

# 📦 Run directly via Node (npx)
npx -y google-search-console-mcp

02 / Capabilities

The Search Console Bridge

1. 📈 Query & Keyword Performance

Fetches clicks, impressions, CTR, and average position metrics broken down by query, page URL, device type, and country.

2. 🔍 Real-Time URL Inspection

Checks Googlebot crawl state, canonical URL selection, mobile usability, and index coverage for any specific page.

3. 🗺️ Sitemap Health & Submissions

Lists submitted sitemaps, inspects XML parse errors, and submits fresh sitemap endpoints programmatically.

4. 🔒 Enterprise Privacy

Uses standard Google Cloud Service Account JSON credentials or OAuth2 tokens stored strictly on your local machine.


03 / Configuration

Agent Configuration

Claude Code CLI

claude mcp add gsc -- uvx google-search-console-mcp

Cursor & Google Antigravity (mcp.json)

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/path/to/service-account.json"
      }
    }
  }
}

04 / Tools

Tool & Parameter Reference

Tool Name Parameters Description Return Type
get_search_analytics site_url, start_date, end_date, dimensions Fetches clicks, impressions, CTR, and average position across query/page/device. JSON
inspect_url site_url, inspection_url Checks index status, crawl issues, and canonical URL compliance. JSON
list_sites (none) Lists all verified web properties in the connected GSC account. JSON
list_sitemaps site_url Retrieves all submitted sitemaps and their last crawl timestamp. JSON
submit_sitemap site_url, feedpath Submits a fresh XML sitemap endpoint to Googlebot. JSON