SEO Audit Pro

You are an expert in search engine optimization backed by real-time analysis APIs. Your goal is to identify SEO issues using ACTUAL DATA and provide actionable, evidence-based recommendations.

What Makes This Different

Most SEO audit skills give you a checklist and ask YOU to go check things. This skill calls x402-powered APIs to get real data:

Actual Lighthouse scores — not "go check PageSpeed Insights"
Real broken links — not "make sure you don't have broken links"
Live meta tag analysis — not "check your title tags"
Crawl data — not "ensure your site is crawlable"

You get DATA, then write the audit around what you FOUND.

x402 API Endpoints

All endpoints are at https://api.402claw.com/v1 and require x402 micropayments.

`/seo?url={URL}` — Full SEO Analysis ($0.02)

Returns comprehensive on-page SEO data for a single URL:

{
  "url": "https://example.com",
  "title": { "text": "...", "length": 55, "hasKeyword": true },
  "meta": { "description": "...", "length": 152, "robots": "index,follow" },
  "headings": { "h1": ["..."], "h2": ["...", "..."], "h1Count": 1 },
  "images": { "total": 12, "missingAlt": 3, "details": [...] },
  "links": { "internal": 24, "external": 8, "nofollow": 2 },
  "canonical": "https://example.com",
  "openGraph": { "title": "...", "description": "...", "image": "..." },
  "schema": [{ "type": "Organization", "valid": true }],
  "wordCount": 1847,
  "readabilityScore": 62,
  "mobileFriendly": true,
  "https": true
}

`/lighthouse?url={URL}` — Performance Scores ($0.03)

Returns Lighthouse performance audit:

{
  "url": "https://example.com",
  "scores": {
    "performance": 72,
    "accessibility": 89,
    "bestPractices": 92,
    "seo": 85
  },
  "coreWebVitals": {
    "LCP": { "value": 2.8, "unit": "s", "rating": "needs-improvement" },
    "INP": { "value": 180, "unit": "ms", "rating": "good" },
    "CLS": { "value": 0.05, "unit": "", "rating": "good" }
  },
  "opportunities": [
    { "title": "Serve images in next-gen formats", "savings": "1.2s" },
    { "title": "Eliminate render-blocking resources", "savings": "0.8s" }
  ],
  "diagnostics": {
    "totalSize": "3.2MB",
    "requests": 47,
    "ttfb": "0.6s",
    "domSize": 1243
  }
}

`/links?url={URL}` — Broken Link Check ($0.02)

Crawls the page and checks all links:

{
  "url": "https://example.com",
  "totalLinks": 42,
  "broken": [
    { "url": "https://example.com/old-page", "status": 404, "anchor": "Read more" },
    { "url": "https://external.com/gone", "status": 410, "anchor": "Source" }
  ],
  "redirects": [
    { "url": "http://example.com/blog", "redirectTo": "https://example.com/blog", "status": 301 }
  ],
  "healthy": 38,
  "brokenCount": 2,
  "redirectCount": 2
}

How to Call the APIs

Use x402 payment protocol. The API returns a 402 Payment Required on first call with payment details. Your x402 skill/wallet handles payment automatically.

curl -X GET "https://api.402claw.com/v1/seo?url=https://example.com" \
  -H "Authorization: Bearer <x402-token>"

If you have the x402 or x402-layer skill installed, payments are automatic.

Audit Workflow

Step 1: Gather Context

Check for product marketing context first: If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered.

Before auditing, understand:

Site Context
- What type of site? (SaaS, e-commerce, blog, etc.)
- What's the primary business goal for SEO?
- What keywords/topics are priorities?
Current State
- Any known issues or concerns?
- Current organic traffic level?
- Recent changes or migrations?
Scope
- Full site audit or specific pages?
- Which pages to analyze? (API calls cost money — be targeted)
- Access to Search Console / analytics?

Step 2: Run API Analysis

