Google Search Console
Analyze search performance, track keyword rankings, monitor click-through rates, and audit index coverage.
Overview
The Google Search Console integration connects your Search Console properties to Claude Code through Presso, giving you instant access to search performance data, keyword rankings, click-through rates, and index coverage — all through natural language queries.
Instead of navigating the Search Console UI and manually building reports, ask Claude Code questions like "Which pages lost the most impressions this month?" and get actionable answers in seconds.
Setup
Prerequisites
- A Google account with access to at least one verified Search Console property
- A Presso account with an active subscription
- Claude Code installed and configured with the Presso MCP server
Connect Google Search Console
- Open the Presso dashboard.
- Click Add Connection and select Google Search Console.
- Sign in with your Google account and grant Presso read-only access to your Search Console data.
- Select the property (or properties) you want to connect.
- Once authorized, the connection appears on your dashboard with a green Connected status.
Note: Presso requests read-only access. It cannot modify your Search Console settings, sitemaps, or property configurations.
Available tools
The Search Console integration provides the following tools:
| Tool | Description |
|---|---|
search_console_query | Query search performance data with filters for date range, dimensions, and search type |
search_console_list_sites | List all verified Search Console properties in your account |
search_console_get_sitemaps | Retrieve sitemap information and submission status for a property |
Key metrics
Search Console tracks four core metrics for every query, page, and dimension combination:
| Metric | Description |
|---|---|
| Clicks | Number of times a user clicked through to your site from search results |
| Impressions | Number of times your site appeared in search results (even if not clicked) |
| CTR | Click-through rate — clicks divided by impressions, expressed as a percentage |
| Average Position | Mean ranking position in search results for the given query or page |
Dimensions
You can break down performance data by any combination of these dimensions:
| Dimension | Description | Example values |
|---|---|---|
| Query | The search term the user typed | "blue running shoes", "presso mcp" |
| Page | The URL that appeared in search results | "https://example.com/products/shoes" |
| Country | Country of the searcher (ISO 3166-1 alpha-3) | USA, GBR, JPN |
| Device | Device type used for the search | DESKTOP, MOBILE, TABLET |
| Search Appearance | Special result type, if applicable | RICH_RESULT, AMP_BLUE_LINK |
| Date | Individual date for trend analysis | 2026-02-01 |
Date range queries
Search Console data is available with a 2-3 day delay from Google. When querying, you can specify date ranges in natural language:
Show my search performance for the last 28 days.
Compare this month's search traffic to last month.
What were my top queries in January 2026?
Claude Code translates your natural language date references into the correct API date parameters automatically.
Tip: Google Search Console retains up to 16 months of data. For longer-term trend analysis, specify the full date range you need.
Example queries
Keyword performance
Show me my top 20 search queries by clicks this month.
Which queries have the highest impressions but lowest CTR?
What's our click-through rate for branded queries containing our company name?
Page performance
Which landing pages get the most organic search traffic?
Show me pages with declining impressions over the past 3 months.
What's the average position for our blog posts vs. product pages?
Device analysis
Compare mobile vs. desktop search performance for the last 30 days.
Which queries perform better on mobile than desktop?
Show me CTR by device type for our top 10 pages.
Country and region analysis
What are our top search queries in the United States vs. the United Kingdom?
Which countries drive the most organic clicks to our site?
Show impressions by country for our product pages.
Trend analysis
How has our average position changed for "blue running shoes" over the past 6 months?
Show me weekly click trends for our top 5 queries.
Are there any queries where our ranking has dropped significantly this month?
Performance analysis patterns
Identifying quick wins
Find queries where you rank on page 2 (positions 11-20) with high impressions — these are prime candidates for optimization:
Show me queries with average position between 11 and 20 that have more than 500 impressions this month.
CTR optimization
Identify pages with strong rankings but below-average CTR, suggesting title or meta description improvements:
Which of our top 50 pages by impressions have a CTR below 2%?
Content gap analysis
Discover what users are searching for when they find your site:
Show me all queries that drove traffic to our homepage — are there topics we should create dedicated landing pages for?
Sitemap monitoring
Use the sitemap tools to check submission status and coverage:
Show me all sitemaps submitted for our site and their status.
How many URLs are in each of our sitemaps?
Are there any sitemap errors or warnings?
Index coverage insights
While Search Console's index coverage data is primarily available through the UI, you can use query-level data to infer indexing patterns:
List all pages that received at least 1 impression in the last 3 months — these are confirmed indexed pages.
Compare the number of pages receiving impressions this month vs. last month. Are we gaining or losing indexed pages?
Tips and best practices
- Start broad, then narrow down. Begin with a high-level overview ("Show my search performance summary for the last 28 days") before diving into specific queries or pages.
- Combine dimensions for deeper insights. Ask for breakdowns like "Show me mobile CTR by country for our top queries" to surface patterns that single-dimension reports miss.
- Use comparison timeframes. Asking "Compare this month vs. last month" is more actionable than looking at a single period in isolation.
- Watch for seasonality. When analyzing trends, compare year-over-year when possible to avoid confusing seasonal patterns with real performance changes.
- Cross-reference with GA4. Combine Search Console data with Google Analytics 4 to see the full picture — from search query to on-site behavior and conversion.
Limitations
- Search Console data has a 2-3 day processing delay from Google.
- Historical data is available for up to 16 months.
- Anonymous queries (where Google groups low-volume searches) are not individually reported.
- Impression and click data is sampled for very high-traffic properties.
Next steps
- Google Analytics 4 Integration — Combine organic search data with on-site analytics for end-to-end visibility.
- Google Ads Integration — Compare paid vs. organic search performance side by side.
- Basic Usage — Learn best practices for querying your data effectively.