# Google Search Console tools

Source: https://adsuperpowers.ai/docs/tools/google-search-console

Monitor and optimize your organic search presence with keyword rankings, URL indexing, and sitemap management.

## Before you begin

Connect the relevant Google Search Console account through [Accounts](https://adsuperpowers.ai/docs/accounts), then connect your [AI assistant](https://adsuperpowers.ai/docs/setup). Confirm the target account and date range before querying data or making changes.

This is the generated catalog. The tools shown in your AI assistant depend on your connected accounts, active workspace, role, write permissions, enabled features and the client's supported tool surface. A listed tool is not a promise that it is enabled in every workspace. See [accounts](https://adsuperpowers.ai/docs/accounts), [workspace access](https://adsuperpowers.ai/docs/workspaces) and [troubleshooting](https://adsuperpowers.ai/docs/troubleshooting).

## Available tools

3 tools.

| Tool | Access | Purpose |
| --- | --- | --- |
| `gsc_list_sites` | Read | List all verified sites and optionally their sitemaps |
| `gsc_search_analytics` | Read | Get search performance data: queries, pages, CTR, position, with flexible filtering |
| `gsc_manage_url` | Write | Inspect URL indexing, submit sitemaps, or delete sitemaps |

Write tools can change account settings, campaigns or workspace content. Confirm the target and proposed changes before running them.

## Example questions

> Show me my verified Search Console sites

> What are my top organic search queries this month?

> Which pages get the most organic clicks?

> Check if my homepage is properly indexed

> Show me queries where I rank on page 2 (positions 11-20)

> What's my average CTR for branded vs non-branded queries?

[More example questions](https://adsuperpowers.ai/docs/examples).

## API capabilities

Available fields and combinations depend on the resource, account and campaign type. Adapt the examples to your selected account.

### Metrics

| Category | Fields |
| --- | --- |
| Search Performance | `clicks`, `impressions`, `ctr`, `position` |

### Dimensions

| Category | Fields |
| --- | --- |
| Search | `query`, `page`, `country`, `device`, `searchAppearance`, `date` |

### Query examples

#### Top Queries by Clicks

Find your highest-traffic search queries

Tool: `gsc_search_analytics`.

```json
{
  "site_url": "https://example.com",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "dimensions": ["query"],
  "row_limit": 25
}
```

#### Page Performance Analysis

See which pages get the most organic traffic

Tool: `gsc_search_analytics`.

```json
{
  "site_url": "https://example.com",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "dimensions": ["page"],
  "row_limit": 50
}
```

#### URL Indexing Check

Check if a specific URL is indexed and crawlable

Tool: `gsc_manage_url`.

```json
{
  "site_url": "https://example.com",
  "inspection_url": "https://example.com/important-page"
}
```

## Technical reference

API endpoint: `googleapis.com/webmasters/v3`. Status: stable.

Sites/Analytics/Sitemaps use v3, URL Inspection uses v1 (searchconsole.googleapis.com/v1).

### Rate limits

| Limit | Scope | Notes |
| --- | --- | --- |
| 2,000 requests/day | URL Inspection API per site | Use sparingly, designed for spot-checking, not bulk scanning |
| 25,000 rows | Search Analytics maximum per query | Paginate with rowLimit + startRow for larger datasets |

### Limitations and notes

- Data has a 2-3 day delay (not real-time)
- URL Inspection: 2,000 requests/day per site, use for spot-checking, not bulk
- Search Analytics limited to 16 months of historical data
- Position is an average, actual ranking varies by user, location, device
- data_state='final' excludes the most recent (incomplete) days

## Other platforms and tools

- [Meta Ads](https://adsuperpowers.ai/docs/tools/meta-ads)
- [Google Ads](https://adsuperpowers.ai/docs/tools/google-ads)
- [Google Analytics](https://adsuperpowers.ai/docs/tools/google-analytics)
- [Google Tag Manager](https://adsuperpowers.ai/docs/tools/google-tag-manager)
- [Google Merchant Center](https://adsuperpowers.ai/docs/tools/google-merchant-center)
- [LinkedIn Ads](https://adsuperpowers.ai/docs/tools/linkedin-ads)
- [TikTok Ads](https://adsuperpowers.ai/docs/tools/tiktok-ads)
- [Workflows](https://adsuperpowers.ai/docs/tools/workflows)
- [Skills](https://adsuperpowers.ai/docs/tools/skills)
- [Clients](https://adsuperpowers.ai/docs/tools/clients)

[All tools](https://adsuperpowers.ai/docs/tools) · [Quickstart](https://adsuperpowers.ai/docs/quickstart)