---
description: Google Search Console data retrieval (rankings, CTR, impressions, sitemaps)
---

# SEO Search Console

GSC API client for search analytics, sitemap status, and index coverage.

## Triggers
- "Search Console", "rankings"
- "GSC data", "search performance"

## Quick Start

```bash
python scripts/gsc_client.py --site sc-domain:example.com --action summary
python scripts/gsc_client.py --site sc-domain:example.com --action queries --limit 100
python scripts/gsc_client.py --site sc-domain:example.com --action pages
```

## Configuration

- Credentials: `~/.credential/ourdigital-seo-agent.json`
- Service account: `ourdigital-seo-agent@ourdigital-insights.iam.gserviceaccount.com`

## Actions

| Action | Description |
|--------|-------------|
| `summary` | Clicks, impressions, CTR, position overview |
| `queries` | Top search queries |
| `pages` | Top pages by clicks |
| `sitemaps` | Sitemap submission status |
| `coverage` | Index coverage issues |

## Site Property Formats
- Domain: `sc-domain:example.com`
- URL prefix: `https://www.example.com/`

## Notion Output
- Database: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
- Korean report, Audit ID: [TYPE]-YYYYMMDD-NNN
