← Blog

Claude Code SEO Skill: Run SEO Audits Without Leaving Your Terminal

Install our Claude Code custom skill and run SEO audits, batch checks, and score comparisons directly from your coding sessions.

If you use Claude Code as your coding assistant, you can now run SEO audits inline — no browser tabs, no copy-pasting URLs, no context switching.

We built a custom Claude Code skill that wraps the SEO Score API. Type /seo-score, describe what you want, and get results right in your terminal.

<div style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;max-width:100%;margin:2rem 0;border-radius:8px;"> <iframe style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;border-radius:8px;" src="https://www.youtube.com/embed/C6LbxQ6pcvM" title="Claude Code SEO Skill Demo" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> </div>

Install in 30 Seconds

Clone the skill into your Claude Code skills directory:

mkdir -p ~/.claude/skills
cp -r seo-score ~/.claude/skills/seo-score

Or grab it directly:

mkdir -p ~/.claude/skills/seo-score/scripts
curl -sL https://seoscoreapi.com/skills/seo-score/SKILL.md -o ~/.claude/skills/seo-score/SKILL.md
curl -sL https://seoscoreapi.com/skills/seo-score/seo_audit.py -o ~/.claude/skills/seo-score/scripts/seo_audit.py
chmod +x ~/.claude/skills/seo-score/scripts/seo_audit.py

Set your API key (optional — single audits work without one):

export SEO_SCORE_API_KEY="your_key_here"

How to Use It

Once installed, just talk to Claude naturally. The skill triggers on SEO-related requests:

"Audit my homepage"

> audit https://yoursite.com

SEO Audit: https://yoursite.com
============================================================
  Score: 82.3 / 100   Grade: B+

Category Scores:
  Meta                 [################....] 18/20 (90%)
  Technical            [##############......] 14/20 (70%)
  Social               [##################..] 9/10 (90%)
  Performance          [################....] 32/40 (80%)
  Accessibility        [#################...] 9/10 (90%)

Top Priorities:
  1. Add structured data (Schema.org)
  2. Improve Largest Contentful Paint
  3. Add canonical URL tag

"Compare my site against a competitor for a keyword"

> competitive https://yoursite.com https://competitor.com running shoes

Competitive Audit: https://yoursite.com vs https://competitor.com
============================================================
  Keyword: running shoes
  Your Score:       72.0 / 100
  Competitor Score: 91.0 / 100
  Score Gap:        +19.0
  Competitive Gap:  34 / 100
  Keyword Relevance: You 45 vs Competitor 82

Top Gaps (where competitor beats you):
  1. [keyword] keyword_in_title: you 0 vs them 100 (gap: 100)
  2. [meta] content_length: you 30 vs them 100 (gap: 70)
  3. [keyword] keyword_density: you 0 vs them 100 (gap: 100)

Action Items:
  1. Add your target keyword 'running shoes' to the title tag
  2. Add ~1500 more words to match competitor content depth
  3. Add JSON-LD schema markup (competitor has it, you don't)

The competitive audit runs a head-to-head comparison including 7 keyword-relevance checks, then tells you exactly where and why the competitor beats you — with prioritized action items.

"Batch audit my product pages"

> batch https://yoursite.com https://competitor.com

Returns scores for multiple URLs at once.

"Check SEO for all our product pages"

> batch https://yoursite.com/product/a https://yoursite.com/product/b https://yoursite.com/product/c

Batch mode audits up to 10 URLs in a single call.

What Gets Checked

Every audit runs 28 checks across five categories:

You get a score from 0-100, a letter grade (A+ to F), and a prioritized list of what to fix first.

Under the Hood

The skill is two files:

  1. SKILL.md — Tells Claude when to activate (SEO-related requests) and what tools it can use
  2. scripts/seo_audit.py — A Python CLI that hits the SEO Score API using only standard library modules (no pip install needed)

When you have SEO_SCORE_API_KEY set, it uses the authenticated /audit endpoint with higher rate limits. Without a key, it falls back to the /demo-audit endpoint — great for trying it out.

The script supports five subcommands:

Command What it does
audit <url> Audit a single URL
batch <url1> <url2> ... Audit multiple URLs at once
competitive <url> <competitor_url> <keyword> Head-to-head competitive gap analysis (Pro+)
report <domain> Get the report URL for a domain
scoreboard Link to the public SEO scoreboard

Add --json to any command for raw JSON output — useful when Claude needs to parse and compare results programmatically.

Real-World Workflows

Pre-deploy SEO check: Before pushing to production, ask Claude to audit your staging URL. Catch missing meta tags and broken structured data before they go live.

Content review: After writing a new blog post, audit the page to make sure your title tag length, meta description, and heading structure are optimized.

Client reporting: Batch audit a client's top 10 pages and have Claude summarize the results into an action plan.

Competitive analysis: Run a competitive audit against a rival page for your target keyword. Get a gap score, per-check breakdown, and prioritized action items to close the gap.

Get Your API Key

Single audits work without a key, but for batch audits and higher rate limits:

  1. Sign up at seoscoreapi.com/docs — free tier available
  2. Set export SEO_SCORE_API_KEY="your_key" in your shell profile
  3. Start auditing

The free tier includes 50 audits per month. Paid plans start at $9/month for 500 audits with batch access.

Try SEO Score API free

Get Free API Key