@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.