bluealpha-mcp-plugins

Audit Meta's Advantage+ suite — Advantage+ Sales (ASC / Advantage+ Shopping), Advantage+ App campaigns, Advantage+ Audience (auto-expansion), Advantage Campaign Budget (CBO), and Advantage+ Creative enhancements — and decide where automation is helping vs leaking spend. Covers ASC vs manual split, existing-vs-new-customer budget cap, placement/creative controls, and the black-box measurement problem. Use when the user says "audit my Advantage+ campaigns", "is Advantage+ Shopping working", "ASC audit", "Advantage+ Audience check", "should I use Advantage+ creative", "Advantage campaign budget", "is Meta automation helping or hurting", or wants a read on Meta's automated products.

Analyze Meta (Facebook/Instagram) audience performance across demographics (age, gender), geos, devices, and audience type (prospecting vs retargeting, lookalike vs custom vs broad, Advantage+ Audience vs original audience) — then recommend targeting changes and segments to add or exclude. Use when the user says "Meta audience analysis", "who is converting on Facebook/Instagram", "Meta audience segments", "refine my Meta targeting", "is Advantage+ Audience working", "lookalike vs broad on Meta", or wants to know which Meta audiences drive performance. Do NOT use for cross-platform/MMM reconciliation.

Run a full optimization cycle on a Meta (Facebook/Instagram) Ads account — structure audit, CBO/ABO budget structure, learning-phase & fragmentation diagnosis, pacing, budget reallocation, creative health, MMM cross-check. Use when the user mentions "optimize my Meta campaigns", "optimize my Facebook/Instagram ads", "Meta account health check", "audit my Meta ads", "why is my Meta spend low", "Meta account review", "is my Meta account in learning", or wants a comprehensive Meta account cycle.

Audit the measurement signal feeding Meta (Facebook/Instagram) — Conversions API (CAPI) coverage and deduplication, pixel/browser event health, Event Match Quality (EMQ), Aggregated Event Measurement (AEM 8-event) priority, attribution settings (7d-click/1d-view), and iOS/SKAN coverage — to decide whether Meta's reported conversions can even be trusted before acting on them. Use when the user says "Meta signal health", "is my CAPI working", "Event Match Quality", "pixel vs CAPI dedup", "Meta attribution settings", "AEM 8 events", "SKAN / iOS tracking on Meta", "why is Meta under-reporting conversions", or wants to validate Meta's conversion signal. Run BEFORE trusting Meta CPA/ROAS in any other skill.

Turn any content piece (blog post, product launch, video, organic post, webinar, news item) into a Meta (Facebook/Instagram) paid campaign spec — objective, campaign/ad-set structure (CBO vs ABO), audiences, placements, creative brief, budget, and KPIs. Use when the user says "promote this on Meta/Facebook/Instagram", "Meta campaign from this content", "turn this blog into Facebook ads", "launch this on Instagram", "boost this post properly", or wants to convert a content asset into a paid Meta campaign. Output is a build-ready spec; execution routes through the BlueAlpha pipeline.

Detect Meta (Facebook/Instagram) creative fatigue and waste at the ad level. Combines BlueAlpha's own creative-fatigue engine (live `creative_fatigue_*` tools, already Meta-aware) with raw ad-level signals — frequency, thumb-stop/ThruPlay decay, link-CTR decay, CPM spike, first-time-impression ratio, and Meta's relevance diagnostics (quality/engagement/conversion rankings). Use when the user says "Meta creative fatigue", "my Facebook ads aren't working anymore", "Instagram CTR is dropping", "which Meta creatives are tired", "frequency too high on Meta", "refresh my Meta creative", "Meta creative health check", or wants to know which Meta ads are bleeding spend. Use BEFORE generating new briefs — fatigue scoring tells you whether refresh is needed.

