audiq — AI Website Auditor

Full-stack website QA: 18 audit phases across performance, accessibility, security, content, and UX. CLI, MCP server, or Node.js library.

What It Checks (18 Phases)

Tier 1 — Core QA

| Phase | What it does | |-------|-------------| | Inspector | Console errors, network failures, localhost leak detection | | Auditor | Lighthouse scores, axe-core accessibility, SEO meta checks | | Interactor | Dead click detection, form testing, link validation, soft 404s, redirect loops | | Multi-viewport | Mobile/tablet/desktop — touch targets, overflow, font readability, responsive images |

Tier 2 — UI State & Security

| Phase | What it does | |-------|-------------| | UI States | Contrast per-state (default/hover/focus/disabled), focus indicators, animation jank, z-index stacking, font loading | | Security | XSS testing, cookie flags, CSP validation, exposed secrets, HTTPS enforcement, open redirect detection |

Tier 3 — Content & Compliance

| Phase | What it does | |-------|-------------| | Content Quality | Broken images, placeholder text, debug leaks, empty states | | Privacy | Cookie consent, tracking scripts, privacy policy detection, data forms | | Third-Party | Blocking scripts, bundle size, data exfiltration, vulnerable libraries |

Tier 4 — Advanced QA

| Phase | What it does | |-------|-------------| | API Health | Slow responses, tokens in URLs, large payloads, chatty pages | | State Persistence | Back button, deep links, SPA routing, history pollution | | Error Resilience | 3G load test, offline behavior, API failure handling | | Visual Regression | Screenshot baselines, CLS measurement | | Structured Data | JSON-LD validation, schema.org, rich results eligibility | | Theme Testing | Dark/light mode contrast, hardcoded colors, theme toggle | | PWA | Service worker, manifest, icons, installability | | Frustration Signals | Fake buttons, crowded targets, slow response elements |

Usage

CLI

npx audiq scan <url>          # Full audit (all 18 phases)
npx audiq plan <url>          # Audit + prioritized fix plan
npx audiq review <url>        # AI visual review (needs ANTHROPIC_API_KEY)
npx audiq crawl <url>         # Site-wide crawl + audit
npx audiq plan-site <url>     # Crawl + site-wide fix plan
npx audiq mcp                 # Start MCP server

MCP Server (for Claude Code / AI IDEs)

npx audiq mcp

Add to claude_desktop_config.json or Claude Code MCP settings:

{
  "mcpServers": {
    "audiq": {
      "command": "npx",
      "args": ["audiq", "mcp"]
    }
  }
}

12 MCP Tools

| Tool | Description | |------|-------------| | scan_page | Deep audit — all 18 phases on a single page | | screenshot_page | Take screenshot, returns image for AI to analyze directly | | analyze_visual | AI visual review (uses API key, or returns image without) | | generate_fix_plan | Convert findings into prioritized fix tasks | | start_scan | Start async site-wide crawl + audit | | scan_status | Check scan progress | | scan_results | Get paginated results | | cancel_scan | Cancel running scan | | get_console_errors | Quick JS error check | | get_network_issues | Quick network failure check | | run_lighthouse | Standalone Lighthouse audit | | check_accessibility | Standalone axe-core audit | | get_report | Retrieve report in JSON or Markdown |

Programmatic

import { scanPage } from 'audiq';

const report = await scanPage({ url: 'https://example.com' });
console.log(report.issues); // Array of findings with severity + phase

Output

audiq scan https://example.com

  ✓ Inspector      3 issues (1 critical, 2 medium)
  ✓ Auditor        Performance: 72  SEO: 95  A11y: 88
  ✓ Interactor     2 dead clicks, 1 broken link
  ✓ Multi-viewport Touch target too small (32px < 44px) on mobile
  ✓ UI States      Low contrast on hover: #999 on #fff (2.8:1)
  ✓ Security       Missing CSP header, 1 cookie without Secure flag
  ...

  18 phases · 142 checks · 12 issues found
  Report: ./audiq-report.json

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ANTHROPIC_API_KEY | No | Enables server-side AI visual analysis |

Requirements

• Node.js >= 20
• Chrome/Chromium (auto-downloaded by Playwright on first run)

License

MIT