Fast, beautiful, AI-powered SEO audits from the command line. Scan any website and get an actionable score, specific fixes generated by Claude, and a shareable HTML report — all from one command.
- 🤖 AI-powered fix recommendations — Claude reads your page content + the issues found and generates concrete, page-specific fixes. Not "write a better title" — the actual suggested title for your page.
- 📄 Self-contained HTML report — share with clients, attach to emails, or use as your sales asset. One file, no external dependencies, beautifully designed.
--openflag — auto-opens the HTML report in your default browser after generation.
| Category | Checks |
|---|---|
| Meta | Title tag (length, exists), Meta description (length, exists) |
| Content | H1 tag (single, exists), H2 structure, Image alt text, Internal linking |
| Technical | HTTPS/SSL, Mobile viewport, Canonical URL, Schema markup |
| Social | Open Graph tags (title, description, image) |
| Performance | Page load time |
npm install -g @softangeles/seo-auditseo-audit https://example.comseo-audit https://example.com --verboseseo-audit https://example.com --html report.html --openThe --open flag launches the report in your default browser. The HTML file is fully self-contained — no external CSS or scripts — so you can email it, host it anywhere, or save it as a client artifact.
Set an Anthropic API key (free credits available at anthropic.com):
export ANTHROPIC_API_KEY=sk-ant-...
seo-audit https://example.com --aiYou get specific fixes per issue. Example:
🤖 AI-Powered Fixes:
[HIGH] Meta Description
Current page is missing it. Suggested: "Custom CRM, e-commerce stores,
and AI workflows for small businesses in Los Angeles. Built in days,
not weeks. Free consultation available." (158 chars, hits primary
keywords.)
[MED] Image Alt Text
3 of 8 images missing alt text. Based on context, add: "Custom CRM
dashboard mockup" to the hero image and "Client testimonial portrait —
John Doe, ABC Corp" to the testimonial photos.
Cost: one Claude Haiku call per audit (~$0.001). Use --no-ai to disable even when the key is set. AI is auto-enabled when you use --html or --verbose.
seo-audit https://example.com --jsonSCORE=$(seo-audit https://mysite.com --json | jq '.score')
if [ "$SCORE" -lt 70 ]; then
echo "SEO score too low: $SCORE/100"
exit 1
ficonst { auditUrl, generateFixes, generateHtmlReport } = require('@softangeles/seo-audit');
const result = await auditUrl('https://example.com');
const fixes = await generateFixes(result); // requires ANTHROPIC_API_KEY
const html = generateHtmlReport(result, fixes);
require('fs').writeFileSync('report.html', html); ╔══════════════════════════════════════╗
║ 🔍 SEO Audit Tool by SoftAngeles ║
╚══════════════════════════════════════╝
URL: https://example.com
🟡 SEO Score: 62/100 — Good
⏱ Load time: 847ms
████████████████████████░░░░░░░░░░░░░░░░
┌─ Meta
│ ✓ Title Tag 10/10
│ ⚠ Meta Description 5/10
│ Too short (45 chars) — aim for 150-160
│
┌─ Content
│ ✓ H1 Heading 10/10
│ ✓ H2 Headings 5/5
│ ✗ Image Alt Text 3/10
│ 7/10 images missing alt text
│
┌─ Technical
│ ✓ HTTPS 10/10
│ ✓ Mobile Viewport 10/10
│ ⚠ Canonical URL 0/5
│ ⚠ Schema Markup 0/5
Summary
✓ 6 passed ⚠ 3 warnings ✗ 1 failed
🤖 AI-Powered Fixes:
[HIGH] Image Alt Text
Hero image needs alt="Custom software development team in LA".
Testimonial photos should describe person + role.
[MED] Meta Description
Add: "We build custom CRMs, e-commerce stores, and AI workflows
for LA small businesses. Free consultation." (149 chars.)
─────────────────────────────────────────
Want help improving your SEO score?
→ Free consultation: https://softangeles.com/book
Pull requests welcome. Good first issues:
- Add new checks (hreflang, robots.txt, sitemap validation)
- Add additional output formats (Markdown, PDF)
- Improve scoring weights
- Add tests
- Add multi-page crawl mode
Built by SoftAngeles — a custom-software shop in Los Angeles, CA.
We build custom CRMs, e-commerce stores, and AI workflows for small businesses across LA.
MIT © SoftAngeles