AuditYourStore — Free AI eCommerce Audit Tool

Documentation

Everything you need to integrate AuditYourStore into your workflow — REST API, MCP server for AI assistants, audit methodology, and more.

Getting Started

AuditYourStore is an AI-powered eCommerce CRO audit tool that analyzes your online store across 277+ checkpoints in 7 categories. Three ways to use it:

Web App

Paste your URL for a free instant audit

REST API

Programmatic audits via HTTP

MCP Server

AI assistant integration

Quick start — Free audit

1

Go to ai.audityourstore.com

2

Enter your store URL and email address

3

Verify your email — click the link we send

4

Your audit runs automatically — results in 60-90 seconds

Quick start — API

1

Generate an API key in Dashboard → API Keys

2

Purchase audit credits at Pricing

3

POST /api/v1/audit with your store URL

4

GET /api/v1/audit/:jobId — poll until status is completed

5

GET /api/v1/report/:slug — retrieve the full report

REST API Reference

Base URL: https://ai.audityourstore.com/api/v1

Authentication

Pass your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate keys in Dashboard → API Keys. Each audit costs 1 credit.

POST/api/v1/audit

Submit a new audit. Costs 1 credit. Returns a job ID for polling.

Request body

{
  "url": "https://mystore.com",
  "industry": "fashion",     // optional
  "platform": "shopify"      // optional
}

Response (202)

{
  "jobId": "abc123",
  "status": "queued",
  "message": "Audit queued. Poll GET /api/v1/audit/abc123 for progress."
}
GET/api/v1/audit/:jobId

Check audit status and progress. Poll until status is completed.

Response

{
  "jobId": "abc123",
  "status": "analyzing",   // queued | crawling | analyzing | scoring | completed | failed
  "progress": 65,
  "progressMessage": "Running CRO checks...",
  "reportSlug": null       // populated when completed
}
GET/api/v1/report/:slug

Retrieve the full audit report with all findings, scores, and recommendations.

Response (key fields)

{
  "url": "https://mystore.com",
  "overallScore": 62,
  "overallGrade": "C",
  "categoryScores": {
    "product_pages": { "score": 75, "grade": "B" },
    "checkout": { "score": 45, "grade": "D" },
    ...
  },
  "ruleResults": [ ... ],    // 277+ individual check results
  "aiFindings": [ ... ],     // AI-generated insights
  "quickWins": [ ... ],      // Top fixes by revenue impact
  "screenshots": { ... }     // Page screenshots (base64)
}
GET/api/v1/credits

Check your remaining audit credits.

Response

{
  "credits": 4,
  "email": "[email protected]"
}

Rate Limits

10/hrAudits per API key
100/minStatus poll requests
HeadersX-RateLimit-Remaining, X-RateLimit-Reset

MCP Server for AI Assistants

Connect AuditYourStore to Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools. Ask Claude to “audit mystore.com” and get full CRO results inside your conversation — no browser needed.

Setup

1

Generate an API key

Go to Dashboard → API Keys and create a new key.

2

Add MCP config

Claude Code: Add to ~/.claude/claude_desktop_config.json
Cursor: Add to .cursor/mcp.json in your project

