What is the SEO Skill for Claude Code?
The SEOAgent Skill turns Claude Code into an SEO engine for your codebase. Once installed, you can ask Claude Code to audit your site, fix technical issues, research keywords, and write landing pages and blog articles — and it does the work as real files in your repo. It is a checker and a fixer in one: every finding comes with evidence from the live page and the exact edit, and nothing publishes on its own. Every change comes back to you as a normal diff to approve. It is the opposite of an auto-blogging tool — it is SEO that lives where you already work.
How to use SEOAgent in Claude Code
Install the Skill globally
Run `npm install -g @seoagent-official/seoagent` once, then `seoagent init` in your project. This scaffolds the Skill into `.claude/skills/seoagent/` so Claude Code picks it up automatically — no config files to wire up.
Ask Claude Code to audit your site
Just say "audit my site." The Skill fetches your homepage, sitemap, and robots.txt, crawls the live pages, and reports the biggest issues with the exact fix for each — not a vague to-do list.
Approve the fixes
Claude Code proposes changes — metadata, schema, canonicals, internal links — as edits to your source. You review the diff and approve what makes sense. Safe, reversible, and shipped through your normal pipeline.
Build content in your repo
Ask it to research keywords and write articles or landing pages. It builds a topic cluster with internal linking and publishes the files into your repo (or your CMS), so a reviewed commit puts them live.
Connect Search Console (optional)
Run `seoagent login` to connect Google Search Console. Now the Skill grounds its suggestions in your real traffic data — which queries you rank for on page two, which pages are slipping — instead of guessing.
What SEOAgent does in Claude Code
Technical SEO audits
Crawls your live pages and flags indexing, canonical, metadata, render, and internal-link issues — with the evidence and the fix attached to each finding.
In-repo fixes
Applies safe, mechanical fixes (titles, meta descriptions, schema, alt text) directly in your source, and proposes the rest for approval.
Keyword & competitor research
Pulls real volume and difficulty and finds the queries you can realistically win, so content targets terms that matter.
Content that ranks and gets cited
Writes landing pages and articles structured for both readers and AI answer engines, with automatic internal linking into a topic cluster.
Search Console tracking
Reads your real GSC performance — pages with impressions but no clicks, queries slipping off page one — and turns each one into a change for Claude Code to make, so the work compounds instead of going stale.
Human-in-the-loop, always
Every change is a diff you approve. No autopilot, no AI slop published behind your back.
Frequently asked questions
How do I add SEO to Claude Code?
Install the SEOAgent Skill: run `npm install -g @seoagent-official/seoagent`, then `seoagent init` in your project. Claude Code detects the Skill automatically — then just ask it to "audit my site" to start.
Is the SEOAgent Skill for Claude Code free?
Yes. The Skill is free forever and runs locally. An optional cloud tier ($49 per site per month) adds Google Search Console analysis, competitor research, and cloud review of suggested updates.
What is the best Claude SEO tool?
For anyone with a codebase, a Skill beats a separate SEO app: it works where the site actually lives. SEOAgent is the highest-scoring SEO skill on the public SEO Skill Benchmark — it covers audits, fixes, keyword research, content, and Search Console grounding in one free install. Plain Claude (the chat app) can write titles and meta descriptions, but it cannot crawl your site or edit files; Claude Code with the Skill can.
Is this a Claude SEO checker?
Yes, and more. The Skill audits your live pages — indexing, canonicals, metadata, schema, render, and internal links — and keeps the evidence next to each finding so you can verify it. Unlike a checker that hands you a score, it also writes the fix into the right file for you to approve.
Can Claude Code track my SEO rankings?
Not on its own — Claude Code has no ranking data until you give it some. Run `seoagent login` to connect Google Search Console and the Skill reads your real impressions, clicks, and positions, then turns declines and missed opportunities into tasks for Claude Code to fix.
Does it publish content automatically?
No. SEOAgent proposes every change as a diff you review and approve. It writes files into your repo or CMS, but you decide what ships — it is intentionally not an auto-publishing blog spammer.
What can Claude Code actually do with the Skill?
Run technical SEO audits, fix metadata/schema/canonicals/internal links in your source, research keywords and competitors, and write optimized landing pages and articles into your codebase — grounded in your Search Console data once connected.
Is there a universal SEO skill for Claude Code?
Yes — the SEOAgent Skill is a universal SEO skill: one install covers technical audits, on-page fixes, keyword and competitor research, content writing, and internal linking. The same Skill file also works in Cursor and Codex, so it travels with your repo.
Does it work with Cursor and Codex too?
Yes. The same Skill works in Cursor and Codex, plus a standalone CLI. See the SEO Skill for Cursor and for Codex.
See also
Give Claude Code the SEO tools
Enter your site, create your prompt, and paste it into Claude Code — it installs the Skill, binds your account, and runs your first audit in minutes.
Want measurement on top? See Autopilot pricing.
Give Claude Code an SEO harness to continually measure and grow your site's organic traffic.