GitHub Actions

SEO checks in your GitHub Actions workflow.

Add Indxel to your GitHub Actions pipeline to validate SEO on every pull request. The indxel-ci GitHub Action runs checks automatically and blocks merges when critical SEO issues are found.

1.Add the GitHub Action

yaml

name: SEO Check
on: [push, pull_request]

jobs:
  seo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npx indxel check --ci

2.Or check a deployed URL

yaml

- name: SEO Check
  run: npx indxel crawl ${{ env.DEPLOY_URL }} --ci
  env:
    DEPLOY_URL: ${{ steps.deploy.outputs.url }}

Why use Indxel with GitHub Actions

✓Validate SEO on every push and pull request automatically
✓Block merges when critical metadata issues are detected
✓Compare SEO scores between commits with the --diff flag
✓Post SEO check results as PR comments for team visibility

Frequently asked questions

Can I run the check only on changed files?

Yes. Use npx indxel check --diff to validate only pages affected by the current commit. This gives faster feedback and focuses on what actually changed.

How do I post results as a PR comment?

Use the --json flag to get machine-readable output, then pipe it to a GitHub Actions step that posts a comment. The indxel-ci action handles this automatically.