Connecting Google Search Console provides AI SEO Agents with first-party search performance data — keyword positions, impressions, clicks, and index coverage. This data powers rank tracking, content performance analysis, and automated alerting.
OAuth Setup
Navigate to Settings
In the AI SEO Agents dashboard, go to Settings → Integrations.
Click Connect Google Search Console
You'll be redirected to Google's OAuth consent screen. Sign in with the Google account that has access to your Search Console property.
Grant Permissions
The app requests read-only access to your Search Console data. No write permissions are requested — we never modify your Google settings.
Select Properties
After authorization, select which Search Console properties to sync. You can connect multiple properties if you manage several sites.
OAuth tokens are encrypted and stored in AWS Secrets Manager. Tokens are refreshed automatically and can be revoked at any time from Settings → Integrations or from your Google Account permissions.
Data Available
| Data Type | Description | Retention |
|---|---|---|
| Search Queries | Keywords your site appears for, with position, impressions, clicks, CTR | 16 months |
| Page Performance | Per-URL breakdown of search metrics | 16 months |
| Index Coverage | Which pages are indexed, excluded, or have errors | Current snapshot |
| Sitemaps | Submitted sitemaps and their status | Current snapshot |
How Data Is Used
- Rank tracking — Daily position monitoring for your target keywords with trend analysis.
- Content performance — Correlate article publish/update events with ranking changes.
- Keyword discovery — Identify queries your site ranks for that aren't in your agent's keyword list.
- Index monitoring — Alert when important pages drop out of the index or encounter crawl errors.
Troubleshooting
| Issue | Solution |
|---|---|
| No properties appear after auth | Ensure you're signed into the Google account that owns the Search Console property. Verified users and delegated users both work. |
| Data shows "No data available" | Search Console data has a 2–3 day lag. New properties may take up to a week to accumulate data. |
| Token expired error | Tokens refresh automatically. If persistent, disconnect and reconnect from Settings → Integrations. |
| "App not verified" warning | This appears during Google's verification process. Click "Advanced" → "Go to AI SEO Agents" to proceed safely. |
Property Verification Methods
Before you can connect a Google Search Console property to AI SEO Agents, the property must be verified in Search Console. If you have not yet verified your site, Google offers several verification methods. The method you choose depends on your level of access to the site's DNS, hosting, or HTML files.
| Verification Method | How It Works | Best For |
|---|---|---|
| DNS record | Add a TXT record to your domain's DNS configuration | Domain-level properties (covers all subdomains and protocols) |
| HTML file upload | Upload a verification HTML file to your site's root directory | URL-prefix properties where you have FTP/file access |
| HTML meta tag | Add a tag to your homepage's section | URL-prefix properties where you can edit page templates |
| Google Analytics | Use an existing GA tracking code on the site | Sites already running Google Analytics |
| Google Tag Manager | Use an existing GTM container on the site | Sites already using Google Tag Manager |
We recommend DNS verification with a domain-level property for the most comprehensive data. Domain properties capture data for all subdomains (www, blog, shop) and both HTTP and HTTPS protocols, giving you a complete view of your search performance across all site variations.
Performance Reports
Performance reports are the core data set that powers rank tracking in AI SEO Agents. The platform syncs performance data daily and stores it for trend analysis over time. You can access performance data through the dashboard or programmatically via the API.
- Query-level data: Every search query that triggered an impression for your site is captured with its average position, total impressions, total clicks, and click-through rate. This granular data reveals which keywords drive traffic and which have untapped potential (high impressions but low CTR).
- Page-level data: Performance metrics broken down by landing page URL. This shows which pages on your site receive the most search visibility and how well they convert impressions into clicks. Pages with high impressions but low CTR often have metadata issues that the audit agent can identify.
- Device segmentation: Performance data is available segmented by device type (desktop, mobile, tablet). Since Google uses mobile-first indexing, comparing mobile versus desktop performance reveals whether mobile-specific issues are impacting your rankings.
- Country and search type: Filter performance data by country and search type (web, image, video, news). This is especially valuable for international sites or sites that target specific geographic markets.
Index Coverage Analysis
Index coverage reports show which of your site's pages Google has successfully indexed, which pages are excluded, and why. This data is critical for identifying technical SEO issues that prevent your content from appearing in search results. AI SEO Agents monitors index coverage and alerts you when important pages are excluded or encounter errors.
| Coverage Status | What It Means | Action Required |
|---|---|---|
| Valid | Page is indexed and eligible to appear in search results | None — this is the desired state |
| Valid with warnings | Page is indexed but has issues that may affect its visibility | Review warnings (e.g., indexed despite noindex tag, blocked by robots.txt) |
| Excluded | Page is not indexed due to a specific reason | Review the exclusion reason and determine if the page should be indexed |
| Error | Page could not be indexed due to a technical error | Fix the error immediately — server errors, redirect errors, or blocked resources |
Common exclusion reasons include: "Crawled - currently not indexed" (Google found the page but chose not to index it, often due to thin content or duplicate content), "Discovered - currently not indexed" (Google knows the page exists but has not crawled it yet, often a crawl budget issue), and "Excluded by noindex tag" (the page has a noindex meta tag, which may be intentional or accidental). The AI SEO Agents audit pipeline cross-references index coverage data with your sitemap to identify discrepancies.
URL Inspection
The URL Inspection feature lets you check the index status of any specific URL on your site. This is useful for diagnosing why a particular page is not appearing in search results or for verifying that a recently published article has been discovered and indexed by Google. AI SEO Agents uses URL Inspection data to provide per-page indexing status in the dashboard.
- Index status: Whether the URL is indexed, not indexed, or has indexing errors. Includes the last crawl date and the Googlebot type used (smartphone or desktop).
- Crawl details: HTTP response code, page resource load status, and whether the page was fetched from cache or live. Pages that consistently return non-200 status codes are flagged for investigation.
- Detected schema: Structured data types found on the page (Article, FAQ, BreadcrumbList, etc.) with validation status. Invalid schema prevents rich result eligibility.
- Mobile usability: Whether the page passes Google's mobile usability test. Issues like small text, close touch targets, and viewport configuration problems are reported.
Sitemap Management
XML sitemaps help search engines discover and prioritize your pages for crawling. AI SEO Agents monitors your submitted sitemaps and alerts you when issues are detected. Your sitemap should include all pages you want indexed and exclude pages that should not appear in search results (login pages, admin pages, duplicate content).
- 1Sitemap status monitoring: The platform checks whether your submitted sitemaps are accessible, properly formatted, and returning valid XML. Broken or empty sitemaps prevent Google from discovering your content efficiently.
- 2URL count tracking: Monitor how many URLs are in your sitemap versus how many are actually indexed. A large gap between submitted and indexed URLs indicates that many of your pages are being excluded — which may signal content quality or technical issues.
- 3Last read date: Track when Google last read your sitemap. If Google has not read your sitemap recently, it may indicate that your sitemap URL has changed or that your robots.txt is blocking access.
- 4Sitemap errors: Common errors include invalid XML formatting, URLs returning 404 or 500 status codes, and URLs blocked by robots.txt. Each error type has a specific fix documented in the Search Console integration panel.
Search Appearance
Search appearance data shows how your pages are displayed in Google search results and which special result types they qualify for. This data helps you understand whether your structured data, metadata, and content format are generating the rich results that drive higher click-through rates.
- Rich results: Pages that display enhanced search results (FAQ dropdowns, review stars, recipe cards, how-to steps). The platform tracks which of your pages have active rich results and which pages have eligible structured data that is not yet generating rich results.
- AMP status: For sites using Accelerated Mobile Pages, Search Console reports AMP validation status and any errors that prevent AMP pages from being served.
- Web stories: If your site publishes web stories, Search Console tracks their indexing status and search performance separately from standard pages.
- Breadcrumbs: Pages with valid breadcrumb markup display a breadcrumb trail in search results instead of the raw URL, which improves readability and click-through rates. The Elementor builder in AI SEO Agents generates breadcrumb markup automatically when enabled.
Search appearance data is particularly valuable when combined with competitor analysis. If your competitors have rich results for a keyword and you do not, adding the appropriate structured data to your page is one of the highest-impact optimizations you can make. The technical SEO audit automatically identifies pages where structured data is missing or invalid.
Related Documentation
- Rank Tracking — How position data flows into the ranking dashboard.
- Google Analytics — Combine search data with traffic analytics.
- Data Privacy — How Google data is stored and protected.