Claude Ads: de Claude Code vaardigheid die je advertentieaccounts controleert

Je hebt misschien de reel op Instagram gezien: "doe het werk van je advertentiebureau van 3.000 per maand in tien minuten." Achter de wat verkoperige haak zit een heel echt open source project: Claude Ads, een vaardigheid voor Claude Code die de gegevens van je advertentieaccounts leest en je vertelt wat werkt, wat kapot is en wat je eerst moet oplossen. Meer dan 10.000 sterren op GitHub in oktober 2026, MIT-licentie.

Bijgewerkt op 21 oktober 2026 voor Claude Ads v2.1.0, uitgebracht op 16 oktober 2026. De eerste versie van dit artikel beschreef v1.7.1. Sinds v2 dekt de vaardigheid twaalf platforms in plaats van acht, geeft ze geen score op 100 meer, en raden de makers de installatie in één regel die we vroeger lieten zien nu af. Alles hieronder is gecontroleerd aan de hand van de README en de bestanden van de vaardigheid in v2.1.0.

Wat Claude Ads eigenlijk is

Claude Ads is een Claude Code vaardigheid gemaakt door Daniel Agrici. Een vaardigheid is een bundel instructies, referenties en agents die je codeeragent op aanvraag laadt: hier de knowhow van een auditor voor betaalde media, opgedeeld in modules. Het is geen product van Anthropic, en het heeft niets te maken met advertenties in Claude: Anthropic schreef in februari 2026 dat Claude advertentievrij blijft.

Het komt van twee plekken: de publieke release op AgriciDaniel/claude-ads (MIT, geen lidmaatschap nodig) en een communityspiegel op AI-Marketing-Hub/claude-ads, waar leden van een betaalde community eerder toegang krijgen.

Wat v2.1.0 meebrengt:

