@a1local/adpages-audit-core

Shared local-first checks for lightweight AdPages tools.

This package is the neutral engine that future wrappers can publish to:

• browser extensions
• npm packages
• CLI tools
• GitHub Actions
• Astro integrations
• VS Code extensions
• WordPress plugins
• Google Sheets add-ons
• n8n nodes
• MCP servers

The first release focuses on paid-traffic landing page readiness, UTM helpers, LocalBusiness schema generation, and Google Ads copy validation.

Principles

• Keep checks deterministic and explainable.
• Separate page capture from rule evaluation.
• Do not fetch remote pages unless a wrapper explicitly owns that behavior.
• Do not collect or transmit user data.
• Keep every wrapper single-purpose for marketplace review.

Basic Usage

import {
  auditLandingPageSnapshot,
  capturePageAuditSnapshot,
  renderAuditMarkdown
} from "@a1local/adpages-audit-core";

const snapshot = capturePageAuditSnapshot(document, window.location);
const audit = auditLandingPageSnapshot(snapshot);
const markdown = renderAuditMarkdown(audit);

Wrapper Targets

Wrapper	First useful product	Marketplace
Browser extension	AdPages Landing Page QA Scanner	Chrome, Edge, Firefox
CLI	adpages audit <url>	npm, GitHub, Homebrew later
GitHub Action	Preview URL landing page gate	GitHub Marketplace
Astro integration	metadata/schema/CTA validation	npm, Astro ecosystem
VS Code extension	schema, UTM, ads-copy helper	VS Code Marketplace, Open VSX
WordPress plugin	UTM capture plus page checklist	WordPress.org
Sheets add-on	UTM builder and copy checker	Google Workspace Marketplace
n8n node	audit URL, generate UTM, validate copy	npm, n8n community
MCP server	agent-callable audit and generators	GitHub, MCP directories

Package Scope

This package does not include store-specific copy, payment logic, remote crawling, analytics, or license verification. Those belong in wrappers.