seo-data

A Claude Skill for direct, authenticated SEO data access — Google Search Console, Google Analytics 4, and Bing Webmaster Tools in one place.

Most "SEO skills" you'll find are prompt instructions that tell Claude how to audit a site. This one connects Claude to your actual data: query stats, traffic, conversions, crawl health. You ask a question, Claude pulls the numbers and answers from the source.

The skill works with whatever subset you've connected. Have only GSC? You get GSC. Have all three? Claude can cross-reference search performance against on-site behavior and Bing visibility in a single answer.

---

Features

• Three providers, one skill -- Google Search Console (OAuth), Google Analytics 4 (OAuth), Bing Webmaster Tools (API key)
• OAuth done right -- loopback flow with refresh tokens, multi-account support, switch properties without reconnecting
• Graceful degradation -- if a provider isn't connected, the skill skips it and tells the user, instead of failing the answer
• Multi-property -- pick which GSC site, GA4 property, or Bing site to query; switch any time
• No telemetry -- tokens and API keys live only in ~/.seo-data/; nothing leaves your machine except calls to the official APIs
• Plain Python -- the skill is a folder of standalone scripts, easy to fork, audit, or extend
• Built-in report library -- top queries, top pages, traffic sources, daily trends, device breakdown, custom dimensions, plus Bing-specific reports (crawl, keyword research)

Quick Start

Prerequisites

• Python 3.10+
• A working Claude Code install (or any agent that supports Claude Skills)
• Read access to at least one of: Google Search Console, Google Analytics 4, Bing Webmaster Tools

Two ways to install

Option A — Let an AI agent do it for you (recommended)

If you have Claude Code, Cursor, Cline, Aider, or any other AI coding agent, this is by far the easiest path. Clone the repo, open the agent inside it, and say:

"Read AGENT.md and set this up for me."

The agent will install dependencies, copy the skill into the right place, walk you through the Google Cloud Console click-by-click, ask you for your Bing API key, and verify everything works. It only stops to ask you for the things only you can do (clicking buttons in your browser, pasting credentials).

See AGENT.md for the full agent runbook.

Option B — Do it yourself

Follow the human walkthrough in docs/SETUP.md. It covers every step explicitly:

1. Install the skill — clone the repo, pip install -r requirements.txt, copy into your Claude skills directory
2. Connect Bing (5 minutes) — get an API key, run one command
3. Connect Google (~10 minutes) — create a Google Cloud project, enable two APIs, configure an OAuth consent screen, download an OAuth client JSON, run the connect script, consent in the browser
4. Pick which property to use — GSC site, GA4 property, Bing site
5. Verify in Claude — ask a real SEO question and watch it work

Both paths land you at the same place: a seo-data skill installed, all your providers connected, and Claude ready to query your real data.

Ask Claude

Once connected, the skill triggers automatically on SEO/analytics questions: