AdPages GBP Link Checker

Dependency-free local CLI for checking Google Business Profile and local listing link hygiene before agencies publish, report, or hand off a small business website.

Publishing Position

Free tool for agencies, local marketers, web designers, and SEO teams who need a no-login way to review GBP website, appointment, call, directions, and review links. It is designed as a linkable resource for local SEO checklists, web-design launch resources, and replacement-tool outreach.

The checker is intentionally conservative. It reads a local JSON file, parses candidate links, and flags patterns that usually create launch or measurement problems:

• Missing HTTPS or unsupported protocols.
• Unsupported hosts for action links, including social, messaging, app-store, bio-link, and shortener domains.
• Likely UTM tracking gaps on website and appointment URLs.
• Mixed destination domains across website and appointment links.
• Suspicious shorteners that hide the final destination.
• Review-link caution for policy-safe review requests.
• Phone mismatches when business metadata includes a primary number.

It does not scrape Google, call Google APIs, resolve redirects, contact destination sites, or verify live HTTP status. That keeps it safe for browserless QA, agency handoff, and offline audits.

Install Locally

npm install
npm run check
npm run smoke

There are no runtime dependencies.

Usage

node bin/adpages-gbp-link-checker.mjs examples/sample-links.json --pretty
node bin/adpages-gbp-link-checker.mjs examples/sample-links.json --format text
node bin/adpages-gbp-link-checker.mjs links.json --website-domain example.com.au --phone "+61 8 5550 1000"

Input can be an object with business metadata and links:

{
  "business": {
    "name": "Perth Demo Dental",
    "websiteDomain": "perthdemodental.com.au",
    "phone": "+61 8 5550 1000",
    "allowedProviderDomains": ["cliniko.com"]
  },
  "links": [
    {
      "type": "website",
      "label": "GBP website button",
      "url": "https://www.perthdemodental.com.au/?utm_source=google&utm_medium=organic&utm_campaign=gbp"
    }
  ]
}

Or an array of link objects. Supported link types are website, appointment, call, directions, and review. Unknown types are inferred from labels and URLs.

Output

JSON is the default output. Use --format text for a concise terminal summary.

The report includes:

• Normalized business metadata.
• Per-link status, destination host, base domain, tracking details, and issue list.
• Summary counts for errors, warnings, cautions, and ready/review/fix status.
• Recommendations suitable for agency QA notes.

Conservative Rules

Website and appointment links are expected to use HTTPS and a complete UTM set (utm_source, utm_medium, utm_campaign) unless a click-id is present. Appointment links can use a third-party provider domain when the domain is included in allowedProviderDomains.

Call links are expected to use tel:. Directions links are expected to look like Google Maps directions URLs. Review links are expected to come from recognized Google review hosts, but the checker still adds a Review-link caution because requests must remain neutral and based on genuine customer experiences.

Google's public Business Profile docs describe local business links for actions like booking appointments and note that business links must be direct action pages rather than social, messaging, app-store, or shortener links. Google also documents that review links and QR codes can be shared, but review requests must not include incentives.

Publish Blockers

See PUBLISH_BLOCKERS.md. The package is intentionally private until ownership, support, package naming, and public examples are finalized.

Non-Goals

• No live status checks.
• No Google scraping.
• No Google Business Profile API calls.
• No redirect resolution.
• No automated outreach.
• No claim that a link is approved by Google.

Publisher

Built by AdPages from A1 Local as a free, dependency-light tool for local-service marketers, agencies, and small business site owners.