Google Search Console

Name: Google Search Console
Availability: InStock
Author: Thrivemattic

Free Verified 512 lines By Thrivemattic SEO

Description

Connect to Google Search Console via OAuth2 to inspect URLs, fetch search analytics, manage sitemaps, diagnose indexing and crawl errors, and bulk-export performance data. This skill gives Claude Code direct access to the GSC API — no browser required.

Covers the full GSC workflow: OAuth setup with automatic token caching, search analytics queries with filtering and pagination, URL inspection for indexing status, sitemap management, and batch API requests. Includes rate limit awareness, query cost optimization, and bulk data export strategies.

Key Capabilities

OAuth2 Authentication — Browser-based consent flow with automatic token caching and refresh
Search Analytics — Query clicks, impressions, CTR, and position by page, query, country, device, or date
URL Inspection — Check indexing status, crawl info, mobile usability, and rich results for any URL
Sitemap Management — List, submit, and delete sitemaps programmatically
Bulk Data Export — Paginate through all available rows with day-by-day export strategy
Batch Requests — Combine up to 1,000 API calls into a single HTTP request
Filtering & Cross-tabulation — Filter by country, device, search appearance; cross-tab query × page
Performance Optimization — Partial responses, gzip compression, query cost awareness

Use Cases

Monitor indexing status across your site and fix coverage issues
Analyze search performance trends and identify content opportunities
Diagnose crawl errors, soft 404s, and robots.txt blocks
Export search data for reporting and analysis pipelines
Verify sitemap health and submit new sitemaps after content changes
Check data freshness before pulling analytics reports

What Claude Learns

→ • OAuth2 setup with Google Cloud credentials and automatic token management
→ • Search analytics queries with filtering by country, device, and search appearance
→ • URL inspection for indexing status, crawl errors, and mobile usability
→ • Sitemap listing, submission, and deletion via the API
→ • Pagination for datasets exceeding 25,000 rows
→ • Bulk data export strategy — one day at a time to stay within quotas
→ • Batch requests to combine up to 1,000 API calls
→ • Rate limits and query cost awareness for different dimension combinations
→ • Common coverage states and how to diagnose indexing issues
→ • Performance optimization with partial responses and gzip compression

Installation

1. Add this skill to your Claude Code configuration:
   ```
   claude mcp add-skill gsc-setup
   ```
   Or install via CLI:
   ```
   npx mkt-skills install gsc-setup
   ```

2. Set up a Google Cloud project with Search Console API enabled

3. Create an OAuth 2.0 Client ID (Desktop app type) in APIs & Services > Credentials

4. Add credentials to your `.env` file:
   ```
   GOOGLE_CLIENT_ID=.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=GOCSPX-
   ```

5. Install Python dependencies:
   ```bash
   pip3 install google-api-python-client google-auth-oauthlib google-auth-httplib2 python-dotenv
   ```

6. On first use, a browser window will open for OAuth consent. The token is cached locally for subsequent runs.