Deploy-aware SEO checks

An SEO regression check for your GitHub Actions deploys

Add one step after your deploy. SEO Change Guard checks your priority pages straight away, and if the release broke something, the alert names the commit.

Start free See pricing

SEO Change Guard

Add the step

  1. In SEO Change Guard, open Deploy hooks, choose your site and create a deploy token. It is shown once.
  2. Store it in your repository as a secret named SCG_DEPLOY_TOKEN.
  3. Add this step after your deploy step.
- name: SEO Change Guard deploy check
  if: always()
  continue-on-error: true
  env:
    SCG_DEPLOY_TOKEN: ${{ secrets.SCG_DEPLOY_TOKEN }}
  run: |
    curl --silent --show-error --max-time 20 -X POST https://seoguard.atbisoftware.com/api/deploy-events \
      -H "X-Scg-Deploy-Token: $SCG_DEPLOY_TOKEN" -H "Content-Type: application/json" \
      -d "{\"sha\":\"$GITHUB_SHA\",\"repo\":\"$GITHUB_REPOSITORY\",\"ref\":\"$GITHUB_REF_NAME\",\"environment\":\"production\",\"waitSeconds\":60}"

waitSeconds gives a CDN or cache time to catch up before the check runs, from 0 to 600 seconds. The continue-on-error line means a problem with this step never fails your deploy. It works the same from any other CI system that can send an HTTPS request.

A Critical SEO Change Guard incident found by the check after a deploy, naming the commit, repository, branch and environment.
Example from a test site.

What happens next

  • The check covers your site’s priority pages, robots.txt and sitemap, compared with the baseline you approved.
  • A change found after a deploy alerts at once, because the deploy explains it.
  • The incident shows the commit SHA, repository, environment and time, with the value before and after for each page.
  • When you fix it, you get a recovery notice and the incident closes.

What the token can do

One thing: report a release of its own site, which asks for a check and records the commit details it sends. It can’t read anything, change the site or reach another site. We store only a hash of it, and you can replace or revoke it at any time. At most 10 events per site are accepted in 10 minutes.

Add it to your next release

The deploy hook is on every plan, including Free: 1 site and 10 priority pages, with no card needed.

Start free

Frequently asked questions

What does the step send?

The commit SHA, repository, branch and environment. It sends no code and no other repository data.

Does it replace my tests?

No. It runs after the release, against the live site, and checks what your server really returns.