miralamin/wcp-ai-audit repository overview

⁠🚀 WebCare Pro • AI & GEO Readiness Audit Tool

⁠Enterprise Diagnostic Engine for Technical SEO, Core Web Vitals, AI Crawlers & Model Context Protocol (MCP)

Self-Hosted · 42+ Technical Checkpoints · Embedded Nginx Reverse Proxy · Local JSON Database · Zero Vendor Lock-In

A complete, self-hosted web application and automated diagnostic engine for evaluating websites across AI Search Engines (ChatGPT Search, Perplexity, Claude, Google Gemini/SGE), Generative Engine Optimization (GEO), Model Context Protocol (MCP), and Google Core Web Standards.

Powered by Next.js 16 (App Router with Turbopack) running securely on Ubuntu 26.04.1 LTS with an embedded Nginx Reverse Proxy delivering high-speed gzip compression, static chunk caching, and deep crawler proxy buffering.

⁠✨ Key Features & Audit Capabilities

⁠🔍 1. Deep AI & Search Engine Evaluation (42+ Rules)

• 12+ AI Crawlers Audited: Evaluates real-time crawl permissions for GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot, Google-Extended, Applebot, Bytespider, Amazonbot, and more.
• Generative Engine Optimization (GEO): Analyzes unstructured LLM readiness, llms.txt, /llms-full.txt, semantic markdown structure, and AI discovery protocols.
• Model Context Protocol (MCP): Detects MCP server descriptors (mcp.json, ai-plugin.json) and agent discoverability.
• Technical SEO & Structured Data: Validates Schema.org JSON-LD (Organization, WebSite, FAQPage, BreadcrumbList), canonical tags, robots headers, and OpenGraph/Twitter social cards.
• Google Standards & Core Web Vitals: Integrated PageSpeed Insights analysis checking LCP, INP, CLS, TTFB, and responsive viewport geometry.

⁠📊 2. Competitive Site Comparison (/compare)

• Direct side-by-side benchmark comparing two domains across all 5 technical scoring categories.
• Real-time delta score indicators with granular checkpoint breakdowns.

⁠📄 3. Enterprise PDF Report Generation

• Native PDF rendering using PDFKit with branded headers, category scorecards, visual badges, and complete technical findings.
• One-click print-to-PDF layout with dedicated executive print stylesheets.

⁠🛡️ 4. Turnkey Production Stack

• Embedded Nginx Reverse Proxy: Pre-configured for port 80, handling client request buffering, gzip compression, and caching for Next.js static assets (/_next/static/*).
• No External Database Required: Uses a high-speed local filesystem JSON storage system with automated directory initialization.
• Fast Domain Scans: Direct scan execution with optional benchmark leaderboard indexing.

⁠⚡ Quick Start

⁠Option A: Run via Docker CLI (Recommended)

Run the container exposing port 80 with persistent storage:

docker run -d \
  --name ai-audit-tool \
  -p 80:80 \
  -v ai_audit_data:/app/data \
  --restart unless-stopped \
  miralamin/wcp-ai-audit:latest

Open your browser at:

• http://localhost (or http://your-server-ip)

⁠Option B: Run with Docker Compose

Create a docker-compose.yml file:

services:
  ai-audit:
    image: miralamin/wcp-ai-audit:latest
    container_name: wcp-ai-audit
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./data:/app/data
      - ./scans:/app/public/assets/scan
    environment:
      - NODE_ENV=production
      - PORT=3000
      - HOSTNAME=127.0.0.1

Start the service:

docker compose up -d

View real-time logs:

docker compose logs -f

⁠⚙️ Persistent Data & Volume Mounts

⁠🛠️ WebCare Pro Infrastructure Services

WebCare Pro provides elite, direct 1-on-1 Linux server engineering, performance optimization, and infrastructure management by Mir Alamin without agency overhead or middlemen.

👉 Explore All 12+ Professional Services⁠

⁠👨‍💻 About WebCare Pro & Mir Alamin

WebCare Pro is founded and operated by Mir Alamin, a senior Linux systems administrator and web infrastructure engineer with 10+ years of hands-on experience.

• 🏆 Upwork Top-Rated Freelancer: Rated 4.9 / 5.0 across 528+ verified client reviews.
• 📜 40+ Verified Professional Certifications & Skill Badges (View Credly Profile⁠).
• 🚀 680+ Completed Web Infrastructure & Optimization Projects.
• 🌍 100% Remote Global Operations: Worldwide direct technical support without agency bureaucracy.

⁠🔗 Connect & Direct Channels