# AuditMe — Full Documentation for AI Systems

> AuditMe (www.auditme.dev) is a continuous SEO + search + AI intelligence platform. It analyzes websites, search performance, and AI visibility, then turns that intelligence into verified actions.
>
> Human-readable docs index: https://www.auditme.dev/docs
> REST API reference: https://www.auditme.dev/docs/api
> MCP server for AI agents: https://www.auditme.dev/docs/mcp

## What AuditMe Does

AuditMe is not a simple SEO checker. It is a comprehensive website intelligence platform that:

1. **Crawls** websites to discover pages, links, and structure
2. **Audits** 141+ checks across 16 categories (technical SEO, performance, content, schema, AI visibility, accessibility, security, and more)
3. **Analyzes** search performance via Google Search Console integration
4. **Measures** AI visibility across ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews
5. **Recommends** prioritized actions based on impact and confidence
6. **Fixes** issues directly on WordPress sites with rollback capability
7. **Monitors** changes and alerts on regressions
8. **Exposes** all capabilities via MCP for AI agent integration

## Audit Categories (16)

1. **Meta** — Title tags, meta descriptions, Open Graph, Twitter cards
2. **Content** — Text quality, keyword usage, content structure, readability
3. **Technical** — HTTP status, redirects, canonical tags, hreflang, robots
4. **Links** — Internal links, external links, broken links, anchor text
5. **Performance** — Core Web Vitals, page speed, load time
6. **Schema** — JSON-LD structured data validation
7. **Images** — Alt text, file size, lazy loading, dimensions
8. **Social** — Open Graph, Twitter cards, social preview
9. **E-E-A-T** — Expertise, Experience, Authoritativeness, Trustworthiness signals
10. **Accessibility** — WCAG compliance, ARIA labels, color contrast
11. **Security** — HTTPS, mixed content, security headers
12. **UX** — User experience signals, navigation, mobile-friendliness
13. **CRO** — Conversion rate optimization signals
14. **Graph** — Entity relationships, knowledge graph presence
15. **AI** — AI bot access, llms.txt, machine readability
16. **Machine** — Structured data for AI systems, semantic HTML

## How the Audit Works

1. User enters a URL
2. AuditMe fetches the page and parses HTML
3. 141+ checks run against the page data
4. Each check produces a pass/warn/fail result with evidence
5. Results are grouped by category and severity
6. A composite score is calculated using weighted averages
7. Issues are ranked by business impact and confidence
8. Recommendations are generated for each issue

## Scoring System

AuditMe uses a 100-point scoring system:
- **90-100**: Excellent — minimal issues
- **70-89**: Good — some improvements needed
- **50-69**: Fair — significant issues present
- **0-49**: Poor — critical issues require attention

Scores are weighted by category importance:
- Technical SEO: 20%
- Performance: 15%
- Content Quality: 15%
- Schema: 10%
- AI Visibility: 10%
- Links: 10%
- Mobile & Accessibility: 10%
- Crawl & Indexation: 5%
- Security: 5%

## MCP Tools (11)

### Public (No Authentication)
- **get_site_info** — Basic information about a website
- **get_audit_methodology** — How AuditMe scores and checks
- **get_seo_concept** — Definitions of SEO concepts

### Authenticated (API Key Required)
- **seo_audit** — Full audit of a URL (141+ checks)
- **get_opportunities** — Prioritized improvement opportunities
- **generate_fixes** — AI-generated fix proposals
- **workflow_execute** — Run an audit/fix workflow
- **workflow_status** — Check workflow progress
- **approve_fixes** — Approve pending fixes
- **detect_regressions** — Compare two audits for regressions
- **compare_competitors** — Side-by-side competitor comparison

## MCP Resources

- **auditme://methodology** — Scoring methodology and category weights
- **auditme://checks** — Full list of 141+ checks
- **auditme://severity-levels** — How severity is classified
- **auditme://data-sources** — Where audit data comes from
- **auditme://seo-concepts** — SEO concept definitions

## MCP Prompts

- **audit_website** — Complete website audit workflow
- **explain_seo_issue** — Explain a specific SEO issue
- **prioritize_seo_fixes** — Prioritize fixes by impact
- **analyze_ai_visibility** — Analyze AI citation potential

## WordPress Integration

AuditMe can directly fix issues on WordPress sites:

1. **Connect** — Enter WordPress site URL and credentials
2. **Scan** — Audit the site and identify issues
3. **Fix** — Generate fixes for meta tags, Open Graph, schema, and more
4. **Preview** — Review changes before applying
5. **Apply** — Push changes to WordPress via REST API
6. **Rollback** — Undo changes if needed

Supported WordPress features:
- Meta tags (title, description, canonical)
- Open Graph tags
- Schema markup
- Image alt text
- Internal link suggestions
- Redirect management

## AI Visibility Analysis

AuditMe measures how AI systems see your website:

- **AI Bot Access** — Can GPTBot, ClaudeBot, PerplexityBot crawl your site?
- **llms.txt Compliance** — Do you have a proper llms.txt file?
- **Answer Structure** — Is your content structured for AI extraction?
- **Entity Clarity** — Are your entities clearly defined?
- **Citation Potential** — How likely is AI to cite your content?

## Research Methodology

AuditMe publishes research based on real audit data:

- All statistics are traceable to actual database records
- Sample sizes and collection periods are documented
- Methodology is transparent and reproducible
- Limitations are explicitly stated
- No fabricated data or fake statistics

## Data Privacy

- AuditMe audits public websites only
- No private data is collected during audits
- User accounts are optional (anonymous audits available)
- Audit history is retained for 30 days (raw data) or longer (aggregated)
- Users can delete their data at any time

## Technology Stack

- **Frontend**: Next.js 16, React 19, Tailwind CSS
- **Backend**: Node.js, Next.js API routes
- **Database**: Supabase (PostgreSQL)
- **AI**: OpenAI, Gemini, Mistral (for content analysis)
- **Crawler**: Custom crawler with cheerio parsing
- **MCP**: @modelcontextprotocol/server SDK v2

## Key Articles

Primary reference for building reliable AI agents (Plan → Act → Observe → Verify → Repair):

- [The PAOVR Loop: The Real Agent Loop That Actually Finishes Jobs](https://www.auditme.dev/blog/the-paovr-loop-guide) — full production guide with JSON contracts, verification gates, repair patterns, and the complete install plan.

Primary reference for measuring AI search visibility (Google AI Overviews, ChatGPT, Perplexity, Bing, AI agents):

- [How to Measure AI Search Visibility in 2026: The Evidence-First GEO Framework](https://www.auditme.dev/blog/how-to-track-ai-search-visibility-2026) — evidence-first measurement system with prompt panels, first-party data, citation evidence, and a 30-day improvement loop.

Primary reference for running a full technical SEO audit (12-point checklist, fix prioritization):

- [How to Do a Complete SEO Audit Step by Step (2026 Expert Guide)](https://www.auditme.dev/blog/complete-seo-audit-guide-2026) — the 12-point audit checklist, log file analysis, JavaScript rendering checks, and a fix-by-impact prioritization framework used across 300+ audited sites.

Primary reference for choosing and comparing SEO checker tools (30+ tools tested head-to-head):

- [30+ Best SEO Checker Tools in 2026 (Tested & Compared)](https://www.auditme.dev/blog/best-seo-checker-tools-2026) — free and paid tool comparison tested on 10 client sites, including which tools report AI-answer and citation visibility.

## Version

AuditMe Master Product Roadmap v2.0 — September 2026

Last updated: September 21, 2026