| name | google-search-console |
| description | Query Google Search Console data — check indexing status, view search performance (keywords, clicks, impressions, CTR, position), list sitemaps and properties. Use when user asks about page indexing, search analytics, Google rankings, search traffic, or wants to check which pages are indexed. |
| allowed-tools | Bash, Read |
Google Search Console
Query Search Console data: indexing status, search performance, sitemaps, and properties.
When to Use
- User wants to check if a URL is indexed by Google
- User asks about search performance, rankings, or traffic
- User wants to see top keywords/queries for a site
- User asks about clicks, impressions, CTR, or position data
- User wants to list sitemaps or Search Console properties
- User mentions Google Search Console, search analytics, or crawl status
Requirements
GOOGLE_INDEXING_KEY_FILE - Path to Google Cloud service account JSON key file (same as google-indexing skill)- Service account must have read access in Google Search Console
- Search Console API enabled in Google Cloud Console
Commands
Inspect URL Indexing Status
./scripts/google_search_console inspect "https://example.com/page" --site sc-domain:example.com
./scripts/google_search_console inspect --file urls.txt --site sc-domain:example.com
Search Performance (Analytics)
./scripts/google_search_console performance --site sc-domain:example.com
./scripts/google_search_console performance --site sc-domain:example.com --dimension page
./scripts/google_search_console performance --site sc-domain:example.com --query "seo"
./scripts/google_search_console performance --site sc-domain:example.com --start-date 2024-01-01 --end-date 2024-01-31
./scripts/google_search_console performance --site sc-domain:example.com -n 20 -f table
List Sitemaps
./scripts/google_search_console sitemaps --site sc-domain:example.com
List Properties
./scripts/google_search_console sites
Options
| Option | Description |
|---|
-k, --key-file | Service account JSON key path (overrides env) |
-f, --format | Output format: json (default) or table |
-s, --site | Search Console property (e.g. sc-domain:example.com) |
--file | File with URLs, one per line (inspect only) |
-d, --dimension | Dimension: query, page, country, device, date |
--days | Days back from today (default: 28) |
--start-date | Start date YYYY-MM-DD (overrides --days) |
--end-date | End date YYYY-MM-DD |
-q, --query | Filter by search query (contains) |
-p, --page | Filter by page URL (contains) |
-n, --limit | Max rows (default: 1000, max: 25000) |
Output Format
inspect
{
"site": "sc-domain:example.com",
"results": [
{
"url": "https://example.com/page",
"verdict": "PASS",
"coverage_state": "Submitted and indexed",
"last_crawl_time": "2024-01-15T10:30:00Z",
"page_fetch_state": "SUCCESSFUL",
"robots_txt_state": "ALLOWED",
"indexing_state": "INDEXING_ALLOWED",
"google_canonical": "https://example.com/page",
"user_canonical": "https://example.com/page",
"crawled_as": "MOBILE",
"referring_urls": [],
"sitemaps"
performance
{
"site": "sc-domain:example.com",
"start_date": "2024-01-01",
"end_date": "2024-01-28",
"dimension": "query",
"rows": [
{
"keys": ["example keyword"],
"clicks": 150,
"impressions": 3200,
"ctr": 0.047,
"position": 8.3
}
]
}
sites
{
"sites": [
{
"site_url": "sc-domain:example.com",
"permission_level": "siteOwner"
}
]
}
API Quotas
| Quota | Limit |
|---|
| URL Inspection | 2,000/day per property, 600/min |
| Search Analytics | 1,200 queries/min |
| Sitemaps/Sites | Standard quota |
Examples
Check if a page is indexed:
./scripts/google_search_console inspect "https://example.com/page" --site sc-domain:example.com
Top 10 queries with table output:
./scripts/google_search_console performance --site sc-domain:example.com -n 10 -f table
List all verified properties:
./scripts/google_search_console sites -f table
