SEO Optimizer

Fetches a public URL through the SSRF-safe client and returns an on-page SEO score from real checks (title, meta description, headings, image alt text, keywords, and more). If the page cannot be fetched, answers with an error status (403, 404, 5xx), serves a CDN/WAF challenge or block page (for example "Just a moment..."), or the call passes the 7 second cap, the route answers 422: score is null, reason says why, charged is false, and no payment is settled. Invalid input (missing url, non-http(s) scheme, private or loopback host, keywords not a list) is refused with 400 before payment, so no 402 is issued. A paid 200 always carries a real score, a letter grade (A ≥90, B ≥80, C ≥65, D ≥50, F <50), top_fixes (up to 3), and charged: true.

Step 1 — curl

curl -s -X POST https://x402-micro-pay.com/api/skills/seo \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","keywords":["x402","agents"]}'

Step 2 — Agent

python -m agent.humanless_client seo --url https://example.com

Step 3 — Tutorial workflow

1. Run SEO on your landing page URL
2. Apply top recommendations (failed checks, highest weight first)
3. Re-run and compare score