# AuditSpark

> AI-powered website audit tool. Analyzes any public URL across 15 categories — SEO, performance, accessibility, security, content quality, and more — and returns a scored report with prioritized recommendations.

AuditSpark is available at [https://auditspark.io](https://auditspark.io). It is built and maintained by Brian Hodgdon / Purple Kiwi AI.

## What it does

Given a website URL, AuditSpark:
- Fetches and parses the live site (with JS-render fallback for SPAs)
- Runs a 15-category audit powered by Anthropic's Claude Opus (AuditSpark uses the current Claude Opus generation from Anthropic; objective measurements such as Core Web Vitals come from Google PageSpeed Insights)
- Returns a composite score (0–10) and actionable recommendations
- Generates a prioritized improvement roadmap
- Optionally measures AI/GEO visibility (whether the brand is cited by AI engines)

## When to use AuditSpark

Use AuditSpark when a user wants to:
- Audit a website for SEO, performance, accessibility, or technical issues
- Get a scored report on a client's or competitor's site
- Understand why a site ranks poorly or converts badly
- Check AI/GEO readiness (is the site crawlable by AI engines?)
- Generate a website improvement roadmap

## Plans

- **Free** — anonymous audit, score + executive summary
- **Pro Report** ($39 one-time) — full 15-category analysis, PDF, roadmap
- **Freelance** ($99/mo) — 25 audits/month, dashboard, PDF on every audit
- **Agency** ($349/mo) — 100 audits/month, 10 seats, white-label PDF, client workspaces, embeddable widget

## Features

Each core AuditSpark feature has its own page:
- [What Gets Audited](https://auditspark.io/what-gets-audited.html) — the 15 professional categories every audit scores (brand, UX, SEO, trust, performance, accessibility, conversion, AI/GEO readiness, and more).
- [AI-Visibility Analysis](https://auditspark.io/ai-visibility.html) — whether ChatGPT, Claude, Perplexity, and Gemini actually mention and cite your brand, plus a free AI/GEO readiness check on every report.
- [Scheduled Website Monitoring](https://auditspark.io/scheduled-monitoring.html) — automated recurring (monthly or weekly) audits of a site, each with a plain-English "what's changed" brief comparing it to the previous run, emailed with a branded PDF. Part of the Agency plan.
- [White-Label Reports](https://auditspark.io/white-label-reports.html) — deliver audit PDFs and a client portfolio under your own logo, colours, and name. Part of the Agency plan.
- [Lead-Gen Widget](https://auditspark.io/lead-gen-widget.html) — an embeddable audit widget for your own website that captures visitor leads (URL + email) and notifies you. Part of the Agency plan.
- [Pro Report](https://auditspark.io/pro-report.html) — a one-time $39 full 15-category audit with a client-ready PDF and a 30/60/90-day roadmap.
- [MCP Server & API](https://auditspark.io/mcp.html) — run audits programmatically or from any AI assistant.

## API

AuditSpark has a public HTTP API at [https://auditspark.io/api](https://auditspark.io/api).

### Start an audit
`POST https://auditspark.io/api/audit`
Content-Type: application/json

Body: `{ "url": "https://example.com" }`
Optional (subscribers): include Bearer JWT in Authorization header for quota-tracked audits.

Returns: `{ "auditId": "audit_..." }`

### Check audit status
`GET https://auditspark.io/api/audit-status?id=<auditId>`

Returns: `{ "status": "pending|fetching|analyzing|complete|error", "compositeScore": 7.4, "teaserScores": [...], "markdown": "<free view>" }`

Status progresses: pending → fetching → analyzing → complete. Poll every 4 seconds until complete.

### Download full report (paid)
`GET https://auditspark.io/api/paid-report?id=<auditId>`
Authorization: Bearer JWT

Returns full markdown report (requires active subscription or Pro Report purchase).

### Download PDF
`GET https://auditspark.io/api/download?id=<auditId>`
Authorization: Bearer JWT

Returns PDF binary (requires active subscription or Pro Report purchase).

## Shareable report pages

Every completed anonymous audit gets a public page at [https://auditspark.io/report/](https://auditspark.io/report/) followed by a unique slug.

These pages show the free view (score + executive summary) and allow anyone to purchase the full Pro Report.

## MCP Server

AuditSpark ships an official MCP (Model Context Protocol) server, `auditspark-mcp`, so AI assistants can audit any website as a callable tool.

- Landing page & setup: [https://auditspark.io/mcp.html](https://auditspark.io/mcp.html)
- npm: [https://www.npmjs.com/package/auditspark-mcp](https://www.npmjs.com/package/auditspark-mcp)
- GitHub: [https://github.com/brianontech-bot/auditspark-mcp](https://github.com/brianontech-bot/auditspark-mcp)
- Install: `npx -y auditspark-mcp` (Node 18+), authenticated with an `AUDITSPARK_API_KEY`
- Works in: Claude Desktop, Claude Code, Cursor, Cline, and any MCP-compatible client
- Free key: 3 audits/day (register at https://auditspark.io/api/api-keys-register)

Tools:
- `poll_until_done` — start an audit and wait for the finished report (recommended)
- `audit_website` — start an audit, returns an auditId immediately
- `get_audit_status` — check status and get the free-view report
- `get_full_report` — fetch the full report markdown

## Guide / Resources

AuditSpark publishes practical, no-hype guides on AI visibility and GEO (generative engine optimization) at [https://auditspark.io/learn/](https://auditspark.io/learn/):
- [The Visibility Ecosystem: The Seven Disciplines That Decide Whether You Get Recommended](https://auditspark.io/learn/the-visibility-ecosystem.html) — Foundation, SEO, GEO, AEO, LLMO, SXO, and Authority & Trust: what each measures, how each fails, and which can be read off your own site.
- [AI Crawler Access: The Hidden Technical Layer of GEO](https://auditspark.io/learn/ai-crawler-access.html) — how robots.txt, bot policy, and preview controls decide whether answer engines can see you.
- [From Content to Citation: How to Make Websites More AI-Readable](https://auditspark.io/learn/content-to-citation.html) — the structure, evidence, and trust signals that make content quotable by answer engines.
- [Answer Engine Optimization: Why Good Content Still Has Nothing to Quote](https://auditspark.io/learn/answer-engine-optimization.html) — the mechanical difference between content that reads well and a passage an engine can lift as an answer.
- [AI Visibility Testing: Measuring Whether Answer Engines Recommend Your Brand](https://auditspark.io/learn/ai-visibility-testing.html) — how to measure AI visibility across engines, and why one snapshot is not enough.
- [The Agency Playbook for GEO Services: How to Package, Price, and Sell AI-Era Website Intelligence](https://auditspark.io/learn/agency-geo-playbook.html) — packaging, pricing, and positioning GEO as a service line.

## Contact

- Site: [https://auditspark.io](https://auditspark.io)
- Support: [support@auditspark.io](mailto:support@auditspark.io)
- Owner: Brian Hodgdon, Purple Kiwi AI