SEOAgent for Claude Code

The SEO Skill for Claude Code

A free Skill that gives Claude Code the tools to grow your organic traffic — audit your site, fix technical SEO, and build optimized pages right in your repo, with you approving every change.

Install the Skill — free

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. 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

  1. 1

    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.

  2. 2

    Ask Claude Code to audit your site

    Just say "audit my site." The Skill fetches your homepage, sitemap, and robots.txt, runs a full technical-SEO check, and reports the biggest issues with the exact fix for each — not a vague to-do list.

  3. 3

    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.

  4. 4

    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.

  5. 5

    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 pages and flags indexing, canonical, metadata, render, and internal-link issues — with 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 grounding

Reads your real GSC performance and suggests evidence-backed updates, 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.

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.

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.

Give Claude Code the SEO tools

Install the free Skill and run your first audit in minutes.

Get started — free