ai-ads-agent

Google Ads impression-share analysis to identify missed scaling opportunities and diagnose delivery constraints. Distinguishes Lost-IS (Budget) — addressable with money — from Lost-IS (Rank) — addressable with bids/quality. Disciplined: only recommends scaling on campaigns that are already profitable (≥30 conversions in 30d AND CPA at/below target). Read-only — recommends budgets, bids, holds; never executes. Use weekly or when planning where to deploy more spend.

PMax morning anomaly check — compares last 3 days vs prior 3 days across spend, conversions, and CPA/ROAS for every Performance Max campaign. Flags CPA spikes (> 25%), conversion drops (> 25%), and spend spikes without conversions. Read-only — no changes applied. Disciplined: does NOT recommend major changes unless the issue is severe, since PMax is a black box and overcorrection is the #1 killer.

Daily Google Ads Search morning briefing — compares last 3 days vs prior 3 days, segments brand vs non-brand (with different expectations for each), and surfaces specific recommendations across budget, impression share, bid adjustments, search-term waste, and query opportunities. Read-only — produces a CUT / FIX / SCALE recommendations list, never executes mutations. Use as your morning Google Search standup.

Forensic Google Ads Search-term waste audit. Pareto-filters down to the 80% of spend that matters (campaign-level, then search-term-level), then flags wasteful terms using campaign-relative triggers: low engagement (CTR ≥40% below campaign avg) and low conversion (CVR ≥40% below campaign avg, including zeros). Surfaces a "Red List" with suggested negative-keyword exclusions and identifies common "waste words" for root-level negatives. Read-only — proposes exclusions, never executes them. Use weekly for waste cleanup.

30-day comprehensive Meta Ads health audit. Checks pixel/CAPI integrity, scans creative fatigue across the account, profiles audience-segment spend split, surfaces ROAS/CPA outliers (top + bottom decile), evaluates budget allocation efficiency, and produces a professional written report. Read-only — no changes applied. Use for quarterly reviews, new-account onboarding, or any "what's actually happening in this account" deep dive.

Use when researching competitor ad creatives: find competitors, brand IDs, evergreen winners, breakout winners, pattern analysis.

Use when generating Word documents (.docx). Uses the marble_docx API.

Use when generating PDF documents. Uses the marble_pdf API.

Use when generating PowerPoint presentations (.pptx). Uses the marble_pptx API.

Use when generating Excel workbooks (.xlsx). Pandas + openpyxl patterns for multiple sheets, number formats, freeze panes, formulas.

1 hook across 1 event