Detect Meta (Facebook/Instagram) creative fatigue, audit the attributes of winning ads, and generate a production-ready creative brief — hooks, formats (Reels/Stories/feed video/static/carousel), aspect ratios, lengths, CTAs, and messaging angles. Use when the user says "Meta creative refresh", "new Facebook/Instagram ads", "Meta ad fatigue", "Meta creative brief", "what hooks should we test on Meta", "I need fresh Meta creative", or wants a net-new Meta creative brief. Run meta-creative-fatigue-watchdog first to confirm refresh is actually needed.

Run the complete BlueAlpha Meta (Facebook/Instagram) audit suite — signal/CAPI health, auto-optimize (structure/pacing/budget), Advantage+ audit, creative-fatigue, placement performance, audience intelligence, geo expansion, creative refresh (conditional), and incrementality design — and compose the findings into one leadership-ready "state of the account" report with a prioritized, risk-tiered action plan. Use when the user says "full Meta audit", "Meta full monty", "complete Meta account review", "comprehensive Meta audit", "run everything on Meta", "Facebook/Instagram deep dive", or wants the whole BlueAlpha Meta workup. This is the orchestrator — pair with the schedule skill to run quarterly.

Identify new geographic markets worth entering on Meta (Facebook/Instagram) by analyzing current geo performance (country/region) and CPM/efficiency headroom, and flag bleeding geos to cut. Use when the user says "Meta geo expansion", "new markets for Facebook/Instagram", "where should I run Meta ads", "Meta geographic opportunities", "which countries are working on Meta", "international expansion on Meta", or wants a structured read on market expansion candidates and geo waste.

Design and monitor geo-based incrementality / lift tests for Meta (Facebook/Instagram) with integrity checks against platform-reported ROAS. Covers geo holdout design, Meta Conversion Lift framing, power/duration, and reading results via BlueAlpha's incrementality tooling. Use when the user says "Meta incrementality test", "Meta geo test", "Meta holdout test", "is Facebook actually driving conversions", "Meta ROAS isn't real", "Conversion Lift", "prove Meta incrementality", or wants to validate that Meta delivers causal lift, not just last-touch/modeled credit.

Generate a weekly or monthly Meta (Facebook/Instagram) Ads performance read in the BlueAlpha narrative format — what happened (period-over-period), what drove it (campaign + creative + placement attribution), what to watch (early signals for next period). Leadership-ready prose, not a metric dump. Use when the user says "Meta weekly report", "Facebook monthly digest", "how did Meta perform this week", "Meta performance summary", "Instagram ads scorecard", "what's the Meta report saying", or wants a team-shareable view of Meta ad performance. Pair with the schedule skill to run automatically every Monday.

Break down Meta (Facebook/Instagram) performance by placement — publisher_platform (Facebook, Instagram, Audience Network, Messenger) and platform_position (Feed, Reels, Stories, Explore, Marketplace, in-stream, Search, Reels overlay) plus device — to find where spend converts vs leaks, and decide Advantage+ Placements vs manual placement control and per-placement creative needs. Use when the user says "Meta placement breakdown", "Reels vs Feed performance", "is Audience Network wasting spend", "where are my Meta ads showing", "placement analysis", "Stories vs Reels", "should I exclude Audience Network", or wants a placement-level read.

Audit LinkedIn matched-audience and segment health across an ad account: identify campaigns on AUDIENCE_COUNT_HOLD, map which audiences are shared across campaigns (auction overlap risk), flag single-audience dependencies, surface declining/stale audiences via impression decay, and produce a manual-validation checklist for what the API can't see (audience sizes, sync recency, list freshness). Use this skill whenever the user says 'check my LinkedIn audiences', 'audience health check', 'matched audience audit', 'why is my campaign on hold', 'audience count hold', 'why isn't my campaign delivering', 'are my audiences too small', 'audience overlap on LinkedIn', 'audience hygiene', 'are any of my LinkedIn audiences stale', or anything about validating matched-audience configuration. Use BEFORE running auto-optimize — audience problems are upstream of pacing and bidding issues.

