# Google Search Console for AI agents

Connect Google Search Console once on clickd with read-only OAuth, and your AI agent can query your site’s real search impressions, clicks, positions, click-through rates and period-over-period traffic shifts directly inside Claude Code, Codex or Cursor.

- Install skills: `npx skills add subinternal/clickd`
- Ask your agent: "Pull clickd_queries and clickd_traffic for example.com, find our top 5 striking-distance pages in positions 4 to 20, and sharpen them in code."
- MCP tools used: `clickd_queries`, `clickd_traffic`, `clickd_brief`, `clickd_rescan`

## What breaks most often on Search Console

- **Guessed third-party search volume** (`question-headings`): Keyword databases often report zero volume on the exact B2B and technical queries already sending your site impressions in Search Console.
- **Striking-distance pages left on page two** (`title`): Pages ranking in positions 4 to 20 already have Google’s trust for the topic and move fastest when titles, headings and internal links are tightened.
- **Silent click decay on older guides** (`dated`): High-performing guides lose clicks over 60 to 90 days as competitors publish fresher answers or search snippets truncate.

## The Search Console agentic SEO loop

1. **Claim & connect** (`Account -> Search Console`): Verify your domain on clickd and grant read-only Google Search Console access in one OAuth step.
2. **Mine real queries** (`clickd_queries`): Your agent calls clickd_queries and clickd_traffic over MCP to group queries by URL, position and CTR.
3. **Fix in your repo** (`keyword-research`): Your agent updates titles, opening 40 to 60 word answers, schema and internal links on the target routes.
4. **Verify after deploy** (`clickd_rescan`): After you ship, clickd_rescan checks the live HTML and subsequent Search Console reads track position gains.

## Worked pattern (Sample MCP tool call and agent plan)

Your agent reads Search Console rows directly over MCP without exporting CSVs.

```
// 1. Agent queries Search Console through clickd MCP
clickd_queries({ site: "example.com" })
// -> /services/roof-repair: 4,820 impressions, pos 6.4, CTR 1.8%
// -> /guides/hail-damage:   3,190 impressions, pos 11.2, CTR 0.9%

// 2. Agent checks period-over-period click changes
clickd_traffic({ site: "example.com" })
// -> Flags pages slipping in clicks so content-refresh updates them first
```

## Prompts to run on Search Console

- **Find striking-distance keywords**: "Pull clickd_queries for example.com, list queries in positions 4 to 15 with the most impressions, and improve the matching pages in our repo."
- **Fix low-CTR page-one titles**: "Find pages on example.com ranking in positions 1 to 5 with below-average CTR in clickd_queries and rewrite their title tags and meta descriptions."
- **Recover slipping traffic**: "Use clickd_traffic on example.com to find the 3 pages that lost the most clicks over the last 60 days and refresh them with content-refresh."

## Paired skills

- [Keyword research](https://clickd.com/skills/keyword-research): Finds striking-distance keywords (positions 4 to 20), CTR gaps, cannibalized queries and competitor topic gaps using Google Search Console data and clickd, then maps each query to one page and one action.
- [Content refresh](https://clickd.com/skills/content-refresh): Finds pages losing Search Console clicks or carrying stale facts, diagnoses whether the drop is snippet decay, a substance gap or internal overlap, updates the page in code, and checks live with clickd.
- [Rank a page](https://clickd.com/skills/rank-a-page): Runs a campaign to move one page up for one search toward an aim, through five gates in order, each opened only by a proof from a read of the live site, with a weekly read-out and the campaign’s time to rank.
- [On-page SEO](https://clickd.com/skills/on-page-seo): Rewrites title tags, meta descriptions, single H1s, question headings, answer-first openings, image alt text and AI writing tells in your site’s templates and content files, checked live with clickd.

## Questions

### Can clickd or my AI agent change settings inside Google Search Console?

No. clickd requests read-only Search Console access to read impressions, clicks, positions and URLs for sites you claim. Neither clickd nor your agent can remove URLs, change sitemaps or alter ownership in Search Console.

### Do I have to export CSV files from Search Console for my agent?

No. Once Search Console is connected to your claimed site on clickd, any agent connected to `https://clickd.com/mcp` queries fresh data directly with `clickd_queries` and `clickd_traffic`.

### What if my site is brand new and has no Search Console history yet?

Start without Search Console: `clickd_brief`, `clickd_rivals` and `clickd_gaps` work on any public domain from day one using live crawls and competitor benchmarks.