{"_id":"@a1local/adpages-gbp-link-checker","name":"@a1local/adpages-gbp-link-checker","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@a1local/adpages-gbp-link-checker","version":"0.1.0","type":"module","description":"Dependency-free local CLI for checking Google Business Profile link hygiene without scraping Google or calling remote APIs.","bin":{"adpages-gbp-link-checker":"bin/adpages-gbp-link-checker.mjs"},"exports":{".":"./src/index.mjs"},"scripts":{"check":"node scripts/check.mjs","smoke":"node scripts/smoke.mjs","sample":"node bin/adpages-gbp-link-checker.mjs examples/sample-links.json --pretty"},"keywords":["google-business-profile","gbp","local-seo","link-checker","utm","agency","adpages"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/a1local/adpages-gbp-link-checker.git"},"homepage":"https://github.com/a1local/adpages-gbp-link-checker#readme","bugs":{"url":"https://github.com/a1local/adpages-gbp-link-checker/issues"},"funding":{"type":"custom","url":"https://a1local.com.au/extensions/"},"publishConfig":{"access":"public"},"gitHead":"0051b08e303680b1f851a3980ab4207b2b954405","_id":"@a1local/adpages-gbp-link-checker@0.1.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-63Pwaqk/CogJikQ+4sc5z+F/G+mOgpnDOa45xJKZfb6y1cc2v7LQKf4NZ2dvKiEziE+kQOIk+rmR0rQlpdJRnQ==","shasum":"8d8d88cde690fa3f140f557b65fe29d721764c0f","tarball":"https://registry.npmjs.org/@a1local/adpages-gbp-link-checker/-/adpages-gbp-link-checker-0.1.0.tgz","fileCount":11,"unpackedSize":52783,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHz8kjdHJ64hcOvA81D6F5U4I4Wec0ATeJGlJ+FI1keNAiEA9di2dw3hPn+VEccEFd/Ao2CI/8rmWYqgGYp+NyOrvWg="}]},"_npmUser":{"name":"a1local","email":"extensions@a1local.com.au"},"directories":{},"maintainers":[{"name":"a1local","email":"extensions@a1local.com.au"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adpages-gbp-link-checker_0.1.0_1779692706940_0.778140805241287"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T07:05:06.829Z","0.1.0":"2026-05-25T07:05:07.097Z","modified":"2026-05-25T07:05:07.266Z"},"maintainers":[{"name":"a1local","email":"extensions@a1local.com.au"}],"description":"Dependency-free local CLI for checking Google Business Profile link hygiene without scraping Google or calling remote APIs.","homepage":"https://github.com/a1local/adpages-gbp-link-checker#readme","keywords":["google-business-profile","gbp","local-seo","link-checker","utm","agency","adpages"],"repository":{"type":"git","url":"git+https://github.com/a1local/adpages-gbp-link-checker.git"},"bugs":{"url":"https://github.com/a1local/adpages-gbp-link-checker/issues"},"license":"MIT","readme":"# AdPages GBP Link Checker\n\nDependency-free local CLI for checking Google Business Profile and local listing link hygiene before agencies publish, report, or hand off a small business website.\n\n## Publishing Position\n\nFree 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.\n\nThe checker is intentionally conservative. It reads a local JSON file, parses candidate links, and flags patterns that usually create launch or measurement problems:\n\n- Missing HTTPS or unsupported protocols.\n- Unsupported hosts for action links, including social, messaging, app-store, bio-link, and shortener domains.\n- Likely UTM tracking gaps on website and appointment URLs.\n- Mixed destination domains across website and appointment links.\n- Suspicious shorteners that hide the final destination.\n- Review-link caution for policy-safe review requests.\n- Phone mismatches when business metadata includes a primary number.\n\nIt 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.\n\n## Install Locally\n\n```sh\nnpm install\nnpm run check\nnpm run smoke\n```\n\nThere are no runtime dependencies.\n\n## Usage\n\n```sh\nnode bin/adpages-gbp-link-checker.mjs examples/sample-links.json --pretty\nnode bin/adpages-gbp-link-checker.mjs examples/sample-links.json --format text\nnode bin/adpages-gbp-link-checker.mjs links.json --website-domain example.com.au --phone \"+61 8 5550 1000\"\n```\n\nInput can be an object with business metadata and links:\n\n```json\n{\n  \"business\": {\n    \"name\": \"Perth Demo Dental\",\n    \"websiteDomain\": \"perthdemodental.com.au\",\n    \"phone\": \"+61 8 5550 1000\",\n    \"allowedProviderDomains\": [\"cliniko.com\"]\n  },\n  \"links\": [\n    {\n      \"type\": \"website\",\n      \"label\": \"GBP website button\",\n      \"url\": \"https://www.perthdemodental.com.au/?utm_source=google&utm_medium=organic&utm_campaign=gbp\"\n    }\n  ]\n}\n```\n\nOr an array of link objects. Supported link types are `website`, `appointment`, `call`, `directions`, and `review`. Unknown types are inferred from labels and URLs.\n\n## Output\n\nJSON is the default output. Use `--format text` for a concise terminal summary.\n\nThe report includes:\n\n- Normalized business metadata.\n- Per-link status, destination host, base domain, tracking details, and issue list.\n- Summary counts for errors, warnings, cautions, and ready/review/fix status.\n- Recommendations suitable for agency QA notes.\n\n## Conservative Rules\n\nWebsite 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`.\n\nCall 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.\n\nGoogle'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.\n\n## Publish Blockers\n\nSee [PUBLISH_BLOCKERS.md](PUBLISH_BLOCKERS.md). The package is intentionally `private` until ownership, support, package naming, and public examples are finalized.\n\n## Non-Goals\n\n- No live status checks.\n- No Google scraping.\n- No Google Business Profile API calls.\n- No redirect resolution.\n- No automated outreach.\n- No claim that a link is approved by Google.\n\n## Publisher\n\nBuilt by [AdPages from A1 Local](https://a1local.com.au/extensions/) as a free, dependency-light tool for local-service marketers, agencies, and small business site owners.\n","readmeFilename":"README.md","_rev":"1-8ce645921a55db24b877d8084f87c1ca"}