# Claude SEO: do SEO inside Claude Code

A free mini-course on two tools that work together: claude-seo, a plugin that runs on your machine, and seodraft, an MCP server that keeps the plan. You run every command yourself.

> This course is independent. It has no affiliation with Anthropic or with AgriciDaniel, who writes claude-seo, and nobody on their side reviewed it.

Written against claude-seo v2.4.1 (README, 2026-10-01). Free · no sign-up. 13 lessons, 13 published.

URL: https://seodraft.app/learn/claude-seo
Skill: https://seodraft.app/learn/claude-seo/SKILL.md

## The course in one paragraph

Doing SEO with Claude means running the work inside Claude Code where you already write. Two pieces cover it. claude-seo is a plugin you install into Claude Code: 26 sub-skills and 19 sub-agents across technical SEO, E-E-A-T, schema, GEO and AI search, local, e-commerce and international work. It runs on your machine, needs Python 3.10 or higher, and works with zero API keys. seodraft is a remote MCP server you connect over OAuth. It keeps the profile, the evidence bank, the topic bank, the editorial calendar and the deterministic rules that decide when a draft is done, and it never calls a model. The writing stays inside your Claude subscription, so a full audit spends more of it than a single question. You approve every article, and delivery puts a draft file in your own repository for you to publish.

## What you will be able to do

- Say what a skill, a plugin and an MCP server each are, and which of them runs on your machine.
- Install claude-seo into Claude Code and confirm the install with `/seo doctor`.
- Audit your own site from the terminal and decide which findings are worth the afternoon.
- Plan topics, keep your own evidence, and deliver an approved draft to your repository.
- Tell what your Claude subscription pays for and what your DataForSEO balance pays for.

## What runs where

### Your machine

claude-seo runs inside Claude Code as a plugin: 26 sub-skills and 19 sub-agents. `/seo setup` creates an isolated Python environment and installs Playwright Chromium, and `/seo doctor` checks it. Every sub-agent it starts is a call on your Claude account.

### seodraft's server

A remote MCP server at https://seodraft.app/mcp, reached over OAuth. It keeps the profile, the evidence bank, the topics, the calendar and the rules, so the plan survives a closed terminal. Keyword data comes from your own DataForSEO account, with the cost shown before each paid call.

### Your Claude subscription

Every word is written there, in your own session. Both tools read, check and decide. Five of claude-seo's judgment-heavy agents run on Opus and the rest on Sonnet, which is why a full `/seo audit` spends more of the subscription than a question does.

## Who it is for

Founders and developers who already pay for Claude and keep their site somewhere they can edit it. The course assumes you are comfortable in a terminal and have no SEO background at all.

## What you need

- Claude Code, signed in to a Claude subscription.
- Python 3.10 or higher on your machine. The claude-seo project recommends 3.11 or higher.
- A site you can edit, ideally a blog that lives in a git repository.
- No API keys. Google APIs and paid MCP extensions such as DataForSEO or Ahrefs are optional.

## Syllabus

### Module 1 · Preparation

