SEO Agency & Freelancer Starter

Claude Code — SEO Agency & Freelancer Starter

A batteries-included Claude Code blueprint for SEO freelancers and agencies. Wire up the Visibly AI MCP, get ready-made slash commands for the full client workflow — Status-Quo → Potential Analysis → Offer → CI-compliant PDF — and a smart hook that nudges Claude toward real SEO data instead of guessing.

Built and battle-tested by Antonio Blago — SEO Freelancer & creator of the Neuro-SEO System®.

Quickstart • What's inside • Workflows • CTR Model • Customise • Get a free key • Book a call

---

Why this exists

SEO consulting is the same five jobs over and over: pull the real ranking data, map it against the client's keyword set, quantify the opportunity, turn that into an offer, and ship a presentable PDF. Claude Code can do all of it — if you give it the data sources, the methodology, and the guardrails.

This repo packages exactly that — and it runs without any API key. Install it and the bundled .mcp.json connects to the Visibly AI MCP keyless, giving you 8 free tools (keyword classification, SEO checklists, URL-structure analysis) plus the full local methodology; bring your own Search Console export and the entire Status-Quo → Potential → Offer → PDF chain runs offline. Add a Visibly AI key when you want the data engine on tap — live GSC/GA at 0 credits, keywords, backlinks, competitors and on-page audits through one MCP. Free by default, pro when you need it.

✨ What's inside

Piece	What it does
.mcp.json	Pre-wired Visibly AI MCP connection — keyless by default (8 free tools); add a key to unlock live GSC, keywords, backlinks, competitors, on-page audits, crawling.
/visibly-seo-status-quo	Maps a client's live organic visibility: GSC × target keywords, classification, quick wins.
/visibly-seo-potential	Potential analysis: empirical CTR model → realistic 12-month targets → traffic, lead & ROI math.
/visibly-seo-offer	Drafts a tailored, phased SEO consulting offer from your analysis + client context.
/visibly-seo-pdf-build	Turns any analysis script into a clean, brand-compliant PDF.
SEO hook	A UserPromptSubmit hook that detects SEO intent and steers Claude to Visibly AI MCP tools instead of generic scraping.
CLAUDE.md	A project-instruction template encoding the whole workflow + folder conventions.
docs/	The methodology written out: workflows, the CTR model, and best practices.

🚀 Quickstart

There are two ways to use this — pick one.

Option A — Install as a plugin (fastest)

/plugin marketplace add AntonioBlago/claude-code-seo-starter
/plugin install seo-starter@antonioblago

You get the /visibly-seo-status-quo, /visibly-seo-potential, /visibly-seo-offer, /visibly-seo-pdf-build commands, the auto-invoked SEO skills, the SEO-intent hook, and the keyless Visibly AI MCP — wired in. No key needed to start — approve the MCP server and you have the 8 free tools plus the full local workflow.

Want the full data engine (live GSC, keywords, backlinks, on-page)? Add a Visibly AI key — grab one at visibly-ai.com (~30s, no card), then connect it once (resolves at write time, stays out of git):

claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_xxxxxxxxxxxxxxxx"

Restart with /reload-plugins if needed. See docs/setup.md for the pro tier, Google-OAuth (0 credits) and optional DataForSEO wiring.

Option B — Clone the template

Use the full repo (docs, PDF template, setup script) as a project scaffold.

1. Prerequisites

• Claude Code installed (npm install -g @anthropic-ai/claude-code)
• (Optional) a Visibly AI account for the pro tier — sign up free. Not required: the starter runs keyless.
• Python 3.11+ (only needed for the PDF / data-crunching helpers)

2. Get the blueprint

# Use it as a GitHub template, or just clone:
git clone https://github.com/AntonioBlago/claude-code-seo-starter.git
cd claude-code-seo-starter

3. (Optional) add your Visibly AI key

Skip this for the free tier — the keyless .mcp.json already works. To unlock the full data engine, create a free account at visibly-ai.com, copy your lc_... key, and connect it once (resolves at write time, stays out of git):