Back to docs

Tool AI Benchmark

Compare AI-friendliness scores across competitor sites. See where you win, where you lose, and what to fix first.

Quick Start

npx cbrowser ai-benchmark --urls \
  "https://you.com,https://rival.com"

CLI Options

Option Description
--urls <list> Comma-separated URLs to benchmark (required)
--concurrency <n> Sites audited at once (default: 3)
--device <name> Device every audit runs on, e.g. iphone-16
--output <file> Save the JSON report
--html Write an HTML report

--viewport and --browser exit 1 with the reason. A site that cannot be scored makes the command exit 1, so CI notices. Before 20.0 --device was accepted and dropped.

MCP Tool

{
  "tool": "ai_benchmark",
  "params": {
    "urls": [
      "https://yoursite.com",
      "https://competitor1.com",
      "https://competitor2.com"
    ],
    "goal": "complete checkout"
  }
}

goal is optional context.

Output Format

Field What it holds
sitesAnalyzed, sitesSucceeded, sitesFailed How many audits ran and finished
ranking Per site: rank, site, grade, score, auditStatus
comparison bestOverall, bestFindability, bestStability, bestAgentPerceivability, bestSemantics, commonIssues
siteAdvantages What each site does better than the others
topRecommendations Up to 10: site, priority, improvement, competitorReference
detailedResults Per site: grade, score, strengths, weaknesses, topIssues, and failure details when an audit failed

Use Cases

E-commerce

Compare checkout flows, product pages, and cart accessibility across retailers.

npx cbrowser ai-benchmark --urls \
  "https://a.shop,https://b.shop"

SaaS

Benchmark onboarding flows, dashboard navigation, and API docs.

npx cbrowser ai-benchmark --urls \
  "https://a.app,https://b.app"

Documentation

Compare search, navigation, and content structure for dev docs.

npx cbrowser ai-benchmark --urls \
  "https://a.dev,https://b.dev"

Scoring Comparison

Head-to-head comparisons:

Metric You Best Competitor Gap
Overall 84 92 -8
Findability 91 95 -4
Stability 78 88 -10
Agent perceivability 85 93 -8
Semantics 72 91 -19

Advantage/Gap Analysis

The tool identifies:

  • Your advantages: where you score higher
  • Competitor advantages: where competitors beat you
  • Quick wins: low-effort changes with high impact
  • Strategic gaps: areas needing major investment

Integration with CI/CD

Add competitive monitoring to your pipeline.

# .github/workflows/ai-benchmark.yml
name: AI Benchmark
on:
  schedule:
    # Weekly on Monday
    - cron: '0 0 * * 1'

jobs:
  benchmark:
    runs-on: ubuntu-latest
    steps:
      - name: Run AI Benchmark
        run: |
          npx cbrowser ai-benchmark \
          --urls "${{ vars.URLS }}" \
          --output benchmark.json

      - name: Upload Report
        uses:
          actions/upload-artifact@v4
        with:
          name: ai-benchmark-report
          path: benchmark.json

Copyright: (c) 2026 Alexa Eden.

License: MIT License

From the Blog