Website Grade Audit Action

Automatically audit your website's SEO, security headers, and performance on every deploy. Get a score card in your GitHub Actions summary.

Usage

- name: Audit website
  uses: aitaskorchestra/webgrade-action@v1
  with:
    url: https://your-site.com
    threshold: 70  # Fail if score drops below 70

Example workflow

name: Deploy & Audit
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      # ... your deploy steps ...

      - name: Audit deployed site
        uses: aitaskorchestra/webgrade-action@v1
        id: audit
        with:
          url: https://your-site.com
          threshold: 60

      - name: Comment on PR
        if: github.event_name == 'pull_request'
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## Website Audit\nScore: **${{ steps.audit.outputs.overall }}**/100\n[Full Report](${{ steps.audit.outputs.report-url }})`
            })

Inputs

Input	Required	Default	Description
url	Yes	-	URL to audit
threshold	No	0	Minimum score (fails if below)
categories	No	meta,security,performance	Which checks to run

Outputs

Output	Description
overall	Overall score (0-100)
meta	SEO & meta tags score
security	Security headers score
performance	Performance score
issues	JSON array of issues
report-url	Link to visual report

What it checks

SEO & Meta Tags - Title, description, Open Graph, Twitter cards, canonical URLs, structured data, favicons

Security Headers - HTTPS, HSTS, CSP, X-Content-Type-Options, X-Frame-Options, Referrer-Policy

Performance - Compression, caching headers, CDN detection

Powered by

GrabShot - Free developer tools for screenshots, PDFs, and website analysis.