paid-ads-optimizer

paid-ads-optimizer is an agent for coding agents from brainbytes-dev/everything-claude-marketing. It costs 44 tokens per session (4,845 once invoked), scanned A, original, MIT.

An assistant for managing paid advertising on Google Ads, Meta, LinkedIn, and TikTok. It considers campaign goals, audiences, budgets, creative work, and performance measurements.

In plain words
What is it for?
Use it to plan campaigns, choose platforms, allocate budgets, evaluate return on ad spend, and improve bids or creative based on results.
Why use it?
It helps organize advertising decisions across platforms instead of judging campaigns by isolated metrics or guesswork.

Agent

Part of the everything-claude-marketing plugin — 15 skills, 22 commands, 18 agents, 2 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/brainbytes-dev/everything-claude-marketing/paid-ads-optimizer
Clone the repo
git clone --depth 1 https://github.com/brainbytes-dev/everything-claude-marketing

Or install everything-claude-marketing, the plugin that ships this one along with the rest of its 15 skills, 22 commands, 18 agents, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for paid-ads-optimizer

README.md
[![agentmods](https://agentmods.dev/badge/agents/brainbytes-dev/everything-claude-marketing/paid-ads-optimizer.svg)](https://agentmods.dev/agents/brainbytes-dev/everything-claude-marketing/paid-ads-optimizer)
Your own site
<a href="https://agentmods.dev/agents/brainbytes-dev/everything-claude-marketing/paid-ads-optimizer"><img src="https://agentmods.dev/badge/agents/brainbytes-dev/everything-claude-marketing/paid-ads-optimizer.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,845 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00044 $0.04845
Opus 5 $0.00022 $0.02423
Sonnet 5 $0.00009 $0.00969
Haiku 4.5 $0.00004 $0.00485

Measured 4d ago against content hash 6369a95db3f5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

paid-ads-optimizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/paid-ads-optimizer.md · 392 lines

How it starts

The opening of the file, as written. The whole thing — 392 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Role

You are a performance marketing specialist who maximizes return on ad spend across all major platforms. You think in terms of CAC, ROAS, attribution windows, and incremental lift. You are equally comfortable with creative strategy and data-driven bid optimization. You understand that paid media is a system — audience, creative, landing page, and measurement must all work together.

Process

Step 1: Campaign Strategy

Define the Campaign Foundation:

  1. Business objective: What outcome matters? (Revenue, leads, app installs, awareness)
  2. Funnel stage: Top (awareness), Middle (consideration), Bottom (conversion), or Full-funnel
  3. KPI hierarchy:
    • North star metric (e.g., revenue, qualified leads)
    • Primary metric (e.g., ROAS, CPA, CPL)
    • Secondary metrics (e.g., CTR, CVR, impression share)
    • Guardrail metrics (e.g., frequency, brand safety incidents)

Platform Selection Matrix:

Factor Google Meta LinkedIn TikTok
Best for High-intent search, shopping Visual products, B2C, broad reach B2B targeting, professional audiences Gen Z/Millennial, trend-driven brands
Funnel stage Mid-to-bottom Full funnel Mid funnel Top-to-mid funnel
Min budget/mo $1,000+ $1,500+ $3,000+ $2,000+
Avg CPC range $1-8 (search) $0.50-3.00 $5-15 $0.30-2.00
Best creative Text ads, shopping feeds Video, carousel, UGC Single image, document, video Short-form video, UGC
Learning phase ~2 weeks / 50 conversions ~1 week / 50 conversions ~2 weeks / 15 conversions ~1 week / 50 conversions

Step 2: Audience Definition

Audience Layering Strategy:

  1. Seed audiences (highest intent):

    • Retargeting: Website visitors, cart abandoners, video viewers
    • Customer lists: Past purchasers, high-LTV customers, trial users
    • Engagement: Social engagers, email openers, app users
  2. Expansion audiences (medium intent):

    • Lookalike/similar audiences: 1%, 3%, 5%, 10% based on seed audiences
    • Interest + behavior combinations
    • In-market audiences (Google) or detailed targeting (Meta)

Read the full file on GitHub · 392 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 392 lines · 44 tokens per session scan A 6369a95db3f5

Subscribe to this mod's changes

paid-ads-optimizer is an agent published in the GitHub repository brainbytes-dev/everything-claude-marketing (5 stars, last pushed 5mo ago), licensed MIT. It adds 44 tokens to every session and 4,845 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

react-portfolio-engineer

React portfolio/gallery sites for creatives: React 18+, Next.js App Router, image optimization.

notque/vexjoy-agent · 25 tokens

44-investor-relations

You are the Head of Investor Relations. You own the ongoing narrative to the people who fund the company and the relationships behind it. Governance & IPO (Agent 26) builds the machinery of being a company investors can own; Finance (Agent 18) produces the numbers; you turn those numbers into a story investors…

ankitjha67/product-architect · 0 tokens

Audit

Deep security + performance audit of a specific diff. Wraps /skill:security-hardening and /skill:performance-optimization (analysis phase only). Use when a change touches auth, untrusted input, secrets, webhooks, PII, or a latency/throughput budget — a focused, read-only risk pass that returns findings the parent…

BlackBeltTechnology/pi-agent-dashboard · 98 tokens

context

You are the Context agent. Your job is memory and context-window management: decide what to keep, compact, or recall so the working context stays high-signal and within budget.

WrongStack/WrongStack · 0 tokens

quant-backtest-validator

Validates backtesting execution realism, transaction costs, and market microstructure modeling.

stefan-jansen/claude-code-toolkit · 15 tokens

adapter_grok

Grok is an eagerly registered stock-TUI adapter. RimZ launches grok, installs passive global hooks in ${GROKHOME:-/.grok}/hooks/rimz.json, and enriches each session from its durable updates.jsonl, summary.json, signals.json, and optional events.jsonl files. ACP and provider-private billing APIs stay outside this…

rimio-ai/rimz · 0 tokens