AuditSpark/Website audits that spark action. by PURPLE KIWI AI →
User Guide

Everything you need to get the most from your audit.

From running your first free report to using the Freelance dashboard, Agency workspaces, and the developer API — all in one place.

01 — Getting started

Run your first free audit.

No account required. Paste a URL, pass the quick bot-check, and AuditSpark fetches your site and runs it through 15 professional categories using Claude Opus. The whole process takes 60–120 seconds.

Enter your URL

Paste any public website URL — your own site, a client's, or a competitor's. Include the protocol (https://). Subpages work too.

Pass the quick check

An invisible Cloudflare Turnstile check runs in the background. Most visitors never see a challenge.

Wait ~60–120 seconds

AuditSpark fetches your site, parses content and structure, then sends everything to Claude Opus for analysis. A progress indicator updates live.

Read the free report

You receive a composite score, an executive summary, an AI/GEO Readiness section, and a teaser scorecard. Detailed findings and the action plan are in the Pro Report.

Anonymous audits are public by default. Anyone with the report link can view the free summary — good for sharing, but make it private if needed. See Sharing reports.

Rate limits (free, anonymous)

To keep the service fair for everyone, anonymous audits are rate-limited:

5 per hour per IP 10 per day per IP 30-min cooldown per URL

If you hit a limit, wait and try again — or upgrade for a higher quota.

What gets analyzed

AuditSpark fetches your site's HTML and text content. If your site is built entirely client-side (React, Vue, etc.) and returns a near-empty page without JavaScript, the system automatically retries with a headless browser to render the full page. If the rendered version is also empty, the audit is flagged as unreadable and any subscription credit is refunded.

02 — Reading your report

What every section means.

Every audit — free or paid — follows the same structure. Here's how to read it.

Composite Score

A single 1–10 number derived from a weighted average across all 15 categories. It's not a vanity metric — the weights reflect business impact:

Tier 1 — Revenue Drivers (42%): Conversion Optimisation, Messaging Effectiveness, UX & Navigation, Technical Performance.

Tier 2 — Trust & Experience (30%): Mobile Experience, Trust & Credibility, Brand Clarity, Visual Design.

Tier 3 — Discovery & Reach (23%): SEO, Content Quality, Accessibility, Online Presence & Authority.

Tier 4 — First Impression (5%): Overall First Impression. Valuable but subjective, so it doesn't dominate.

A critical failure in any category (score ≤ 2) applies a −0.5 penalty, floored at 1.0.

Executive Summary

Two to three paragraphs that read like a senior consultant's verdict. No jargon — just what works, what doesn't, and the opportunity.

AI / GEO Readiness

A free, deterministic score (0–100) showing how well your site is set up to be understood and cited by AI engines — ChatGPT, Perplexity, Claude, and Google's AI overviews. It checks structured data (schema.org), semantic HTML, E-E-A-T signals, AI-crawler policy in robots.txt (GPTBot, ClaudeBot, PerplexityBot, Google-Extended), and whether you have an /llms.txt. Included on every report, free or paid.

Teaser Scorecard (free view)

The free report shows up to 9 category scores so you can see where you stand relative to the full 15. The detailed findings, action priority rationale, and the 30/60/90-day roadmap are unlocked in the Pro Report.

The 15 categories

01

Conversion Optimisation

CTAs, friction, funnel clarity

02

Messaging Effectiveness

Value prop, headline, audience fit

03

UX & Navigation

Structure, wayfinding, cognitive load

04

Technical Performance

Speed signals, Core Web Vitals factors

05

Mobile Experience

Responsiveness, touch targets, layout

06

Trust & Credibility

Social proof, transparency, security cues

07

Brand Clarity

Consistency, visual identity, voice

08

Visual Design

Hierarchy, whitespace, polish

09

SEO

Meta, headings, crawlability, content signals

10

Content Quality

Clarity, depth, relevance, originality

11

Accessibility

Alt text, contrast, keyboard nav, ARIA

12

Online Presence & Authority

Backlink signals, directory coverage, reviews

13

Overall First Impression

Above-the-fold read, immediate perception

14

Overall Scorecard

Category-by-category summary table

15

30/60/90-Day Roadmap

Prioritised action plan by effort & impact

03 — Plans & upgrades

Choose what fits your workflow.

AuditSpark has four tiers. Start free — upgrade only when you need more.

Plan Price Audits What you get
Free free $0 Rate-limited Score, exec summary, AI/GEO Readiness, teaser scorecard
Pro Report one-time $39 1 report Full 15-category analysis, PDF, 30/60/90-day roadmap
Freelance monthly $79/mo · $63/mo annual 15/month Dashboard, PDF on every audit, magic link login, API access
Agency monthly $249/mo · $199/mo annual 60/month shared 10 seats, white-label PDF, client workspaces, widget, portfolio dashboard, API access
Annual billing = 20% off ("two months free") on both Freelance and Agency. Switch at any time — billing adjusts at the next cycle.

All subscriptions are processed by Polar (our merchant of record), which handles invoicing, VAT, and receipts. Need a refund? See our Refund Policy.

04 — Pro Report

The full picture, one payment.

The Pro Report is a one-time $39 purchase tied to a specific audit. No account required. You buy it, you keep it.

Run a free audit

Any URL — no login needed. You'll see the free report first.

Click "Unlock Full Report — $39"

You're taken to a Polar checkout. Pay with card. The payment is tied to your specific audit ID.

Return to the report page

After payment, return to your report URL. The full analysis, scorecard, and roadmap unlock automatically. No account needed.

Download the PDF

A polished, branded PDF is available immediately. Save it, share it with a client, or use it in a proposal.

Save your report URL. The Pro Report is tied to your audit — not an account. Bookmark the page or save the URL from your Polar receipt email so you can return to it later. If you lose access, contact support.

What the Pro Report includes (vs. free)

FeatureFreePro Report
Composite score
Executive summary
AI / GEO Readiness score
Teaser scorecard (≤9 categories)
Full 15-category analysis
Full scorecard (all 15)
30/60/90-day action roadmap
PDF download
05 — Freelance plan

Your monthly audit toolkit.

The Freelance plan ($79/mo, or $63/mo billed annually) gives you 15 audits per month, a personal dashboard, PDF on every report, and API access. Designed for solo consultants, designers, and developers who audit regularly.

Signing in

AuditSpark uses magic links — no password required. Enter your email on the login screen, check your inbox, and click the link. You're in. Links expire after 15 minutes.

Your dashboard

The subscriber dashboard shows your plan status, usage for the current cycle (resets monthly), and your recent 25 audits in a unified table. Each row shows the URL, score, date, and source — Web for browser audits, API for programmatic ones.

Audit quota

15 audits per calendar month. The counter resets on your billing date. If you hit the limit, you'll see a clear message — no partial audits, no surprise charges. The reset is atomic, so there's no race condition when running audits near midnight.

If an audit fails because the target site is unreadable (empty client-side app, server error), your credit is automatically refunded. You're only charged for completed audits.

PDF download

Every audit on a Freelance plan includes a PDF. Click "Download PDF" on any audit in your dashboard or on the report page. PDFs are generated on demand and include the full analysis, scorecard, and roadmap.

API keys

The Dashboard → API Keys tab lets you create up to 10 keys for programmatic access. Quota shares the same 15/month pool as browser audits. See API & MCP access.

06 — Agency plan

Audits at scale — for your whole team.

The Agency plan ($249/mo, or $199/mo billed annually) gives you 60 shared audits per month, 10 team seats, white-label PDFs, client workspaces, an embeddable lead-gen widget, and API access.

Team members

The owner (the billing account) can invite up to 9 additional team members. Each member gets their own magic-link login. All audits pull from the shared 60/month pool — you see each other's work in the portfolio dashboard.

Go to Dashboard → Team

Enter the email address of the person you want to invite.

They receive an invite link

Invite links are valid for 48 hours. They click the link to join your agency workspace.

Owner can revoke at any time

Remove a member from the Team tab. Their access ends immediately; pending invites can be cancelled too.

Client workspaces

Clients are lightweight records that let you organise audits by the business you're auditing for. Create a client with a name, domain, and optional contact info. Then when you run an audit, attach it to a client.

The portfolio dashboard shows per-client stats: total audits, latest score, average score, and the last audit date. Great for reporting progress over time.

Deleting a client doesn't delete their audits. It orphans the link — the audits remain in your history but lose the client association. This is intentional (audit records are never automatically purged).

White-label PDFs

Upload your logo and set a brand name in Dashboard → Settings. Every PDF you generate will use your branding instead of AuditSpark's — ideal for client deliverables.

Lead-gen widget

The widget is a small embeddable audit tool you can add to your own website or client sites. Visitors enter a URL and get a free audit — but the results (and the lead's email) flow back to your agency dashboard.

Create a widget key

Go to Dashboard → Widgets and create a key. Give it a label and optionally restrict it to specific domains.

Add the embed snippet

Copy the one-line <script> tag and paste it into your site's HTML. The widget renders in an iframe automatically.

Leads come to you

When a visitor submits their email for a full report, you're notified. Leads appear under Dashboard → Widgets.

Widget quota: 20 widget audits/month are included, separate from your 60/month agency quota. Overages are $2.00 per audit, invoiced at renewal.

07 — AI / GEO add-on

See how AI engines actually see your brand.

There are two separate halves to GEO — one free, one paid.

AI / GEO Readiness (free, on every report)

A deterministic 0–100 score included on every audit, free or paid. It checks the on-site signals AI engines rely on: structured data, semantic HTML, E-E-A-T, AI crawler permissions in robots.txt, and presence of /llms.txt. You get a score and a short list of fixes. Zero AI cost.

AI Visibility add-on (paid, subscriber-only)

The paid add-on goes further: it actually asks AI engines whether they know your brand, using real prompts (branded and unbranded), and measures your Share of Voice against competitors. This costs 2 audit credits and runs on Claude Haiku (~$0.10–0.30/audit).

To enable it, check "Include AI Visibility analysis" on the audit form (only visible when you're logged in on a Freelance or Agency plan). Your report will include a ## AI Visibility section after the scorecard.

If the AI Visibility section fails (network issue, model timeout), the website audit is still delivered and 1 credit is refunded. You're never charged for a failed add-on.
FeatureFreeFreelance / Agency
AI/GEO Readiness score (0–100)
Crawler policy check (robots.txt / llms.txt)
Structured data & E-E-A-T signals
AI Visibility (live probe — costs 2 credits)✓ opt-in
Share of Voice vs. competitors
Sentiment & factual accuracy check
08 — API & MCP access

Integrate audits into your own tools.

AuditSpark has a REST API and an MCP server — so you can trigger audits from your own code, Claude, or any AI assistant that supports the Model Context Protocol.

Free API keys (3 audits/day)

You don't need a subscription to use the API. Register a free key at POST /api/api-keys-register with your email address. Your key (ak_…) is emailed to you. Free keys allow 3 audits per 24-hour window.

Subscriber API keys

On Freelance or Agency, go to Dashboard → API Keys to generate up to 10 keys. These draw from your monthly quota (same pool as browser audits), so they're subject to the same 15/month or 60/month limits.

Authenticating

Pass your key as the x-api-key header on any audit request:

x-api-key: ak_your_key_here

Core endpoints

EndpointWhat it does
POST /api/auditStart an audit. Returns {auditId} immediately.
GET /api/audit-status?id=Poll for status (pending → fetching → analyzing → complete). Returns score + free markdown when complete.
GET /api/paid-report?id=Returns full markdown if paid or subscriber.
POST /api/api-keys-registerRegister a free API key (email required).

MCP server

The auditspark-mcp package wraps the API as four MCP tools for use in Claude, Cursor, or any MCP-compatible host:

audit_website get_audit_status poll_until_done get_full_report

Install via npm: npm install -g auditspark-mcp. Set your key as AUDITSPARK_API_KEY. See the README for setup instructions per host.

09 — Sharing reports

Every report has a permanent, shareable link.

Every completed audit gets a public URL at auditspark.io/report/<slug>. The page shows the free view — score, exec summary, AI/GEO Readiness, and teaser scorecard — plus a link to buy the full Pro Report.

Anonymous vs. signed-in audits

Anonymous auditSigned-in audit
DefaultPublic (link auto-generated)Private (no link until you publish)
Make privateClick "Make private" in the reportNever published unless you click "Publish"
DeleteClick "Delete report" in the reportDelete from dashboard or report page
Anonymous audits are public by default to power organic discovery. If you're auditing a private or confidential site, sign in first — signed-in audits are private until you actively share them.

Making a report private

In the free section of any report, you'll see a "Make private" link. Click it to immediately remove the public URL. The report itself isn't deleted — only the public slug is removed. If you later want to re-share it, sign in and publish again from your dashboard.

Social sharing

Public report pages include Open Graph tags so they preview nicely when shared on LinkedIn, X, Slack, or elsewhere. The title, description, and score appear in the link card.

10 — FAQ

Common questions, answered.

QHow accurate is the audit?
AuditSpark uses Claude Opus to analyse your site's content, structure, and metadata. It's expert-level advisory analysis — not a crawler measuring millisecond response times. Treat it as a senior consultant's read, not a technical benchmark tool. Category scores and recommendations are directionally accurate and reflect real website best practices, but specific metrics (like exact Lighthouse scores) require dedicated tools like Google PageSpeed Insights.
QDoes it work on JavaScript-heavy (SPA) sites?
Yes. If the initial fetch returns a near-empty page (common with React, Vue, or Next.js client-side apps), AuditSpark automatically retries with a headless browser via Browserless.io to render the full page. If the render still comes back empty or fails, the audit is flagged as unreadable and no credit is charged.
QCan I audit a staging or localhost URL?
No — for security reasons, private IP addresses, localhost, and non-HTTP(S) URLs are blocked. The site must be publicly accessible on the internet. Use a service like ngrok or a staging subdomain to expose local environments.
QWhat happens to my data?
Your audit results are stored in our database. Anonymous audits are public by default (shareable URL); signed-in audits are private by default. You can delete any report at any time from the report page. See our Privacy Policy for full details.
QI ran an audit and got an error. What do I do?
If your audit shows an error status, a credit refund is automatic. Try again — most errors are temporary (network timeouts, site downtime). If the same URL keeps failing, it may be blocking crawlers via robots.txt or Cloudflare. You can also try auditing a specific subpage instead of the homepage.
QCan I get a refund?
Yes. Our Refund Policy covers the details. For Pro Reports, refunds are available within 14 days if the report failed to generate. For subscriptions, contact us within the first billing cycle. Overages and partial-month cancellations are not refunded.
QI lost my Pro Report URL. Can I recover it?
Check the email from Polar (your payment receipt) — it includes a link back to the checkout success page with your audit ID. If you've lost that too, email us at support@auditspark.io with your payment email and we'll locate it.
QHow does the Agency quota work with multiple users?
All team members share the 60 audits/month pool. There's no per-seat cap — one person can use all 60, or 10 people can each use 6. You can see each team member's audits in the portfolio dashboard. Widget audits are a separate pool (20/month included).
QHow do I cancel my subscription?
Log into your Polar account (the email you used to subscribe) and cancel from there. Your subscription remains active until the end of the billing period. You won't be charged again after cancellation.
QIs there a trial period?
Every free audit is effectively a trial — you see the score, exec summary, and AI/GEO Readiness at no cost and with no account. There's no time-limited trial for paid plans; the free tier is designed to let you validate the quality before upgrading.
Still have questions?

Email us at support@auditspark.io and we'll get back to you within one business day.

Run a free audit →