GitLab CI

SEO validation in your GitLab CI pipeline.

Add Indxel to your .gitlab-ci.yml to validate SEO on every push and merge request. The check runs after your build, blocks merges when critical issues are found, and reports results inline.

1.Add to .gitlab-ci.yml

yaml
stages:
  - build
  - seo

build:
  stage: build
  image: node:20
  script:
    - npm ci
    - npm run build
  artifacts:
    paths:
      - .next/

seo-check:
  stage: seo
  image: node:20
  script:
    - npx indxel check --ci
  dependencies:
    - build

2.Or crawl a deployed environment

yaml
seo-crawl:
  stage: seo
  image: node:20
  script:
    - npx indxel crawl $CI_ENVIRONMENT_URL --ci
  environment:
    name: staging
    url: https://staging.example.com

Why use Indxel with GitLab CI

  • Gate merge requests on SEO validation in your GitLab pipeline
  • Run checks after build with zero additional configuration
  • Crawl deployed staging environments to catch runtime SEO issues
  • Track SEO scores across branches with pipeline artifacts

Frequently asked questions

Can I use Indxel with GitLab CI/CD?

Yes. Add a seo-check job to your .gitlab-ci.yml that runs npx indxel check --ci after the build stage. The check uses the build artifacts and exits with code 1 on failures.

Does it work with GitLab review environments?

Yes. Use the crawl mode to validate a deployed review environment URL. Pass the CI_ENVIRONMENT_URL variable to npx indxel crawl for live validation.