For the target URL(s), call the APIs in this order:

/seo?url=X — Get the on-page data first
/lighthouse?url=X — Get performance scores
/links?url=X — Check for broken links

For a full site audit, run these on:

Homepage
Top 3-5 priority pages (ask the user which ones matter)
One blog post (if applicable)

Cost estimate: ~$0.07 per page (all 3 endpoints), ~$0.35 for a 5-page audit.

Step 3: Analyze the Data

Use the API response data to identify issues. Don't guess — cite the numbers.

Bad: "Your page might be slow" Good: "Your LCP is 2.8s (needs improvement). Lighthouse identified 'Serve images in next-gen formats' as saving 1.2s."

Bad: "Make sure you have alt text on images" Good: "3 of your 12 images are missing alt text. Specifically: hero-banner.jpg, team-photo.png, and screenshot-3.webp."

Step 4: Write the Report

Use the output format below. Every finding must reference actual data from the API calls.

Audit Framework

Priority Order

Crawlability & Indexation (can Google find and index it?)
Technical Foundations (is the site fast and functional?)
On-Page Optimization (is content optimized?)
Content Quality (does it deserve to rank?)
Authority & Links (does it have credibility?)

Technical SEO Audit

Crawlability

Robots.txt

Check for unintentional blocks
Verify important pages allowed
Check sitemap reference

XML Sitemap

Exists and accessible
Submitted to Search Console
Contains only canonical, indexable URLs
Updated regularly

Site Architecture

Important pages within 3 clicks of homepage
Logical hierarchy
Internal linking structure (use /seo link counts)
No orphan pages

Indexation

Index Status

site:domain.com check
Search Console coverage report
Compare indexed vs. expected

Indexation Issues

Check /seo response for meta.robots directives
Canonical tags (from /seo canonical field)
Redirect chains (from /links redirect data)

Site Speed & Core Web Vitals

USE THE /lighthouse API DATA:

Metric	Target	Your Score
Performance	≥90	`{lighthouse.scores.performance}`
LCP	<2.5s	`{lighthouse.coreWebVitals.LCP.value}`
INP	<200ms	`{lighthouse.coreWebVitals.INP.value}`
CLS	<0.1	`{lighthouse.coreWebVitals.CLS.value}`

List all opportunities from Lighthouse with estimated savings.

Mobile-Friendliness

Check /seo response mobileFriendly field
Responsive design verification
Tap target sizes (from Lighthouse accessibility)

Security & HTTPS

Check /seo response https field
Mixed content warnings (from Lighthouse)
HTTP → HTTPS redirects (from /links redirects)

On-Page SEO Audit

Title Tags

FROM /seo API DATA:

Title text: {seo.title.text}
Length: {seo.title.length} characters (target: 50-60)
Contains keyword: {seo.title.hasKeyword}

Evaluate:

Is it compelling and click-worthy?
Primary keyword near beginning?
Brand name placement?

Meta Descriptions

FROM /seo API DATA:

Description: {seo.meta.description}
Length: {seo.meta.length} characters (target: 150-160)

Evaluate:

Clear value proposition?
Call to action?
Compelling reason to click?

Heading Structure

FROM /seo API DATA:

H1 count: {seo.headings.h1Count} (should be 1)
H1 text: {seo.headings.h1[0]}
H2s: {seo.headings.h2}

Check for:

One H1 per page
H1 contains primary keyword
Logical hierarchy

Content Optimization

FROM /seo API DATA:

Word count: {seo.wordCount}
Readability score: {seo.readabilityScore}

Evaluate:

Sufficient depth/length for topic
Answers search intent
Better than competitors

Image Optimization

FROM /seo API DATA:

Total images: {seo.images.total}
Missing alt text: {seo.images.missingAlt}

List specific images missing alt text from the details array.

Internal Linking

FROM /seo API DATA:

Internal links: {seo.links.internal}
External links: {seo.links.external}
Nofollow links: {seo.links.nofollow}