{
  "mcpServers": {
    "audityourstore": {
      "command": "npx",
      "args": ["-y", "audityourstore-mcp"],
      "env": {
        "AUDITYOURSTORE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
3

Start using it

Restart your AI assistant and try one of the example prompts below.

Available Tools

audit_store1 credit

Run a full CRO audit on any eCommerce URL

get_audit_statusFree

Check progress of a running audit

get_reportFree

Retrieve full report with all findings and AI insights

check_creditsFree

See remaining audit credits

Example Prompts

“Audit https://mystore.com and tell me the top 5 things killing conversions”

“Run a CRO audit on competitor.com and compare their checkout flow to ours”

“Check how many audit credits I have left”

“Get the full report for my last audit and export findings as a CSV”

Audit Methodology

AuditYourStore evaluates your store across 277+ checkpoints in 7 categories. Each check is backed by UX research from the Baymard Institute, Nielsen Norman Group, and Google's Web Vitals guidelines.

Product Pages

50+

Image quality, descriptions, pricing clarity, reviews, CTAs, cross-sell placement, trust badges, mobile layout.

Sources: Baymard Institute product page UX guidelines

Checkout Flow

40+

Form fields, guest checkout, payment methods, address autocomplete, shipping calculator, progress indicator, error handling.

Sources: Baymard Institute checkout usability (70.19% cart abandonment)

Trust & Credibility

30+

SSL, security badges, return policy, contact info, review authenticity, social proof, guarantees, privacy policy.

Sources: Nielsen Norman Group trust signal research

Mobile Experience

35+

Tap targets (48x48px min), responsive design, viewport config, touch navigation, mobile menu, swipe gestures.

Sources: Google Mobile Usability, WCAG 2.1 AA

Page Performance

25+

Core Web Vitals (LCP < 2.5s, INP < 200ms, CLS < 0.1), image optimization, render-blocking, server response.

Sources: Google Core Web Vitals, HTTP Archive benchmarks

Navigation & Search

30+

Menu structure, breadcrumbs, category filters, site search, internal linking, 404 handling, URL structure.

Sources: Baymard Institute navigation UX, NNGroup information architecture

Email & Retention

20+

Email deliverability (SPF, DKIM, DMARC), blacklist checks, welcome emails, abandoned cart recovery, unsubscribe compliance.

Sources: RFC 7208 (SPF), RFC 7489 (DMARC), CAN-SPAM Act

How Scoring Works

Each checkpoint returns pass, fail, or uncertain with a weighted score. The overall score (0-100) maps to a letter grade:

A
90-100
B
75-89
C
60-74
D
40-59
F
0-39

Revenue impact estimates use your store's traffic data (when available via GA4 or CSV import) combined with industry conversion benchmarks to project monthly revenue loss per finding.

AI Vision Analysis

Beyond automated rule checks, AuditYourStore uses Claude's computer vision to analyze screenshots of your store pages. The AI identifies visual UX issues that rule-based checks can't catch: cluttered layouts, poor visual hierarchy, confusing navigation patterns, and missing design best practices.

Integrations

Google Analytics 4

Connect GA4 to enrich audits with real traffic and conversion data. Your GA4 data is used to calculate accurate revenue impact estimates.

Dashboard → Integrations

CSV Data Import

Upload revenue and traffic data from any analytics platform via CSV with columns for date, sessions, conversions, and revenue.

Dashboard → Data Import

Figma Export

Export findings directly to Figma. Each finding is placed as an annotation on the page screenshot for easy designer handoff.

Google Sheets

Export the full report to a structured spreadsheet with all findings, severity ratings, revenue impact estimates, and fix instructions.

Webhooks

Receive real-time POST callbacks when audits complete. Configure webhook URLs in your project settings.

eCommerce CRO Glossary

Key terms used in audit reports and CRO optimization.

Conversion Rate (CR)
Metric
Percentage of visitors who complete a desired action. Average eCommerce CR is 2.5-3.5%.
Cart Abandonment Rate
Metric
Percentage who add to cart but don't buy. Average is 70.19% (Baymard Institute).
Average Order Value (AOV)
Metric
Average revenue per transaction. Increased through cross-sells, upsells, bundles.
Core Web Vitals (CWV)
Technical
Google's page experience metrics: LCP (<2.5s), INP (<200ms), CLS (<0.1).
Above the Fold
UX
Content visible without scrolling. 80% of user attention is spent here.
Social Proof
UX
Reviews, ratings, testimonials, 'X people bought this', and user-generated content.
Trust Signals
UX
SSL, payment badges, return policies, contact info, reviews, guarantees.
Tap Target
Technical
Interactive mobile element. Google recommends minimum 48x48px with 8px spacing.
SPF
Email
DNS record specifying which servers can send email for your domain.
DKIM
Email
Email authentication that adds a digital signature verified via DNS.
DMARC
Email
Policy for emails failing SPF/DKIM: none, quarantine, or reject.
Revenue Impact Estimate
Metric
Projected monthly revenue change from fixing a specific issue.
Quick Wins
Strategy
High-impact, low-effort fixes prioritized by estimated revenue impact.
MCP
Technical
Model Context Protocol — open standard connecting AI assistants to external tools.

Ready to audit your store?

Start with a free 25-point audit — no credit card required.

Run Free AuditView Pricing