AdPages Docker Audit Runner

Docker distribution surface for the local AdPages audit helpers. It gives people a copy-paste way to run lightweight landing-page QA, UTM URL generation, LocalBusiness JSON-LD generation, and Google Ads copy length checks without installing the monorepo locally.

The default runner does not fetch URLs, execute JavaScript, launch a browser, set cookies, or call analytics endpoints. Static HTML audits read a mounted file and inspect it locally.

Build

From the standalone repository:

docker build -t adpages-audit-runner:local .

From this monorepo checkout:

docker build -f integrations/docker/adpages-audit-runner/Dockerfile -t adpages-audit-runner:local integrations/docker/adpages-audit-runner

After the GHCR workflow has published the image, users can also pull it directly:

docker pull ghcr.io/a1local/adpages-docker-audit-runner:0.1.0

Audit Static HTML

docker run --rm \
  -v "$PWD:/work" \
  adpages-audit-runner:local audit-html /work/index.html \
  --url "https://example.com/services/?utm_source=google&utm_medium=cpc&utm_campaign=local_service" \
  --format markdown

Write a report back to the mounted folder:

docker run --rm \
  -v "$PWD:/work" \
  adpages-audit-runner:local audit-html /work/index.html \
  --out /work/adpages-report.md \
  --fail-on never

Formats:

• markdown for a shareable QA report.
• text for a short terminal summary.
• json for CI or another tool to parse.

Exit behavior:

• --fail-on fail exits non-zero when failed audit checks exist. This is the default.
• --fail-on warn exits non-zero when failed or warning checks exist.
• --fail-on never always exits zero unless the command itself errors.

Utility Commands

docker run --rm adpages-audit-runner:local utm \
  --url https://example.com/ \
  --source google \
  --medium cpc \
  --campaign emergency_plumbing

docker run --rm adpages-audit-runner:local ads-check \
  --headline "Emergency Plumber" \
  --description "Book a local plumber today"

docker run --rm adpages-audit-runner:local schema \
  --name "Example Plumbing" \
  --url https://example.com/ \
  --phone "08 9000 0000" \
  --area Perth \
  --area Fremantle

Example Script

sh integrations/docker/adpages-audit-runner/examples/run-static-html.sh

The example script builds the image and audits examples/sample-landing-page.html using a read-only mount.

Publish Readiness Notes

• The image installs the published @a1local/adpages-audit-core and @a1local/adpages-browser-capture packages from npm so the public repository can build as a standalone Docker context.
• There are no Playwright, Puppeteer, Chrome, or browser dependencies in this surface.
• Future rendered-page auditing can be a separate image tag, for example adpages-audit-runner:browser, so the default image stays small and deterministic.
• The GitHub Actions workflow publishes ghcr.io/a1local/adpages-docker-audit-runner on release or manual dispatch.