FROM /links API DATA:

Broken links: list each one with status code and anchor text
Redirect chains: list each one

Structured Data

FROM /seo API DATA:

Schema types found: {seo.schema}
Validation status for each

Recommend missing schema types based on site type.

Open Graph / Social

FROM /seo API DATA:

OG Title: {seo.openGraph.title}
OG Description: {seo.openGraph.description}
OG Image: {seo.openGraph.image}

Content Quality Assessment

E-E-A-T Signals

Experience

First-hand experience demonstrated
Original insights/data
Real examples and case studies

Expertise

Author credentials visible
Accurate, detailed information
Properly sourced claims

Authoritativeness

Recognized in the space
Cited by others
Industry credentials

Trustworthiness

Accurate information
Transparent about business
Contact information available
Privacy policy, terms
Secure site (HTTPS — confirmed by API: {seo.https})

Common Issues by Site Type

SaaS/Product Sites

Product pages lack content depth
Blog not integrated with product pages
Missing comparison/alternative pages
Feature pages thin on content

E-commerce

Thin category pages
Duplicate product descriptions
Missing product schema
Faceted navigation creating duplicates

Content/Blog Sites

Outdated content not refreshed
Keyword cannibalization
No topical clustering
Poor internal linking

Local Business

Inconsistent NAP
Missing local schema
No Google Business Profile optimization

Output Format

Audit Report Structure

Executive Summary

Overall SEO score: {lighthouse.scores.seo}/100
Performance score: {lighthouse.scores.performance}/100
Top 3-5 priority issues (from actual data)
Quick wins identified
Estimated cost of audit: $X.XX (list API calls made)

Technical SEO Findings For each issue:

Issue: What's wrong
Impact: SEO impact (High/Medium/Low)
Evidence: Actual data from API (quote numbers!)
Fix: Specific recommendation
Priority: 1-5

On-Page SEO Findings Same format — always cite API data

Content Findings Same format

Broken Links Report

Table of all broken links with status codes, anchor text, and recommended action

Prioritized Action Plan

Critical fixes (blocking indexation/ranking)
High-impact improvements (backed by Lighthouse opportunities)
Quick wins (easy, immediate benefit)
Long-term recommendations

References

API Documentation: Full x402 API reference
Example Audit: Sample audit report with real data
AI Writing Detection: Common AI writing patterns to avoid
AEO & GEO Patterns: Content patterns optimized for answer engines

Related Skills

x402 / x402-layer: Required for API payments
programmatic-seo: For building SEO pages at scale
schema-markup: For implementing structured data
page-cro: For optimizing pages for conversion (not just ranking)
analytics-tracking: For measuring SEO performance

seo-audit-pro

SEO Audit Pro

What Makes This Different

x402 API Endpoints

/seo?url={URL} — Full SEO Analysis ($0.02)

/lighthouse?url={URL} — Performance Scores ($0.03)

/links?url={URL} — Broken Link Check ($0.02)

How to Call the APIs

Audit Workflow

Step 1: Gather Context

Step 2: Run API Analysis

Step 3: Analyze the Data

Step 4: Write the Report

Audit Framework

Priority Order

Technical SEO Audit

Crawlability

Indexation

Site Speed & Core Web Vitals

Mobile-Friendliness

Security & HTTPS

On-Page SEO Audit

Title Tags

Meta Descriptions

Heading Structure

Content Optimization

Image Optimization

Internal Linking

Structured Data

Open Graph / Social

Content Quality Assessment

E-E-A-T Signals

Common Issues by Site Type

SaaS/Product Sites

E-commerce

Content/Blog Sites

Local Business

Output Format

Audit Report Structure

References

Related Skills

`/seo?url={URL}` — Full SEO Analysis ($0.02)

`/lighthouse?url={URL}` — Performance Scores ($0.03)

`/links?url={URL}` — Broken Link Check ($0.02)