Documentation

GitHub Action

Run an audit in your build pipeline and check a deployed page against a threshold.

Jeff Patterson / Agency Enterprise. Updated August 30, 2026.

GitHub Action

Set comment-on-pr to true to keep one pull-request comment with the score, grade, stages, and top recommendations.

name: AI SEO Audit
on: pull_request

jobs:
  audit:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: agencyenterprise/aiseo-audit@v2
        with:
          url: https://your-preview-url.example
          fail-under: 70
          comment-on-pr: true

One-line quality gate

npx aiseo-audit https://your-preview-url.example --fail-under 70

Establish a baseline first

Audit representative pages with the same queries and profiles before blocking a release. Version 2 scores cannot be compared with version 1 scores. Set new thresholds when moving the action from @v1 to @v2.