Spot Meta ads that people have seen too often, before the CTR slide costs you

Each morning: Meta ads whose frequency passed 3 while CTR fell three days running, with a question about which creatives to refresh.

Runs
Every day at 9:00
Posts
Asks you

From your apps to your board

How the skill works: your agent reads 14 days at ad level from Meta Ads; meta ad account id from What you tell it, every day at 9:00, and gives you a question for you and a telegram ping and the report in the chat.

Reads

  • Meta Ads14 days at ad level
  • What you tell itMeta ad account ID
reads
Your agentClaude Code, Codex, Cursor or GeminiEvery day at 9:00
posts

You get

  • A question for youOn your board, answered with a tap
  • A Telegram pingOnly when it needs your answer, if you connect Telegram
  • The report in the chatEvery run, with or without Briefkin

What you get

  • Fatigued ads: name, ad set, 7-day frequency, CTR in the first week and the last 3 days, 7-day spend.
  • Cost signal: CPM and spend, to show what the slide costs.
  • The ask: which creatives to refresh, with an offer to draft new angles.

The card on the right is a sample. Yours shows your own numbers and updates in place every run.

What lands on your board

Acme StoreMeta Ads creative fatigue alert · Claude Code

3 ads show creative fatigue

Which of these should get a new creative? I can draft three new copy angles for each one you pick.

3 of 24 active ads have a 7-day frequency over 3 and a CTR that fell three days in a row. Together they spent $2,310 this week.

AdFrequencyCTR week 1CTR last 3dSpend 7d
UGC video - morning routine4.21.9%1.1%$1,140
Carousel - bestsellers3.61.4%0.9%$690
Static - 20% off bundle3.31.2%0.8%$480
Resolve
An example with made-up numbers. Your agent posts your real ones.

What it does

Creative fatigue is slow, then sudden. The same people see an ad for the fourth and fifth time, click-through slides a little each day, CPMs hold, and cost per purchase climbs. In Ads Manager it is visible only if you open the ad level and line up frequency against CTR by day.

The agent does that line-up for every active ad each morning and asks only when both signals agree: the audience has seen the ad more than three times in a week and CTR has dropped three days running. You pick which creatives to refresh; nothing is paused for you.

How it works

  1. 1Pull 14 days at ad level

    GET /act_<id>/insights?level=ad&date_preset=last_14d&time_increment=1&fields=ad_id,ad_name,adset_name,ctr,impressions,spend,cpm with filtering=[{"field":"ad.effective_status","operator":"IN","value":["ACTIVE"]}], or the ads MCP server's reporting tools at ad level.

  2. 2Get weekly frequency

    Request level=ad&date_preset=last_7d&fields=ad_id,frequency,reach. Frequency is impressions over reach for the whole window; daily frequencies cannot be added up into a weekly one.

  3. 3

    3Apply the fatigue test

    Flag an ad when its 7-day frequency is over 3, its CTR fell on each of the last 3 days, and its last-3-day CTR is at least 20% below its first-week CTR. Skip ads spending under $20 a day. These thresholds are starting points; set your own in the skill.

  4. 4

    4Ask which to refresh

    Post an action card with each flagged ad, its ad set, frequency, CTR then and now, and 7-day spend. Offer to draft new copy angles for the ones you pick. On a day with no fatigue, update the card with the count of ads checked.

  5. Post it to the board

    With BRIEFKIN_TOKEN set, the agent sends the result as one card that updates in place every run. Without it, you get the report in the chat.

Install and run it

Pick your agent, where the data comes from and how to schedule it; the commands below follow.

