auto-index

# Auto-Index — Google Indexing API

Submit URLs to Google for fast indexing via the [Google Indexing API](https://developers.google.com/search/apis/indexing-api/v3/quickstart).

## Prerequisites

1. **Google Cloud Project** with the Indexing API enabled
2. **Service Account** with a downloaded JSON key file
3. **Google Search Console** — add the service account email as an **Owner** of the property

## Environment

| Variable | Required | Description |
|----------|----------|-------------|
| `GOOGLE_INDEX_SA_KEY` | Yes (or `--sa-key`) | Absolute path to service account JSON key file |

## How to Invoke

Run using `uv run` with the script's absolute path. The script directory is relative to the skill root.

### auto-index — Sitemap diff

Fetches a sitemap, compares against a local cache, and submits only **new** URLs.

```bash
uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml"
```

Force re-index all URLs (ignore cache):
```bash
uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml" --force
```

### index-now — Submit URL(s) immediately

```bash
uv run scripts/google_index.py index-now --url "https://example.com/new-page"
```

Multiple URLs:
```bash
uv run scripts/google_index.py index-now -u "https://example.com/page1" -u "https://example.com/page2"
```

Notify URL deletion:
```bash
uv run scripts/google_index.py index-now --url "https://example.com/old-page" --delete
```

## CLI Reference

### auto-index

| Flag | Description |
|------|-------------|
| `--sitemap`, `-s` | **(required)** Sitemap URL to fetch |
| `--sa-key`, `-k` | Path to service account JSON key (overrides env) |
| `--force`, `-f` | Re-index all URLs, ignoring cache |

### index-now

| Flag | Description |
|------|-------------|
| `--url`, `-u` | **(required)** URL to submit — repeatable for multiple URLs |
| `--sa-key`, `-k` | Path to service account JSON key (overrides env) |
| `--delete`, `-d` | Notify deletion instead of update |...