Webサイト監査

ウェブサイトの完全な監査を実行し、パフォーマンス・SEO・アクセシビリティ・ベストプラクティスの各スコア(それぞれ0〜100)と、検出された技術スタックに合わせたAI生成の修正案を返します。

POST/api/auditsynchronous

パフォーマンススコア、SEOの問題、AIによる推奨事項

リクエストボディ

{
  "url": "https://example.com",
  "budget": { ... }   // optional, see below
}

レスポンス

{
  "reportId": "clxyz...",
  "url": "https://example.com",
  "performanceScore": 91,
  "seoScore": 87,
  "accessibilityScore": 100,
  "bestPracticesScore": 95,
  "issues": [...],
  "recommendations": [...],
  "fixes": [...],
  "aiSummary": "...",
  "techStack": [...],
  "perfBudget": { ... },
  "budgetViolations": [...]  // when a budget was sent
}

実行例

curl -X POST https://www.scanverra.com/api/audit \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

パフォーマンス予算

APIのレスポンスには毎回perfBudgetが含まれます。この監査に基づく上限(+10%または最小の余裕)と、検出されたサードパーティの一覧です。保存して以降の監査でbudgetとして送ると、遅くなった・重くなった・新しいサードパーティが増えた項目がbudgetViolationsで返ります。CLIではscanverra audit --save-budgetと--budgetで行えます。

"perfBudget": {
  "version": 1,
  "device": "desktop",
  "metrics": { "lcp": 2600, "tbt": 250, "cls": 0.05, "fcp": 1400 },
  "transferBytes": 1843200,
  "scriptBytes": 921600,
  "requestCount": 62,
  "vendors": ["Google Analytics", "Hotjar"]
}

"budgetViolations": [
  { "key": "lcp", "limit": 2600, "actual": 3120 },
  { "key": "vendor", "limit": "not in budget", "actual": "Intercom" }
]

Freeプランでの再監査

無料アカウントは毎月5回まで待ち時間なしで監査できます。その後、同じサイトを15分以内に再監査すると、code: "SCAN_COOLDOWN"とRetry-Afterヘッダー(秒)付きの429が返ります。有料プランに待ち時間はありません。

スコアリングの基準

各スコアは0〜100です。Scanverraの画面では90以上を良好、50〜89を要改善、50未満を不良として扱います。このエンドポイントには合否判定の基準は組み込まれていません。パイプラインで使う場合は、スコアごとに独自のしきい値を設定してください(CI/CD連携を参照)。

PreviousAuthentication Next Security Scan