• 12 advertentieplatforms: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat en X.
• 33 vaardigheden achter één /ads-commando, één per platform plus de overkoepelende (attributie, server-side tracking, creatives, landingspagina's, budget, planning, rapportage).
• 25 agentdefinities: één audit-worker per platform, workers voor tracking, budget, creatives, platformregels en naleving van regelgeving, vier creatieve agents (copywriter, creatief strateeg, formaatadapter, visueel ontwerper) en agents voor onderzoek en verificatie.
• Vier mogelijke resultaten per controle: pass, fail, unknown of not_applicable. Unknown betekent dat de gegevens ontbraken, en de vaardigheid raadt ze nooit.
• Voorlopig geen gezondheidsscore. Het project noemt zichzelf een ontwikkelingskandidaat, en alle twaalf scoreprofielen voor de gezondheid van accounts zijn uitgeschakeld. Een audit rapporteert in plaats daarvan bevindingen, onbekenden en de dekking door bewijs: vanaf 80% dekking wordt er beoordeeld, 60 tot 79% is voorlopig, onder 60% is onvoldoende bewijs.

De oude cijfers die je misschien elders hebt gelezen, 250 controles, een score op 100 met een cijfer van A tot F, acht platforms, beschrijven v1. Dat is niet meer wat de vaardigheid over zichzelf zegt.

Hoe het onder de motorkap werkt

Eén dirigent beheert de reikwijdte van de run, de regels, de aggregatie en het eindrapport. Workers analyseren afgebakende stukken, elk één platform of één onderwerp, en leveren hun bevindingen in een vast schema terug. Als een vereiste worker faalt, wordt de run als gedeeltelijk gemarkeerd: hij wordt nooit als volledige audit gepresenteerd.

Instellen, auditen, nakijken: de drie stappen van de v2-flow, uit de officiële repo.

Als je Claude Code al gebruikt om code te schrijven, herken je het patroon: het is het mechanisme van subagents en agentteams, toegepast op marketing in plaats van code. Sinds v2.1.0 leggen de agents geen model meer vast: Claude Code draait ze op het model van je hoofdgesprek, tenzij er iets specifiekers is ingesteld.

Het resultaat van een run is een JSON-bestand met versienummer. De rapporten in Markdown, HTML en PDF zijn weergaven van datzelfde bestand, daarom kan /ads report een eerdere run opnieuw tonen zonder iets uit te voeren.

In de praktijk past de flow in vijf stappen:

1. Voer /ads setup uit en beantwoord de vragen: bedrijfsmodel, doel, belangrijkste conversie, maandelijkse uitgaven, actieve platforms, en wie wijzigingen goedkeurt. Het zegt je dat je daar nooit API-sleutels of tokens moet plakken.
2. Lever bewijs aan: een accountexport in CSV of JSON, screenshots, of een geplakte samenvatting met de periode, valuta en tijdzone.
3. Voer /ads audit google uit, of /ads audit all. Je krijgt te zien wat geslaagd is, wat gezakt is en wat ontbreekt.
4. Voer /ads report uit om een eerdere run opnieuw te bekijken.
5. Voer /ads next uit om de belangrijkste blokkade te zien.

De twaalf platforms

Elk platform heeft zijn eigen vaardigheid, zijn eigen audit-worker, zijn eigen referentie van controles en zijn eigen verklaring van mogelijkheden. Een manifest van mogelijkheden in de repo legt vast wat er op elk platform live gelezen of gewijzigd kan worden. Boven op de platforms komen de overkoepelende audits: attributie (conversiedefinities, vensters, GA4, partners voor mobiele meting) en server-side tracking (server-side tagging, Conversions API en Events API, deduplicatie, kwaliteit van eventgegevens). Dat zijn vaak de blinde vlekken van menselijke audits, omdat ze zowel media- als technische kennis vragen.

De commando's

Alles loopt via /ads. Geïnstalleerd als Claude Code-plugin hebben de commando's een namespace en beginnen ze met /claude-ads:ads; los geïnstalleerd beginnen ze met /ads. De README noemt deze:

Snelkoppelingen per platform gaan rechtstreeks naar één audit: /ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon, /ads reddit, /ads pinterest, /ads snapchat en /ads x.

De specialistische commando's van v1 worden nog steeds door de vaardigheid doorgestuurd: /ads dna voor het merk- en aanbodprofiel van een website, /ads attribution, /ads tracking, /ads creative, /ads landing, /ads budget, /ads math voor CPA, ROAS, MER, LTV:CAC en break-even, /ads competitor, /ads generate voor afbeeldingen op basis van een goedgekeurde briefing, /ads photoshoot voor varianten van productfoto's, en /ads test als andere naam voor /ads experiment. Een verzoek in gewone taal gaat naar dezelfde vaardigheden. Geen enkele vaardigheid maakt video: videowerk stopt bij concepten en briefings.

Veilig installeren

De makers schrijven het nu zonder omwegen: kies de pluginflow van je tool of een release-archief dat tegen zijn checksum is gecontroleerd, en stuur een extern installatieprogramma nooit rechtstreeks door naar een shell. De eerste versie van dit artikel liet precies dat zien, een curl | bash en een irm | iex: gebruik ze niet.

In Claude Code, de pluginflow:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Als je de marketplace vóór v2.0.0 hebt toegevoegd, houdt Claude Code hem nog onder een oude alias. Verwijder die eerst:

/plugin marketplace remove agricidaniel-claude-ads

Vanuit een kloon die je hebt gelezen, op macOS of Linux:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

Op Windows, in PowerShell, vanuit dezelfde kloon: .\install.ps1 -Source local.

Om een versie vast te zetten, checkt bash install.sh --source=git --ref=v2.1.0 precies die tag uit en faalt als die niet gevonden wordt. De geverifieerde route blijft een release-zip: elke GitHub-release publiceert de zip, een manifest, een software bill of materials en een SHA256SUMS-bestand, en elke regel van sha256sum -c SHA256SUMS moet OK tonen voordat je uitpakt. Releases hebben een checksum, geen handtekening.

Wat je nodig hebt: CPython 3.11 of 3.12 voor de beheerde afhankelijkheden, glibc 2.28 of nieuwer op Linux, de bibliotheken WeasyPrint en Pango voor PDF-rapporten, en een Playwright-browser als je browseropnames wilt.

Het installatieprogramma heeft ook --target=codex, --target=gemini en doelen voor Cursor, Windsurf en Goose. De README markeert ze als experimenteel: alleen Claude Code is geverifieerd, en de andere tools kunnen dezelfde bestanden anders behandelen.

De workflow uit de reel, opnieuw bekeken

De Instagram-reel die de vaardigheid bekend maakte, toont drie stappen. Hier zijn ze met v2.1.0.

Stap 1: installeer de vaardigheid. Via de pluginflow hierboven, niet met een geplakte one-liner.

Stap 2: beschrijf je bedrijf en plan dan. /ads setup vraagt naar je aanbod, doel, conversie, budget en platforms. Als je een website hebt, haalt /ads dna <url> je merk- en aanbodprofiel eruit zodat het plan vertrekt vanuit je echte positionering. Daarna bouwt /ads plan het plan voor kanalen, campagnes, budget en meting.

Stap 3: het rapport. /ads report geeft de opgeslagen run weer als Markdown, HTML of PDF, klaar om naar een klant of je directie te sturen.

Waar de reel het simpeler maakt: de uitvoer is maar zo goed als het bewijs. Geef je vage antwoorden, dan krijg je een vaag plan. Voer je een audit uit zonder export of screenshots, dan krijg je een rapport vol unknown, wat eerlijk is, maar geen diagnose. En in v2.1.0 is er geen score om mee te pronken: je krijgt bevindingen en hoeveel van het account beoordeeld kon worden.

Je gegevens en je accounts

De vaardigheid draait in je terminal en analyseert het bewijs dat je haar geeft. Inloggegevens horen in omgevingsvariabelen, de sleutelhanger van het besturingssysteem of een secret manager; nooit in de repository, de profielen, de rapporten of de logs.

De grotere verandering sinds v1 zit aan de schrijfkant. v2 heeft /ads launch en /ads optimize, maar elke adapter is standaard alleen-lezen en wijzigingen blijven concepten. Om er een toe te passen, heeft de vaardigheid alle zes deze dingen nodig:

1. een geteste en ingeschakelde mogelijkheid voor precies die bewerking;
2. expliciete account- en object-ID's;
3. een leesbare diff van voor en na, met wat hij raakt;
4. goedkeuring van de eigenaar, binnen de limieten die voor het account zijn ingesteld;
5. een idempotentiesleutel, een auditbestemming, een rollback en een verificatievenster;
6. een controle dat het account nog overeenkomt met wat de wijziging verwacht.

Geen limieten ingesteld betekent niets schrijven, en definitief verwijderen wordt in v2 niet ondersteund.

Wat het vervangt, en wat niet

Laten we eerlijk zijn, want "vervang je bureau van 3.000 per maand" verdient nuance.

Wat Claude Ads goed doet: het systematische deel van het werk. Elke controle op een account uitvoeren zonder er één te vergeten, de tracking toetsen aan wat het platform verwacht, creatieve vermoeidheid opsporen, break-evendrempels herberekenen, en duidelijk zeggen wat niet gecontroleerd kon worden. Dat is het objectieve, herhaalbare deel van een audit, het deel dat zelfs een goede consultant trager doet dan een machine.

Wat het niet doet: standaard de knoppen voor je indrukken, of de context kennen die je bureau kent: je seizoenspatronen, de tests die al mislukt zijn, de relatie met je contactpersoon bij Google. En zoals bij elke AI-uitvoer moet je de aanbevelingen controleren voordat je echt mediabudget inzet.

De juiste kijk: Claude Ads vervangt het oordeelsvermogen niet, het vervangt de gefactureerde uren om checklists af te werken. Voor een ondernemer die zijn eigen campagnes draait, is het een auditniveau dat hij niet had. Voor een bureau maakt het van de audit die een halve dag per account kostte een wekelijks controlemoment.

Claude Ads in AgentsRoom: je advertentieafdeling naast je dev-afdeling

Hier wordt het interessant als je al agents gebruikt om code te schrijven. Een vaardigheid als Claude Ads, met de hand in een terminal gestart, is een tool. Dezelfde vaardigheid, toevertrouwd aan een eigen agent in een multi-agent cockpit, is een bedrijfsonderdeel dat blijft draaien.

AgentsRoom is precies hiervoor gebouwd: elke agent heeft een rol, een live status en een eigen kleur, en je houdt toezicht op de hele vloot vanuit één venster. Niets dwingt je om alleen code-agents te draaien. Maak een agent met een advertentierol aan, installeer de Claude Ads-vaardigheid op zijn Claude Code, en hij wordt je junior media buyer: hij pakt audittickets op uit de backlog, voert zijn /ads-commando's uit en levert het rapport af als output.

De volledige lus ziet er zo uit. De Ads-agent voert /ads audit all uit op je exports van maandagochtend en zet zijn bevindingen in de backlog. De technische problemen die hij naar boven haalt (een GA4-conversie die dubbel wordt geteld, een verkeerd ingestelde Consent Mode, een landingspagina die te traag is) worden tickets die je dev-agent oppakt en in de code oplost, elk in een eigen worktree zodat agents die parallel draaien elkaar nooit in de weg zitten. Ondertussen houdt een SEO-agent de landingspagina's in lijn met de campagnes die live staan. Jij leest de rapporten, en jij keurt een wijziging goed voordat die een advertentieaccount bereikt.

Houd de Ads-agent op Claude Code, de enige tool die Claude Ads verifieert. Je code-agents kunnen draaien op elke CLI die je verkiest: AgentsRoom draait ze naast elkaar in hetzelfde venster, welke provider ook, en de compatibiliteitsmatrix toont wat ondersteund wordt.

De afdeling ernaast was altijd het moeilijkst te integreren: dev spreekt geen media, media spreekt geen dev. Een vloot agents die dezelfde backlog delen, dicht die kloof beter dan welk wekelijks overleg ook.

Veelgestelde vragen

Is Claude Ads gemaakt door Anthropic?

Nee. Claude Ads is een open source vaardigheid voor Claude Code, geschreven door Daniel Agrici en gepubliceerd onder de MIT-licentie op github.com/AgriciDaniel/claude-ads. Anthropic maakt Claude en Claude Code; de vaardigheid draait daarbovenop.

Toont Claude advertenties?

Nee. In zijn bericht van 4 februari 2026, Claude is a space to think, schreef Anthropic dat Claude advertentievrij blijft: geen gesponsorde links naast gesprekken, en geen antwoorden die door adverteerders worden beïnvloed. Claude Ads gaat over het controleren van je eigen advertentieaccounts, niet over advertenties in Claude.

Geeft Claude Ads nog een score op 100?

Niet in v2.1.0. Alle twaalf scoreprofielen voor de gezondheid van accounts zijn uitgeschakeld, dus de audit rapporteert bevindingen, onbekenden en de dekking door bewijs in plaats van een score. Elke controle eindigt in pass, fail, unknown of not_applicable, en unknown betekent dat de gegevens ontbraken.

Kan Claude Ads mijn advertentiecampagnes wijzigen?

Niet uit zichzelf. Elke adapter is standaard alleen-lezen en wijzigingen blijven concepten. Er een toepassen vereist een ingeschakelde mogelijkheid voor precies die bewerking, expliciete account- en object-ID's, een diff van voor en na, goedkeuring van de eigenaar binnen de limieten van het account, een rollback, en een controle dat het account sindsdien niet is veranderd. Definitief verwijderen wordt in v2 niet ondersteund.

Werkt Claude Ads met Codex of Gemini CLI?

Het installatieprogramma heeft doelen voor Codex, Gemini, Cursor, Windsurf en Goose, maar de README markeert ze als experimenteel: alleen Claude Code is geverifieerd. Installeer het op Claude Code als je het ondersteunde pad wilt.

Installeer de vaardigheid, voer je eerste /ads audit uit, en als je wilt dat het zonder jou draait: download AgentsRoom en geef je advertentieafdeling dezelfde infrastructuur als je dev-afdeling.