1. [What you are installing](https://seodraft.app/learn/claude-seo/what-you-are-installing) — A skill, a plugin and an MCP server are three different things. Which of them runs on your machine, and which one spends your Claude subscription. Markdown: https://seodraft.app/learn/claude-seo/what-you-are-installing.md
2. [Install claude-seo and seodraft](https://seodraft.app/learn/claude-seo/install-claude-seo-and-seodraft) — Install the Claude SEO plugin from its marketplace or load a clone for one session, build its runtime, and sign in to the seodraft MCP server. Markdown: https://seodraft.app/learn/claude-seo/install-claude-seo-and-seodraft.md

### Module 2 · Diagnosis

3. [Run an SEO audit with Claude](https://seodraft.app/learn/claude-seo/seo-audit-with-claude) — A Claude SEO audit runs eleven sub-agents over your site and returns a scored report. What it checks, how to read the verification section, and which finding to do first. Markdown: https://seodraft.app/learn/claude-seo/seo-audit-with-claude.md
4. [AI crawlers and agent readiness](https://seodraft.app/learn/claude-seo/ai-crawlers-and-agent-readiness) — Which AI crawlers your robots.txt lets in, what blocking each kind costs, and what claude-seo's agentic and geo agents find when they read your site. Markdown: https://seodraft.app/learn/claude-seo/ai-crawlers-and-agent-readiness.md

### Module 3 · Planning

5. [Keyword research with Claude](https://seodraft.app/learn/claude-seo/keyword-research-with-claude) — What claude-seo can answer about a term without a data provider, what measuring adds, and how to label an estimate so nobody plans a quarter on one. Markdown: https://seodraft.app/learn/claude-seo/keyword-research-with-claude.md
6. [Topic clusters and cannibalization](https://seodraft.app/learn/claude-seo/topic-clusters-and-cannibalization) — How claude-seo groups keywords by SERP overlap, how seodraft withholds a term for resembling another, and what to do when the two answers disagree. Markdown: https://seodraft.app/learn/claude-seo/topic-clusters-and-cannibalization.md
7. [Build a content brief with Claude](https://seodraft.app/learn/claude-seo/content-brief-with-claude) — What a brief has to contain, what claude-seo returns from today's SERP, and how seodraft checks the finished article against the plan it promised. Markdown: https://seodraft.app/learn/claude-seo/content-brief-with-claude.md

### Module 4 · Writing

8. [E-E-A-T and your own evidence](https://seodraft.app/learn/claude-seo/eeat-evidence) — Collect the measured numbers, named cases and mistakes only you have, and make every article cite at least three of them. Markdown: https://seodraft.app/learn/claude-seo/eeat-evidence.md
9. [Write without AI slop](https://seodraft.app/learn/claude-seo/write-without-ai-slop) — The tics a reader recognises on sight, the rules that catch them, and how a draft gets rewritten until it passes. Markdown: https://seodraft.app/learn/claude-seo/write-without-ai-slop.md
10. [Internal links and the calendar](https://seodraft.app/learn/claude-seo/internal-links-and-calendar) — Link a new article into the ones you already published, and put the next four weeks on a calendar you can keep. Markdown: https://seodraft.app/learn/claude-seo/internal-links-and-calendar.md

### Module 5 · Publish and measure

11. [Schema and publishing](https://seodraft.app/learn/claude-seo/schema-and-publishing) — The structured data a page earns, the dates every surface has to agree on, and what delivery to your repository does before a human publishes. Markdown: https://seodraft.app/learn/claude-seo/schema-and-publishing.md
12. [AI search and GEO](https://seodraft.app/learn/claude-seo/ai-search-geo) — What makes a passage quotable by an answer engine, what claude-seo's geo command scores, and which half of that report is an estimate. Markdown: https://seodraft.app/learn/claude-seo/ai-search-geo.md
13. [Measure and maintain](https://seodraft.app/learn/claude-seo/measure-and-maintain) — Capture a baseline you can compare against, read what a crawl cannot see, and keep the promise a published article made to its reader. Markdown: https://seodraft.app/learn/claude-seo/measure-and-maintain.md

## Versions this was written against

- claude-seo v2.4.1 (README, read on 2026-10-01) — https://github.com/AgriciDaniel/claude-seo
- seodraft MCP (https://seodraft.app/mcp, read on 2026-10-01) — https://seodraft.app

## How this was made

Each lesson was written against the versions listed above, read from the projects' own documentation on the dates given. A lesson whose evidence comes from a real run says so at the top, with the version it ran and the day it ran. The course publishes no number from a run that did not happen, and a new version of claude-seo opens a review of the lessons it touches.

## Questions

### Is this course official?

No. It is independent, with no affiliation to Anthropic or to AgriciDaniel, who writes claude-seo. seodraft wrote it because the two tools are used together here, and the claude-seo project is MIT-licensed and public at github.com/AgriciDaniel/claude-seo.

### What does the course cost?

Nothing. The course needs no account, and it asks for neither a card nor an email address. The tools have their own terms: claude-seo is MIT-licensed and free, Claude Code needs your Claude subscription, and seodraft runs a 7-day trial with no card before its one paid plan.

### Is the whole course published?

Yes. The 13 lessons are live in English and Spanish, written against claude-seo v2.4.1 and checked on 2026-10-03. A lesson built on a real run of the tools carries its own version and date, and a lesson without that line claims no run. A new version of claude-seo opens a review of the lessons it touches, so a command that changed gets corrected instead of left standing.

### Does my progress leave the browser?

No. Ticks and completed lessons live in this browser's localStorage under one key for the course. There is no account behind the course and nothing about your progress reaches a server. Clearing site data resets it, and the pages work without it.

MCP: https://seodraft.app/mcp