Run a full LinkedIn ad account health cycle: pacing on lifetime budgets, structural issues (billing/group holds, no-creative campaigns, dormant campaigns), delivery vs budget gaps, and a prioritized action list across audiences, creatives, and structure. Combines lightweight versions of audience-health, creative-fatigue, and bid-sanity checks into a single account-level dashboard. Use when the user says 'optimize my LinkedIn account', 'LinkedIn health check', 'audit my LinkedIn ads', 'why is my LinkedIn spend low', 'why isn't my LinkedIn delivering', 'LinkedIn account review', 'is anything broken on LinkedIn', or 'weekly LinkedIn check-in'. Use as the FIRST skill in any LinkedIn troubleshooting session — it surfaces what's structurally broken before you dig into specific layers.

Audit LinkedIn campaign bid strategies — cost type (CPM/CPC/CPV/CPL), optimization target, unit cost, creative selection mode, and pacing strategy — against each campaign's objective. Flag mismatches (e.g., CPC on Brand Awareness, CPM on Lead Gen with high unit cost), suspicious unit costs (way above LinkedIn's recommended range or below the bid floor), and missing optimization targets that leave the optimizer flying blind. Output: per-campaign findings + recommended changes. Use when the user says 'audit my LinkedIn bids', 'should I use CPC or CPM on LinkedIn', 'why is my CPM so high', 'is my bid strategy right', 'LinkedIn bid sanity check', or 'check my optimization settings'. Pair with auto-optimize for a complete pre-flight.

Detect LinkedIn ad creative fatigue and waste at the creative level. Score each active creative on engagement decay (prior 14d vs recent 14d) using metrics appropriate to its campaign objective (CTR + LP-click rate for Traffic, engagement rate for Brand/Engagement, hook + completion rate for Video, CTR for Lead Gen). Surface fatigued creatives, weak-from-launch creatives, and high-spend low-engagement waste. Output a prioritized refresh queue. Use whenever the user says 'creative fatigue', 'LinkedIn ads aren't working anymore', 'which creatives are tired', 'CTR is dropping', 'refresh my LinkedIn creative', 'audit my LinkedIn ads', or wants to know which creatives are bleeding spend on LinkedIn. Use BEFORE generating new creative briefs — fatigue scoring tells you whether refresh is needed.

Analyze LinkedIn Ads spend, clicks, and engagement by member demographics (seniority, job function, company size, industry) to surface which segments are actually working, where the targeting is drifting, and which segments to add or exclude. Use this skill whenever the user says 'demographic analysis on LinkedIn', 'who's clicking my LinkedIn ads', 'job function breakdown', 'LinkedIn seniority report', 'analyze my LinkedIn audience', 'who am I actually reaching on LinkedIn', 'company size breakdown', 'LinkedIn industry mix', or anything about understanding LinkedIn ad delivery by member attributes. Also trigger when prepping a LinkedIn quarterly review, evaluating whether LinkedIn targeting is hitting the intended ICP, or looking for waste to cut. Do NOT use this skill for cross-platform analysis or MMM reconciliation — it's LinkedIn-only and reads native LinkedIn member demographic reporting, which no other platform exposes.

Audit LinkedIn campaigns for frequency-cap configuration and saturation risk. Identify campaigns running without frequency caps, campaigns with caps that are too tight (starving delivery) or too loose (saturating small audiences), and campaigns at risk of audience burnout based on impression intensity and audience composition. Output a per-campaign recommendation. Use when the user says 'LinkedIn frequency cap', 'is my LinkedIn audience saturated', 'how often am I showing my ads', 'frequency too high', 'audience burnout on LinkedIn', or 'should I tighten my LinkedIn frequency cap'.

Run the complete BlueAlpha LinkedIn Ads audit suite — auto-optimize (structure), audience-health (count holds + overlap risk), targeting-overlap (auction competition), creative-fatigue (per-creative decay), demographic-deep-dive (segment-level waste), bid-strategy-audit, frequency-saturation, lead-form-quality, and performance-digest — and compose the findings into one comprehensive 'state of the account' report. Use when the user says 'full LinkedIn audit', 'LinkedIn full monty', 'complete LinkedIn account review', 'comprehensive LinkedIn audit', 'run everything on LinkedIn', or wants the full BlueAlpha LinkedIn workup on an account. This is the orchestrator — pair with the schedule tool to run quarterly.

