{"_id":"@benven/site-audit","_rev":"2-f68a5748478279cfd82886d6832cf67a","name":"@benven/site-audit","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@benven/site-audit","version":"1.0.0","keywords":["seo","audit","website-audit","lighthouse","web-performance","accessibility","design-system","core-web-vitals","crawler","playwright","cli"],"author":{"name":"Eli Benveniste","email":"eli@ventechdigital.com"},"license":"MIT","_id":"@benven/site-audit@1.0.0","maintainers":[{"name":"benven","email":"eli@ventechdigital.com"}],"homepage":"https://github.com/eliBenven/site-audit","bugs":{"url":"https://github.com/eliBenven/site-audit/issues"},"bin":{"site-audit":"dist/cli.js"},"dist":{"shasum":"4634c5106255d069f13a4c155d9fa157d34cf802","tarball":"https://registry.npmjs.org/@benven/site-audit/-/site-audit-1.0.0.tgz","fileCount":72,"integrity":"sha512-RiTvc/aCJ2wI8VJ8FYg4GEIz8hj2REZQedQVVJqHaOwYcsjAdEuK3XVYbqQa/PvgRPJD86nJJRtXoLAFB5Ok2A==","signatures":[{"sig":"MEUCIC93FDDxQpYWz5Y2MvY4FSIODzhHGT9uLTootUl3ZGFSAiEAg/W+2/+l5f1uX/0Nx+doYHJXxGPCv9R3u5m1RbZ7JhA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":391133},"main":"dist/cli.js","type":"module","types":"./dist/cli.d.ts","engines":{"node":">=18.0.0"},"gitHead":"8223ec72163c98185caa16dbd65e3261b028cc66","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/cli.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"benven","email":"eli@ventechdigital.com"},"repository":{"url":"git+https://github.com/eliBenven/site-audit.git","type":"git"},"_npmVersion":"10.8.2","description":"Comprehensive website auditing CLI with design scoring, SEO checks, Lighthouse CWV, accessibility, and AI-powered analysis","directories":{},"_nodeVersion":"20.20.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","cheerio":"^1.2.0","commander":"^12.1.0","lighthouse":"^12.4.0","playwright":"^1.49.1","chrome-launcher":"^1.1.2","@anthropic-ai/sdk":"^0.78.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/site-audit_1.0.0_1773555804111_0.5361612232682396","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@benven/site-audit","version":"1.1.0","description":"Comprehensive website auditing CLI with design scoring, SEO checks, Lighthouse CWV, accessibility, and AI-powered analysis","license":"MIT","author":{"name":"Eli Benveniste","email":"eli@ventechdigital.com"},"type":"module","main":"dist/cli.js","bin":{"site-audit":"dist/cli.js"},"repository":{"type":"git","url":"git+https://github.com/eliBenven/site-audit.git"},"homepage":"https://github.com/eliBenven/site-audit","bugs":{"url":"https://github.com/eliBenven/site-audit/issues"},"keywords":["seo","audit","website-audit","lighthouse","web-performance","accessibility","design-system","core-web-vitals","crawler","playwright","cli"],"scripts":{"build":"tsc","start":"node dist/cli.js","dev":"tsc --watch","typecheck":"tsc --noEmit","test":"vitest run","prepublishOnly":"npm run build"},"dependencies":{"@anthropic-ai/sdk":"^0.78.0","chalk":"^5.3.0","cheerio":"^1.2.0","chrome-launcher":"^1.1.2","commander":"^12.1.0","lighthouse":"^12.4.0","ora":"^8.1.1","playwright":"^1.49.1"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2","vitest":"^4.0.18"},"engines":{"node":">=18.0.0"},"_id":"@benven/site-audit@1.1.0","gitHead":"68f87ea19b88205d57f7e93a53468c52ab56db12","types":"./dist/cli.d.ts","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-rru9af+S3GCDQocRO3PRAFHbfjwNwbEuJZ15Yjd7wbOiHeofkPc5+dio/pqOlYI/uXphgVIBGe9q8iruyQY+zA==","shasum":"d8ecba384f18d65cbf319b9e02b45f89c5058844","tarball":"https://registry.npmjs.org/@benven/site-audit/-/site-audit-1.1.0.tgz","fileCount":84,"unpackedSize":446664,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDC/rb+wpbPT9FOCp1MCSa5HsD6QQD65K1++EKpHacNQQIgaenFX8TZrffIdH98fYOIMianHkfYx/cObEJ2172BTfQ="}]},"_npmUser":{"name":"benven","email":"eli@ventechdigital.com"},"directories":{},"maintainers":[{"name":"benven","email":"eli@ventechdigital.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/site-audit_1.1.0_1773556180211_0.526374101652056"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-15T06:23:23.990Z","modified":"2026-03-15T06:29:40.542Z","1.0.0":"2026-03-15T06:23:24.270Z","1.1.0":"2026-03-15T06:29:40.397Z"},"bugs":{"url":"https://github.com/eliBenven/site-audit/issues"},"author":{"name":"Eli Benveniste","email":"eli@ventechdigital.com"},"license":"MIT","homepage":"https://github.com/eliBenven/site-audit","keywords":["seo","audit","website-audit","lighthouse","web-performance","accessibility","design-system","core-web-vitals","crawler","playwright","cli"],"repository":{"type":"git","url":"git+https://github.com/eliBenven/site-audit.git"},"description":"Comprehensive website auditing CLI with design scoring, SEO checks, Lighthouse CWV, accessibility, and AI-powered analysis","maintainers":[{"name":"benven","email":"eli@ventechdigital.com"}],"readme":"# site-audit\n\nComprehensive website auditing CLI. Crawls your site, runs 30+ SEO checks, evaluates design against a universal perfection standard, measures Core Web Vitals, and generates prioritized HTML reports with ranked fixes.\n\n![HTML Report](assets/report-screenshot.png)\n\n![Design Score](assets/design-score-terminal.svg)\n\n## Features\n\n**SEO** — 20+ checks: titles, meta descriptions, headings, images, canonical tags, Open Graph, structured data, status codes, redirects, mixed content, thin content, duplicate detection\n\n**Design Evaluation** (beta) — Scores visual design against an opinionated, non-configurable perfection standard across 8 dimensions: typography, color, spacing, layout, interaction, performance, consistency, polish\n\n**Accessibility** — Form labels, ARIA landmarks, skip navigation, tabindex, heading hierarchy, lang attribute\n\n**Performance** — Lighthouse CWV (LCP, INP, CLS), render-blocking scripts, image optimization, TTFB tracking\n\n**Security** — HSTS, CSP, X-Frame-Options, X-Content-Type-Options header checks\n\n**AI Analysis** — Claude-powered executive summary, per-page insights, and detailed fix instructions (requires `ANTHROPIC_API_KEY`)\n\n## Install\n\n```bash\nnpx @benven/site-audit audit https://example.com\n```\n\nOr install globally:\n\n```bash\nnpm install -g @benven/site-audit\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/eliBenven/site-audit.git\ncd site-audit\nnpm install && npm run build\n```\n\nOptional: install Playwright for rendered crawling and design evaluation:\n```bash\nnpx playwright install chromium\n```\n\n## Usage\n\n### Full audit\n```bash\nsite-audit audit https://example.com\n```\n\n### Design evaluation\n```bash\nsite-audit design https://example.com\n```\n\n### Quick crawl\n```bash\nsite-audit crawl https://example.com\n```\n\n### Key flags\n```\n--mode html|rendered    Crawl mode (default: rendered via Playwright)\n--skip-lighthouse       Skip Lighthouse performance audit\n--check-image-sizes     Check actual image file sizes via HEAD requests\n--ai                    Enable AI analysis (requires ANTHROPIC_API_KEY)\n--json                  Output JSON to stdout\n--ci                    CI mode (plain text, no spinners)\n--fail-on <severity>    Exit non-zero if issues exist (error|warning|info)\n--pdf                   Generate PDF report\n--depth <n>             Max crawl depth (default: 3)\n--max-pages <n>         Max pages to crawl (default: 50)\n--user-agent <string>   Custom User-Agent\n--include <patterns>    URL patterns to include\n--exclude <patterns>    URL patterns to exclude\n--cookie <string>       Cookie string for authenticated pages\n--no-robots             Ignore robots.txt\n--retries <n>           Retries on transient failures (default: 1)\n```\n\n### CI integration\n```bash\nsite-audit audit https://example.com --ci --fail-on warning\n```\n\n### Compare audits over time\n```bash\nsite-audit history\nsite-audit diff report-before.json report-after.json\n```\n\n## Design Evaluation\n\nThe `design` command evaluates every page against a universal design perfection standard. No configuration — the spec defines what perfection looks like:\n\n- **Typography**: modular scale, max 2 fonts, 16-21px body, max 8 distinct sizes\n- **Color**: max 16 unique colors, WCAG AA/AAA contrast, no near-duplicates\n- **Spacing**: 4px grid adherence, max 16 distinct values\n- **Layout**: max-width set, no horizontal overflow, images dimensioned\n- **Interaction**: 44px touch targets, visible focus indicators, 100-400ms transitions\n- **Performance**: CLS = 0, font-display set, images prevent reflow\n- **Consistency**: max 4 border-radius values, max 4 shadows\n- **Polish**: favicon, alt text, no broken images\n\nScore of 95+ = perfect. Below 75 = needs work.\n\n## How it compares\n\n| Feature | site-audit | Lighthouse | Ahrefs / SEMrush | Screaming Frog |\n|---|---|---|---|---|\n| SEO checks | 20+ rules | Basic | Comprehensive | Comprehensive |\n| Design scoring | **Yes (0-100)** | No | No | No |\n| Design system analysis | **Typography, color, spacing scales** | No | No | No |\n| AI-powered insights | **Claude API** | No | AI content tools | No |\n| Accessibility | HTML-based | Full audit | Limited | Limited |\n| Performance (CWV) | Lighthouse integration | Native | Partial | No |\n| Ranked fix list | **Impact x Effort** | Opportunities | Priority lists | No |\n| Security headers | Yes | No | No | No |\n| Self-hosted | **Yes, fully local** | Yes | No (SaaS) | Desktop app |\n| CI/CD integration | `--fail-on`, `--json` | CI mode | API | No |\n| Price | **Free / open source** | Free | $99-449/mo | Free / $259/yr |\n| Design perfection standard | **Universal, opinionated** | No | No | No |\n\n**The key difference**: site-audit is the only tool that defines a measurable success state for design. Other tools tell you what's broken — site-audit tells you when you're done.\n\n## AI Analysis\n\nSet your Anthropic API key and pass `--ai`:\n\n```bash\nANTHROPIC_API_KEY=sk-ant-... site-audit audit https://example.com --ai\n```\n\nGenerates an executive summary, per-page content quality analysis, and step-by-step fix instructions.\n\n## Local Dashboard\n\nLaunch an interactive dashboard in your browser:\n\n```bash\nsite-audit serve https://example.com\n```\n\nOpens a dark-themed dashboard with animated score gauges, dimension breakdowns, and an interactive fix table.\n\n## Score Badges\n\nGenerate embeddable SVG badges for your README:\n\n```bash\nsite-audit badge https://example.com -o ./assets\n```\n\nThen add to your README:\n```markdown\n![Design Score](assets/design-badge.svg) ![SEO](assets/seo-badge.svg)\n```\n\n## GitHub Action\n\nRun site-audit on every PR automatically:\n\n```yaml\n# .github/workflows/site-audit.yml\nname: Site Audit\non: [pull_request]\njobs:\n  audit:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: eliBenven/site-audit@main\n        with:\n          url: 'https://your-preview-url.vercel.app'\n          design-threshold: '80'\n        env:\n          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n```\n\nComments on your PR with the design score, SEO summary, and top fixes. Fails the check if the design score drops below your threshold.\n\n## AI Visual Annotations\n\nWith `--ai`, the design command generates annotated reports showing exact locations of issues:\n\n```bash\nANTHROPIC_API_KEY=sk-ant-... site-audit design https://example.com --ai\n```\n\nProduces `design-annotations.html` with screenshots side-by-side with AI-identified issues, exact locations, severity, and fix instructions.\n\n## Claude Code Skill\n\nThis tool is also available as a Claude Code slash command:\n\n```\n/site-audit https://example.com\n```\n\nThis runs the full pipeline, verifies findings with Playwright MCP screenshots, and presents an actionable summary.\n\n## Development\n\n```bash\nnpm install\nnpm run dev          # Watch mode\nnpm run typecheck    # Type check\nnpm test             # Run tests (vitest)\nnpm run build        # Build\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, coding standards, and PR process.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}