Promo Banner Coupon Extractor

Extract visible promo banners, coupon codes, discount claims, sale timers, free-shipping messages, and eligibility fine print from public webpages.

What it does

Renders public pages and extracts visible promotion banners, coupon codes, discounts, timers, free-shipping claims, eligibility text, and position.

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

Common uses

• Extract promo banners and coupons
• Monitor competitor discounts
• Inventory sitewide sale messages
• Find free-shipping claims
• Export promotion evidence

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
• couponPatterns
• promoTerms
• includeFinePrint
• captureBannerPosition
• maxBannersPerPage
• captureScreenshots
• viewportWidth
• viewportHeight
• maxPromoRecords
• maxScreenshots
• maxBrowserPages
• maxChargeUsd
• includeReport

The caps in maxPages, maxPromoRecords, maxScreenshots, maxBrowserPages, 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
• promoType
• promoText
• couponCode
• discountValue
• timerText
• freeShippingSignal
• eligibilityText
• bannerPosition
• expiresSignal
• screenshotKey

Reports:

• promo-banner-coupon-extractor-summary-report.md
• promo-banner-coupon-extractor-records.csv
• promo-banner-coupon-extractor-issues.json
• promo-banner-coupon-extractor-evidence-samples.json
• promo-banner-coupon-extractor-run-metadata.json

Pricing

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

Event	Price
actor-start	$0.08
promo-page-rendered	$0.0275
promo-record-extracted	$0.0095
screenshot-captured	$0.018
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/promo-banner-coupon-extractor build
pnpm --filter @junipr/promo-banner-coupon-extractor test
pnpm --filter @junipr/promo-banner-coupon-extractor 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.