Audit LinkedIn Lead Gen Form campaigns and creatives — surface forms with declining volume, creatives that consume spend without producing leads, dormant forms in active campaigns, and CTR-to-lead conversion gaps. Outputs a manual-validation checklist for the lead-quality dimensions the LinkedIn MCP doesn't expose (form field count, completion patterns, lead-source domains). Use when the user says 'check my LinkedIn lead forms', 'lead gen quality on LinkedIn', 'why am I not getting leads from LinkedIn', 'audit my LinkedIn lead gen', or 'review my LinkedIn lead form performance'.

Generate a weekly or monthly LinkedIn Ads performance read in the BlueAlpha narrative format — what happened (period-over-period), what drove it (campaign + creative attribution), what to watch (early signals for next period). Leadership-ready prose, not a metric dump. Use when the user says 'LinkedIn weekly report', 'LinkedIn monthly digest', 'how did LinkedIn perform this week', 'LinkedIn performance summary', 'LinkedIn scorecard', 'what's the LinkedIn report saying', or wants the team-shareable view of LinkedIn ad performance. Pair with the schedule tool to run automatically every Monday morning.

Find LinkedIn campaign pairs that are bidding against each other in the auction because their targeting overlaps. Computes per-facet Jaccard similarity (seniorities, job functions, industries, titles, sizes, locations, matched audiences) and a weighted overall overlap score. Flags pairs > 60% overlap with daily-budget estimate of the auction overlap dollar value, then recommends consolidation, exclusion, or deliberate differentiation. Use whenever the user says 'audience overlap', 'targeting overlap', 'are my campaigns competing with each other', 'why is my CPC going up', 'auction overlap', 'consolidate my LinkedIn campaigns', or 'should these two campaigns be merged'. Use AFTER audience-health-check (which catches shared-URN overlap) to find the deeper attribute-level overlap.

Analyze TikTok audience performance across interests, demographics, geos, and placements — recommend targeting changes and adjacent interests to test. Use when the user mentions "TikTok audience analysis", "who's converting on TikTok", "TikTok interest targeting", "refine TikTok targeting", "TikTok audience segments", or wants to know which audiences are driving TikTok performance.

Run a full optimization cycle on a TikTok Ads account — structure audit, pacing diagnosis, budget reallocation, creative health, MMM cross-check. Use when the user mentions "optimize my TikTok campaigns", "TikTok account health check", "audit my TikTok ads", "why is my TikTok spend low", "TikTok account review", or wants a comprehensive TikTok account cycle.

Turn any content piece (blog post, product launch, video, news item, organic post) into a TikTok paid campaign spec — objective, audience, placement, creative brief, KPIs. Use when the user mentions "promote this on TikTok", "TikTok campaign from this content", "TikTok ad from blog post", "launch this on TikTok", "TikTok content amplification", or wants to convert a content asset into a paid TikTok campaign.

Detect TikTok creative fatigue using hook rate, hold rate, completion, and CTR decay. Use when the user mentions "TikTok creative fatigue", "TikTok ads aren't working anymore", "hook rate dying", "hold rate decay", "which TikTok creatives are tired", "TikTok creative health check", "video CTR dropped", or wants a fast read on which TikTok ads are wasting spend.

Detect TikTok creative fatigue, audit winning creative attributes, and generate a fresh TikTok creative brief — hooks, formats, lengths, CTAs, music direction. Use when the user mentions "TikTok creative refresh", "new TikTok ads", "TikTok ad fatigue", "TikTok creative brief", "what hooks should we test", or wants a production-ready brief for net-new TikTok creative.

Run all TikTok skills in sequence for a comprehensive top-to-bottom TikTok account review. Use when the user mentions "full TikTok analysis", "TikTok full monty", "complete TikTok account review", "run everything on TikTok", "TikTok deep dive", or wants the full BlueAlpha TikTok workup on an account.

