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: trueOne-line quality gate
npx aiseo-audit https://your-preview-url.example --fail-under 70Establish 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.