Lead Magnet Form Inventory

Inventory public lead-magnet forms, newsletter forms, gated content CTAs, form fields, consent copy, thank-you/download links, and placement context.

What it does

Renders public pages and inventories lead forms, fields, requirements, CTAs, consent text, privacy links, gated assets, placement, and friction issues.

The actor emits one row per public lead form, or a no-form diagnostic. Dataset and report output is produced only after every applicable PPE charge is accepted.

Common uses

• Inventory lead magnet forms
• Audit newsletter signup fields
• Find missing privacy links on forms
• Export gated content CTA inventory
• Review lead capture friction

Input

Supply public HTTP(S) URLs or deterministic htmlInputs. URL fetching rejects localhost and private-network destinations; allowedDomains can narrow access further.

• startUrls
• sitemapUrls
• htmlInputs
• allowedDomains
• maxPages
• maxDepth
• includeEvidence
• includeRawSnapshots
• requestDelayMs
• timeoutMs
• userAgentMode
• pageUrls
• followInternalLeadLinks
• formSelectors
• ctaTerms
• includeHiddenFields
• maxFormsPerPage
• maxForms
• maxBrowserPages
• viewportWidth
• viewportHeight
• maxChargeUsd
• includeReport

The caps in maxPages, maxForms, maxBrowserPages, maxScreenshots, timeoutMs and maxChargeUsd are enforced. A zero charge cap is a hard zero budget.

Output

• sourceUrl
• sourceType
• pageTitle
• recordType
• recordName
• issueCode
• severity
• evidenceSnippet
• recommendation
• canonicalUrl
• httpStatus
• scannedAt
• pageUrl
• formId
• formType
• ctaText
• leadMagnetTitle
• fieldNames
• requiredFieldCount
• consentText
• privacyLinkUrl
• thankYouOrDownloadSignal
• placementContext

Reports:

• lead-magnet-form-inventory-summary-report.md
• lead-magnet-form-inventory-records.csv
• lead-magnet-form-inventory-issues.json
• lead-magnet-form-inventory-evidence-samples.json
• lead-magnet-form-inventory-run-metadata.json

Pricing

Platform-usage pass-through is off. Locked fixed-inclusive events:

Event	Price
actor-start	$0.08
browser-page-checked	$0.0275
form-record-extracted	$0.0095
form-issue-detected	$0.0195
report-generated	$0.18

The actor charges actor-start before fetching/rendering, deduplicates page events, charges record/finding events only for corresponding output, and stops before further output on partial, limited, or over-budget charges. Screenshot events fire only when a real browser PNG exists.

Safety and limitations

• Public pages only; no authentication, CAPTCHA bypass, access-control evasion, or private data.
• Browser waits, pages, records, changes, forms, popups, and screenshots are bounded.
• Blocked, empty, and missing-baseline cases produce diagnostics instead of invented success.
• Results describe source evidence at scan time and may change later.
• Store discounts, icons, publication, and scheduler state are separate live configuration gates.

Local validation

pnpm --filter @junipr/lead-magnet-form-inventory build
pnpm --filter @junipr/lead-magnet-form-inventory test
pnpm --filter @junipr/lead-magnet-form-inventory smoke

Fixtures cover success, weak/blocked evidence, comparison, no-result, and cap behavior. Tests also prove schema equality, pricing metadata, charge guards, zero budget, reports, and charge-before-output ordering.