Identify new geographic markets worth entering on TikTok by analyzing current geo performance and the TikTok targeting taxonomy. Use when the user mentions "TikTok geo expansion", "new markets for TikTok", "where should I run TikTok", "TikTok geographic opportunities", "TikTok regional expansion", or wants a structured read on market expansion candidates.

Design and monitor geo-based incrementality tests on TikTok with integrity checks against platform-reported ROAS. Use when the user mentions "TikTok incrementality test", "TikTok geo test", "TikTok holdout test", "is TikTok actually driving conversions", "TikTok ROAS isn't real", "prove TikTok incrementality", or wants to validate that TikTok is delivering causal lift, not just last-touch credit.

Generate a weekly or monthly TikTok performance read in the BlueAlpha narrative format — what happened, what drove it, what to watch. Use when the user mentions "TikTok weekly report", "TikTok monthly digest", "how did TikTok perform this week", "TikTok performance summary", "TikTok scorecard", "what's the TikTok report saying", or wants a leadership-ready narrative on TikTok performance.

Cross-reference MMM channel ROI against platform-reported ROAS (Google Ads, Meta Ads Manager, etc.) and surface where they agree vs. disagree — and which disagreements demand an incrementality test. Use when the user mentions "platform vs MMM", "why does Google Ads say X but MMM says Y", "ROAS doesn't match", "reconcile attribution", "platform ROAS vs MMM", "which number to trust", "attribution gap", or "MMM disagrees with the platform".

Simulate budget shifts against a Meridian MMM and project revenue lift before executing. Use when the user mentions "reallocate budget", "shift spend from X to Y", "what if I move $X to Y", "budget optimizer", "MMM budget simulation", or "where should I put my next dollar".

Generate a comprehensive single-channel read combining ROI, marginal ROI, saturation, adstock, weekly contribution, and prior-posterior diagnostics for one channel from a Meridian MMM. Use when the user mentions "deep dive on [channel]", "everything about [channel]", "full read on [channel]", "single-channel analysis", "tell me about Meta", "is YouTube working", "channel review", or wants the complete MMM picture on one specific channel.

Trust-grade a Meridian MMM before acting on its outputs — convergence, prior-dominance, fit, model settings, and known failure patterns. Use when the user mentions "is the model good", "can I trust this MMM", "model diagnostics", "model health", "model audit", "prior posterior", "convergence check", "MMM validation", or "should I trust these numbers".

Answer "if I turn this on (or change spend) right now, when will I see the impact?" by combining Meridian adstock decay parameters with saturation curves to project time-to-peak, half-life, and steady-state per channel. Use when the user mentions "when will I see the impact", "how long until results", "lag time", "time to impact", "adstock", "carry-over effect", "launch timing", "how fast does this channel work", or "when does the lift show up".

Generate a weekly or monthly MMM performance read in the BlueAlpha narrative format — what happened, what drove it, what to watch. Use when the user mentions "MMM digest", "weekly MMM report", "monthly MMM read", "MMM performance summary", "how did we do this month", "channel scorecard", or "what's the MMM saying this week".

Identify which channels are saturated (diminishing returns) and which still have headroom, using Meridian saturation curves and marginal ROI. Use when the user mentions "saturation", "diminishing returns", "where's the headroom", "is channel X tapped out", "response curves", "where's my next dollar going", or "which channels can I scale".

Run 3-5 budget scenarios side-by-side through Meridian's simulator and produce a comparison matrix with projected revenue and credible intervals per scenario. Different from mmm-budget-reallocator (which simulates one shift); this is portfolio-level "compare these alternatives" planning. Use when the user mentions "compare scenarios", "what if we tried 3 options", "scenario planning", "side-by-side budget options", "evaluate alternatives", "quarterly planning", "portfolio comparison", or "I'm choosing between budget plans".

Build a prioritized quarterly incrementality testing roadmap from the trust-router output. Given a test budget and a cap on concurrent tests, schedules which channels to test in which weeks, with pre-staged expected lifts as test priors. Use when the user mentions "testing roadmap", "quarterly test plan", "what should we test this quarter", "incrementality calendar", "test prioritization", "sequence my tests", "build a test plan", or "which tests are worth running".