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
Your boardEvery day at 9:00
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.
Ad
Frequency
CTR week 1
CTR last 3d
Spend 7d
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
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
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.
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
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
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.
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
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
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.
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.
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
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
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.
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.
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.