Agent
Data
Schedule
  1. Install the skill

    One command. It puts the SKILL.md in ~/.claude/skills and in ~/.agents/skills, which Codex, Cursor, Gemini CLI, Copilot CLI and OpenCode read too.

    shellcurl -fsSL https://briefkin.dev/skills/meta-ads-creative-fatigue-alert/install | sh
  2. Run it

    Ask Claude Code:

    promptRun the meta-ads-creative-fatigue-alert skill

    Or paste the prompt instead of installing:

    promptUsing the Meta Marketing API insights endpoint (or Meta's ads MCP server, reporting tools only), get daily CTR, impressions, spend and CPM for each active ad over the last 14 days, and each ad's 7-day frequency and reach as one figure. Flag ads with a 7-day frequency over 3 whose CTR fell on each of the last 3 days and whose last-3-day CTR is at least 20% below their first-week CTR, skipping ads under $20 a day. Show each flagged ad with its ad set, frequency, CTR then and now, and 7-day spend, then ask me which ones to refresh. Do not pause or edit anything.
  3. Put it on a schedule

    Every day at 9:00, from cron on any machine where Claude Code is signed in:

    crontab0 9 * * * claude -p "Run the meta-ads-creative-fatigue-alert skill"

    Add it with crontab -e. A laptop asleep at that time runs it when it wakes if you use launchd or Task Scheduler instead; GitHub Actions works for the API route.

  4. Send it to your board

    Connect Briefkin once with curl -fsSL https://briefkin.dev/install | sh and every run lands on your board as a question for you. How setup works

View the SKILL.mdRaw file
SKILL.md---
name: meta-ads-creative-fatigue-alert
description: "Each morning: Meta ads whose frequency passed 3 while CTR fell three days running, with a question about which creatives to refresh. Use when the user asks for this, or when it runs on a schedule."
---

# Meta Ads creative fatigue alert

Each morning: Meta ads whose frequency passed 3 while CTR fell three days running, with a question about which creatives to refresh.

Creative fatigue is slow, then sudden. The same people see an ad for the fourth and fifth time, click-through slides a little each day, CPMs hold, and cost per purchase climbs. In Ads Manager it is visible only if you open the ad level and line up frequency against CTR by day.

The agent does that line-up for every active ad each morning and asks only when both signals agree: the audience has seen the ad more than three times in a week and CTR has dropped three days running. You pick which creatives to refresh; nothing is paused for you.

## Two ways to get the data

Use the API or MCP route when you have an MCP server, a CLI or an API token for the app. Otherwise, if you can drive a browser the user is signed in to (Claude in Chrome, a Playwright or Chrome DevTools MCP server), use the browser route. Say which one you used.

## Route A: API or MCP server

### What you need

- Read access to the Meta ad account and its `act_` ID.
- Meta's ads MCP server (reporting tools only) or a Marketing API token with `ads_read`.

If something is missing, say what and stop; do not invent numbers.

### Steps

1. **Pull 14 days at ad level** (Meta Ads): `GET /act_<id>/insights?level=ad&date_preset=last_14d&time_increment=1&fields=ad_id,ad_name,adset_name,ctr,impressions,spend,cpm` with `filtering=[{"field":"ad.effective_status","operator":"IN","value":["ACTIVE"]}]`, or the ads MCP server's reporting tools at ad level.
2. **Get weekly frequency** (Meta Ads): Request `level=ad&date_preset=last_7d&fields=ad_id,frequency,reach`. Frequency is impressions over reach for the whole window; daily frequencies cannot be added up into a weekly one.
3. **Apply the fatigue test**: Flag an ad when its 7-day frequency is over 3, its CTR fell on each of the last 3 days, and its last-3-day CTR is at least 20% below its first-week CTR. Skip ads spending under $20 a day. These thresholds are starting points; set your own in the skill.
4. **Ask which to refresh**: Post an action card with each flagged ad, its ad set, frequency, CTR then and now, and 7-day spend. Offer to draft new copy angles for the ones you pick. On a day with no fatigue, update the card with the count of ads checked.

## Route B: the browser

### What you need

- Signed in to Facebook with at least the Analyst (view-only) role on the ad account.

If something is missing, say what and stop; do not invent numbers.

### Steps

Start at https://adsmanager.facebook.com/adsmanager/manage/ads. The user is signed in already; never type passwords or codes, and ask if a sign-in page appears.

1. **Open the Ads tab for the last 14 days**: Open Ads Manager, pick the ad account, and go to the **Ads** tab. Set the date picker to **Last 14 days**. Add a filter **Delivery > Active** so only running ads are listed.
2. **Show CTR by day**: Under **Columns > Customize columns**, tick `Ad set name`, `Amount spent`, `Impressions`, `CTR (all)` and `CPM (cost per 1,000 impressions)`. Then set **Breakdown > By time > Day**. With more than about 20 ads the table gets long, so use **Reports > Export table data** as CSV and read the file.
3. **Read 7-day frequency separately**: Switch the breakdown off, set the date to **Last 7 days**, and add the `Frequency` and `Reach` columns. Frequency is impressions over reach for the whole window, so read it from this view, never from the daily one.
4. **Apply the fatigue test and ask**: Flag an ad when its 7-day frequency is over 3, its CTR fell on each of the last 3 days, and its last-3-day CTR is at least 20% below its first-week CTR; skip ads spending under $20 a day. List each flagged ad with its ad set, frequency, CTR then and now and 7-day spend, and ask which to refresh.

Note: Two table views per run, and the daily breakdown multiplies rows by 14, so the export is the normal path for accounts with more than a couple of dozen active ads. Ads Manager shows frequency per row for the selected range only; daily frequencies cannot be summed into a weekly one.

## The report

- **Fatigued ads**: name, ad set, 7-day frequency, CTR in the first week and the last 3 days, 7-day spend.
- **Cost signal**: CPM and spend, to show what the slide costs.
- The ask: which creatives to refresh, with an offer to draft new angles.

## Post it to Briefkin

When `BRIEFKIN_TOKEN` is set, or `~/.config/briefkin/env` exists (the installer from https://briefkin.dev/docs writes it), also send the result to the user's Briefkin board as one card. Keep the `item_key` the same on every run so the card updates in place, use a new `event_id` per run, and put today's real numbers in place of the example ones. If the request fails, say so once and carry on.

```bash
[ -n "${BRIEFKIN_TOKEN:-}" ] || . ~/.config/briefkin/env
curl -sS -X POST "${BRIEFKIN_URL:-https://briefkin.dev}/v1/events" \
  -H "authorization: Bearer $BRIEFKIN_TOKEN" \
  -H "content-type: application/json" \
  -d @- <<'JSON'
{
  "v": 1,
  "event_id": "meta-ads-creative-fatigue-alert/<date of this run, e.g. 2026-10-16>",
  "item_key": "meta-ads-creative-fatigue-alert",
  "project": "Acme Store",
  "source": "Meta Ads creative fatigue alert skill",
  "kind": "action",
  "title": "3 ads show creative fatigue",
  "summary": "**3 of 24** active ads have a 7-day frequency over 3 and a CTR that fell three days in a row. Together they spent **$2,310** this week.",
  "action": {
    "request": "Which of these should get a new creative? I can draft three new copy angles for each one you pick.",
    "options": [
      "All 3",
      "Only the UGC video",
      "Show me CPA first",
      "Leave them running"
    ]
  },
  "widget": {
    "type": "Table",
    "props": {
      "columns": [
        "Ad",
        "Frequency",
        "CTR week 1",
        "CTR last 3d",
        "Spend 7d"
      ],
      "align": [
        "left",
        "right",
        "right",
        "right",
        "right"
      ],
      "rows": [
        [
          "UGC video - morning routine",
          4.2,
          "1.9%",
          "1.1%",
          "$1,140"
        ],
        [
          "Carousel - bestsellers",
          3.6,
          "1.4%",
          "0.9%",
          "$690"
        ],
        [
          "Static - 20% off bundle",
          3.3,
          "1.2%",
          "0.8%",
          "$480"
        ]
      ]
    }
  }
}
JSON
```

Widgets come from the Briefkin catalog (https://briefkin.dev/v1/catalog). Without a token, just give the user the report.

## Run it on a schedule

Suggested: Every day at 9:00 (`0 9 * * *`). From cron, with the agent signed in on that machine:

```bash
0 9 * * * claude -p "Run the meta-ads-creative-fatigue-alert skill"
# Codex: codex exec, Gemini CLI: gemini -p, Copilot CLI: copilot -p, OpenCode: opencode run
```

Or use the agent's own scheduler (Claude Code routines, Codex automations, Claude or ChatGPT scheduled tasks): https://briefkin.dev/skills/meta-ads-creative-fatigue-alert#schedule

Source: https://briefkin.dev/skills/meta-ads-creative-fatigue-alert

What your agent needs

  • Read access to the Meta ad account and its act_ ID.

  • Meta's ads MCP server (reporting tools only) or a Marketing API token with ads_read.

Connecting Meta Ads

  1. Meta Ads MCP server, Meta's official remote server at https://mcp.facebook.com/ads, with tools for reporting, ad and catalog management, datasets and troubleshooting. You sign in through Facebook Login for Business. For Claude Code, Meta documents claude mcp add --transport http --client-id <META_APP_ID> meta-ads https://mcp.facebook.com/ads, using a Meta developer app with the ads MCP use case added; clients that send headers can pass a user access token as a Bearer token instead (get started). Codex and Cursor take the same URL.
  2. Meta Ads CLI. Meta's command-line tool installs with pip install meta-ads, reads the token from ACCESS_TOKEN, and returns insights with meta ads insights get --fields spend,impressions,ctr,cpc, which suits scheduled runs from Claude Code or Codex.
  3. Marketing API with a system user token. In Business Settings, create a system user, give it the ad account with View performance access, and generate a token with the ads_read permission. The skill reads META_ACCESS_TOKEN and META_AD_ACCOUNT_ID (act_1234567890).

The MCP server can create and edit ads when you grant management permissions. For unattended reports, a system user with only ads_read and View performance can't touch a bid, a budget or an ad.

Questions

Why frequency over 3?

It is a common rule of thumb for prospecting audiences, not a Meta rule. Retargeting audiences are small and tolerate higher frequency, so the skill can take a separate threshold per campaign type. The CTR condition matters more: frequency alone says people saw the ad often, not that they stopped responding.

Will it pause the ads it flags?

No. The skill only reads reports and asks. Pausing or swapping creatives stays your call in Ads Manager, or a separate step you approve, because a fatigued ad can still be your cheapest source of purchases.

Do I need Briefkin to use the Meta Ads creative fatigue alert skill?

No. The skill runs with your own agent and gives you the report in the chat. With a Briefkin token set, each run also posts it to your board as a asks you, so you can glance at it instead of asking again.

Which agents can run it?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode, Windsurf and Amp all read SKILL.md files. The install command puts it in ~/.claude/skills and ~/.agents/skills, where they look. ChatGPT, the Claude app and Grok take the prompt instead. Pick your agent under "Install and run it" and the commands change to match.

Can it work without an API or MCP server, from my browser?

Yes. Switch the data source to "Your browser" and the steps change to the Meta Ads pages themselves: the agent opens adsmanager.facebook.com/adsmanager/manage/ads in a browser you are signed in to and reads the numbers off the page. Claude Code, Codex, Cursor, Claude app and ChatGPT can drive a browser out of the box; Gemini CLI, Copilot CLI and OpenCode need a Playwright or Chrome DevTools MCP server first. It is slower than the API and needs you signed in, so it suits a report you run by hand or from a scheduler on your own computer.

Answer your agents from one board, or from Telegram

Skills are free to use with any agent. Briefkin is where their results land: one board for every report, number and question your agents send, with a ping when something needs you.

Free during the open beta. No card.