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

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.

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"

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

Returns side-by-side scores so you can see where you're ahead and where you're behind.

"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:

• Meta — Title tag, meta description, heading structure, canonical URLs
• Technical — Robots.txt, sitemap, HTTPS, redirects, structured data
• Social — Open Graph tags, Twitter cards, social metadata
• Performance — Page speed, Core Web Vitals, resource optimization
• Accessibility — Alt text, ARIA labels, color contrast, semantic HTML

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 four subcommands:

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: Audit your site and a competitor's, then ask Claude to compare the results and identify gaps.

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.