@a1local/adpages-cli

First npm CLI wrapper for the AdPages publishing expansion.

This package is intentionally small: it makes no network calls and delegates deterministic helper logic to @a1local/adpages-audit-core.

Local Usage

Install from npm:

npm install -g @a1local/adpages-cli

Or run the local checkout:

node ./bin/adpages.mjs help

Generate a tagged campaign URL:

node ./bin/adpages.mjs utm \
  --url "https://example.com/landing" \
  --source google \
  --medium cpc \
  --campaign emergency-plumbing

Check Google Ads copy length and basic policy-risk signals:

node ./bin/adpages.mjs ads-check \
  --headline "Emergency Plumber Perth" \
  --headline "Same Day Repairs" \
  --headline "Call Now" \
  --description "Fast local plumbing help with clear pricing and same day booking."

Generate LocalBusiness JSON-LD:

node ./bin/adpages.mjs schema \
  --name "Example Plumbing" \
  --url "https://example.com" \
  --phone "08 0000 0000" \
  --area Perth \
  --area Fremantle

Commands

adpages utm --url <url> --source <source> --medium <medium> --campaign <campaign> [--term <term>] [--content <content>]
adpages ads-check --headline <text> [--headline <text>] --description <text> [--description <text>]
adpages schema --name <business name> [--url <url>] [--phone <phone>] [--area <area>]
adpages help

npm Publishing Path

This package is published after @a1local/adpages-audit-core because it imports the shared deterministic helper engine at runtime.

Before a release, run:

npm run smoke
npm pack --dry-run

Future Monetisation Hooks

The CLI currently does not include payments, account state, telemetry, remote audits, or license verification.

Possible future hooks:

• optional license-token check before premium commands
• usage-metered remote page audits
• paid report export formats
• hosted campaign naming policies
• team presets for UTM conventions and schema defaults

Those hooks should stay outside the deterministic local helpers until there is a clear product boundary.