Claude Ads: reklam hesaplarını denetleyen Claude Code skill'i

Belki Instagram'da o videoyu görmüşsündür: "ayda 3.000'e mal olan reklam ajansının işini on dakikada yap." Biraz satış kokan bu hook'un ardında gerçek bir açık kaynak proje var: Claude Ads, reklam hesabı verilerini okuyup neyin çalıştığını, neyin bozuk olduğunu ve önce neyi düzeltmen gerektiğini söyleyen bir Claude Code skill'i. Ekim 2026 itibarıyla GitHub'da 10.000'den fazla yıldız, MIT lisansı.

16 Ekim 2026'da çıkan Claude Ads v2.1.0 için 21 Ekim 2026'da güncellendi. Bu makalenin ilk sürümü v1.7.1'i anlatıyordu. v2'den beri skill sekiz yerine on iki platformu kapsıyor, artık 100 üzerinden puan üretmiyor ve yazarları, eskiden gösterdiğimiz tek satırlık kuruluma karşı artık uyarıyor. Aşağıdaki her şey v2.1.0 README'si ve skill dosyalarıyla karşılaştırılarak doğrulandı.

Claude Ads tam olarak nedir

Claude Ads, Daniel Agrici tarafından oluşturulmuş bir Claude Code skill'i. Skill, kod ajanının ihtiyaç duydukça yüklediği bir talimat, referans ve ajan paketidir: burada, modüllere bölünmüş bir ücretli medya denetçisinin uzmanlığı. Bu bir Anthropic ürünü değil ve Claude içindeki reklamlarla hiçbir ilgisi yok: Anthropic, Claude'un reklamsız kalacağını Şubat 2026'da yazdı.

İki yerden geliyor: AgriciDaniel/claude-ads adresindeki herkese açık sürüm (MIT, üyelik gerekmez) ve ücretli bir topluluğun üyelerinin erken erişim aldığı AI-Marketing-Hub/claude-ads adresindeki topluluk aynası.

v2.1.0'ın içinde neler var:

• 12 reklam platformu: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat ve X.
• Tek bir /ads komutunun arkasında 33 skill: her platform için bir tane, artı yatay olanlar (atribüsyon, sunucu taraflı izleme, kreatif, açılış sayfaları, bütçe, planlama, raporlama).
• 25 ajan tanımı: platform başına bir denetim çalışanı, izleme, bütçe, kreatif, platform kuralları ve mevzuata uyum için çalışanlar, dört kreatif ajan (metin yazarı, kreatif stratejist, format uyarlayıcı, görsel tasarımcı) ve araştırma ile doğrulama ajanları.
• Kontrol başına dört olası sonuç: pass, fail, unknown veya not_applicable. Unknown, verinin eksik olduğu anlamına gelir ve skill onu asla tahmin etmez.
• Şimdilik sağlık puanı yok. Proje kendini bir geliştirme adayı olarak tanımlıyor ve on iki hesap sağlığı puanlama profilinin tümü devre dışı. Bunun yerine denetim bulguları, bilinmeyenleri ve kanıt kapsamını raporluyor: %80 ve üzeri kapsam notlandırılır, %60 ile %79 arası geçicidir, %60'ın altı yetersiz kanıt demektir.

Başka yerlerde okumuş olabileceğin eski rakamlar, 250 kontrol, A'dan F'ye harf notuyla 100 üzerinden puan, sekiz platform, v1'i anlatıyor. Skill artık kendisi hakkında bunları söylemiyor.

Kaputun altında nasıl çalışıyor

Bir orkestra şefi çalıştırmanın kapsamını, kuralları, birleştirmeyi ve nihai raporu üstlenir. Çalışanlar her biri bir platform ya da bir konu olmak üzere sınırlı dilimleri analiz eder ve bulgularını sabit bir şemayla döndürür. Zorunlu bir çalışan başarısız olursa çalıştırma kısmi olarak işaretlenir: asla tam bir denetim gibi sunulmaz.

Kur, denetle, incele: resmi repodan v2 akışının üç adımı.

Claude Code'u zaten kod yazmak için kullanıyorsan bu kalıbı tanıyacaksın: alt ajanlar ve ajan ekipleri mekanizması, kod yerine pazarlamaya uygulanmış hali. v2.1.0'dan beri ajanlar artık bir model sabitlemiyor: daha özel bir ayar yoksa Claude Code onları ana konuşmanın modeliyle çalıştırıyor.

Bir çalıştırmanın sonucu sürümlenmiş bir JSON dosyasıdır. Markdown, HTML ve PDF raporları aynı dosyanın görüntülemeleridir, bu yüzden /ads report hiçbir şey çalıştırmadan geçmiş bir çalıştırmayı yeniden gösterebilir.

Pratikte akış beş adıma sığar:

1. /ads setup komutunu çalıştır ve sorularını yanıtla: iş modeli, hedef, ana dönüşüm, aylık harcama, aktif platformlar ve değişiklikleri kimin onayladığı. Buraya asla API anahtarı veya token yapıştırmaman gerektiğini söyler.
2. Kanıt getir: CSV veya JSON formatında bir hesap dışa aktarımı, ekran görüntüleri ya da tarih aralığı, para birimi ve saat dilimiyle yapıştırılmış bir özet.
3. /ads audit google veya /ads audit all çalıştır. Neyin geçtiğini, neyin kaldığını ve neyin eksik olduğunu görürsün.
4. Geçmiş bir çalıştırmayı yeniden görmek için /ads report çalıştır.
5. En önemli engeli görmek için /ads next çalıştır.

On iki platform

Her platformun kendi skill'i, kendi denetim çalışanı, kendi kontrol referansı ve kendi yetenek beyanı var. Repodaki bir yetenek manifestosu, her platformda neyin canlı olarak okunabileceğinin veya değiştirilebileceğinin kaydıdır. Platformların üstüne yatay denetimler gelir: atribüsyon (dönüşüm tanımları, pencereler, GA4, mobil ölçüm ortakları) ve sunucu taraflı izleme (sunucu taraflı etiketleme, Conversions API ve Events API, tekilleştirme, olay verisi kalitesi). Bunlar genellikle insan denetimlerinin kör noktalarıdır, çünkü hem medya hem teknik beceri gerektirirler.

Komutlar

Her şey /ads üzerinden yürür. Claude Code eklentisi olarak kurulduğunda komutlar bir ad alanı alır ve /claude-ads:ads ile başlar; bağımsız kurulduğunda /ads ile başlar. README şunları listeliyor:

Platform kısayolları doğrudan tek bir denetime gider: /ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon, /ads reddit, /ads pinterest, /ads snapchat ve /ads x.

v1'in uzman komutları hâlâ skill tarafından yönlendiriliyor: bir web sitesinin marka ve teklif profili için /ads dna, /ads attribution, /ads tracking, /ads creative, /ads landing, /ads budget, CPA, ROAS, MER, LTV:CAC ve başabaş noktası için /ads math, /ads competitor, onaylanmış bir briften görseller için /ads generate, ürün fotoğrafı varyantları için /ads photoshoot ve /ads experiment'in diğer adı olarak /ads test. Düz dille yazılmış bir istek de aynı skill'lere gider. Hiçbir skill video üretmez: video çalışması konseptler ve briflerde durur.

Güvenle kur

Yazarlar artık bunu açıkça yazıyor: aracının eklenti akışını ya da sağlama toplamıyla doğrulanmış bir sürüm arşivini tercih et ve uzaktaki bir kurulum betiğini asla doğrudan bir shell'e yönlendirme. Bu makalenin ilk sürümü tam olarak bunu gösteriyordu, bir curl | bash ve bir irm | iex: bunları kullanma.

Claude Code içinde, eklenti akışı:

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

Marketplace'i v2.0.0'dan önce eklediysen Claude Code onu hâlâ eski bir takma adla tutuyor. Önce onu kaldır:

/plugin marketplace remove agricidaniel-claude-ads

macOS veya Linux'ta, okuduğun bir klondan:

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

Windows'ta, PowerShell'de, aynı klondan: .\install.ps1 -Source local.

Bir sürümü sabitlemek için bash install.sh --source=git --ref=v2.1.0 tam olarak o etiketi çeker ve etiket bulunamazsa başarısız olur. Doğrulanmış yol yine bir sürüm zip'idir: her GitHub sürümü zip'i, bir manifestoyu, bir yazılım malzeme listesini ve bir SHA256SUMS dosyasını yayımlar ve arşivi açmadan önce sha256sum -c SHA256SUMS komutunun her satırı OK demelidir. Sürümlerin sağlama toplamı var ama imzası yok.

Gerekenler: yönetilen bağımlılıklar için CPython 3.11 veya 3.12, Linux'ta glibc 2.28 veya üzeri, PDF raporları için WeasyPrint ve Pango kütüphaneleri ve tarayıcı yakalamaları istiyorsan bir Playwright tarayıcısı.

Kurulum aracında ayrıca --target=codex, --target=gemini ve Cursor, Windsurf ve Goose için hedefler var. README bunları deneysel olarak işaretliyor: yalnızca Claude Code doğrulanmış ve diğer araçlar aynı dosyaları farklı şekilde işleyebilir.

Videodaki iş akışı, yeniden

Skill'i ünlü yapan Instagram videosu üç adım gösteriyor. İşte v2.1.0 ile halleri.

Adım 1: skill'i kur. Yukarıdaki eklenti akışıyla, yapıştırılmış tek bir satırla değil.

Adım 2: işini anlat, sonra planla. /ads setup teklifini, hedefini, dönüşümünü, bütçeni ve platformlarını sorar. Bir web siten varsa /ads dna <url> marka ve teklif profilini çıkarır, böylece plan gerçek konumlandırmandan başlar. Ardından /ads plan kanal, kampanya, bütçe ve ölçüm planını oluşturur.

Adım 3: rapor. /ads report kaydedilmiş çalıştırmayı Markdown, HTML veya PDF olarak oluşturur, bir müşteriye ya da yönetimine göndermeye hazır.

Videonun basitleştirdiği yer: çıktı, kanıt ne kadar iyiyse o kadar iyidir. Belirsiz yanıtlar verirsen belirsiz bir plan alırsın. Dışa aktarım veya ekran görüntüsü olmadan bir denetim çalıştırırsan unknown dolu bir rapor alırsın: bu dürüst bir tavır, ama bir teşhis değil. Ve v2.1.0'da gösteriş yapılacak bir puan yok: bulguları ve hesabın ne kadarının değerlendirilebildiğini alırsın.

Verilerin ve hesapların

Skill senin terminalinde çalışır ve ona verdiğin kanıtları analiz eder. Kimlik bilgilerinin yeri ortam değişkenleri, işletim sisteminin anahtar zinciri veya bir gizli bilgi yöneticisidir; asla repo, profiller, raporlar veya loglar değil.

v1'den bu yana en büyük değişiklik yazma tarafında. v2'de /ads launch ve /ads optimize var, ama her adaptör varsayılan olarak salt okunurdur ve değişiklikler taslak olarak kalır. Birini uygulamak için skill'in bu altı koşulun hepsine ihtiyacı var:

1. tam o işlem için test edilmiş ve etkinleştirilmiş bir yetenek;
2. açık hesap ve nesne kimlikleri;
3. neyi etkilediğiyle birlikte okunabilir bir öncesi ve sonrası diff'i;
4. hesap için belirlenmiş limitler içinde sahibin onayı;
5. bir idempotency anahtarı, bir denetim kaydı hedefi, bir geri alma planı ve bir doğrulama penceresi;
6. hesabın hâlâ değişikliğin beklediğiyle eşleştiğinin kontrolü.

Belirlenmiş limit yoksa yazma da yok, ve kalıcı silme v2'de desteklenmez.

Neyin yerini alıyor, neyin almıyor

Dürüst olalım, çünkü "ayda 3.000'lik ajansının yerini al" sözü nüansı hak ediyor.

Claude Ads'in iyi yaptığı şey: işin sistematik kısmı. Bir hesapta tek bir kontrolü bile unutmadan hepsini çalıştırmak, izlemeyi platformun beklediğiyle karşılaştırmak, kreatif yorgunluğunu fark etmek, başabaş eşiklerini yeniden hesaplamak ve neyin kontrol edilemediğini açıkça söylemek. Bu, bir denetimin nesnel ve tekrarlanabilir kısmı, iyi bir danışmanın bile bir makineden daha yavaş yaptığı kısım.

Yapmadığı şey: varsayılan olarak düğmelere senin yerine basmak ya da ajansının bildiği bağlamı bilmek: sezonsallığın, daha önce başarısız olan testler, Google temsilcinle ilişkin. Ve her yapay zeka çıktısı gibi, gerçek medya bütçesi harcamadan önce önerileri kontrol edilmeli.

Doğru çerçeve: Claude Ads muhakemenin yerini almıyor, kontrol listelerini gözden geçirmek için faturalanan saatlerin yerini alıyor. Kendi kampanyalarını yöneten bir girişimci için bu, daha önce sahip olmadığı bir denetim seviyesi. Bir ajans için hesap başına yarım gün süren denetim haftalık bir kontrol noktasına dönüşüyor.

AgentsRoom'da Claude Ads: geliştirme biriminin yanında reklam birimin

Kod yazmak için zaten ajan kullanıyorsan işin ilginçleştiği yer burası. Claude Ads gibi bir skill, terminalde elle başlatıldığında bir araçtır. Aynı skill, çok ajanlı bir kokpitte özel bir ajana verildiğinde çalışmaya devam eden bir iş birimidir.

AgentsRoom tam olarak bunun için yapıldı: her ajanın bir rolü, canlı bir durumu ve kendi rengi var ve tüm filoyu tek bir pencereden denetliyorsun. Hiçbir şey seni yalnızca kod ajanları çalıştırmaya zorlamıyor. Reklam rolüne sahip bir ajan oluştur, onun Claude Code'una Claude Ads skill'ini kur, o da senin junior medya satın alma uzmanın olur: backlog'dan denetim ticket'larını alır, /ads komutlarını çalıştırır ve raporu çıktı olarak bırakır.

Tam döngü şöyle görünüyor. Ads ajanı pazartesi sabahı dışa aktarımların üzerinde /ads audit all çalıştırır ve bulgularını backlog'a koyar. Ortaya çıkardığı teknik sorunlar (iki kez sayılan bir GA4 dönüşümü, yanlış yapılandırılmış bir Consent Mode, fazla yavaş bir açılış sayfası) geliştirici ajanının alıp kodda düzelttiği ticket'lara dönüşür, her biri kendi worktree'sinde, böylece paralel çalışan ajanlar asla birbirinin ayağına basmaz. Bu sırada bir SEO ajanı açılış sayfalarını yayındaki kampanyalarla uyumlu tutar. Raporları sen okursun ve bir değişikliği reklam hesabına ulaşmadan önce onaylayan da sensin.

Ads ajanını, Claude Ads'in doğruladığı tek araç olan Claude Code'da tut. Kod ajanların tercih ettiğin herhangi bir CLI'da çalışabilir: AgentsRoom onları aynı pencerede yan yana çalıştırır, sağlayıcı hangisi olursa olsun, ve uyumluluk matrisi neyin desteklendiğini listeler.

Yan birim her zaman entegre edilmesi en zor olanı oldu: geliştirme medyanın dilini konuşmaz, medya geliştirmenin dilini konuşmaz. Aynı backlog'u paylaşan bir ajan filosu bu boşluğu herhangi bir haftalık toplantıdan daha iyi kapatır.

Sıkça sorulan sorular

Claude Ads'i Anthropic mi yaptı?

Hayır. Claude Ads, Daniel Agrici'nin yazdığı ve MIT lisansıyla github.com/AgriciDaniel/claude-ads adresinde yayımladığı, Claude Code için açık kaynak bir skill. Anthropic, Claude ve Claude Code'u yapıyor; skill bunların üzerinde çalışıyor.

Claude reklam gösteriyor mu?

Hayır. Anthropic, 4 Şubat 2026 tarihli Claude is a space to think yazısında Claude'un reklamsız kalacağını yazdı: konuşmaların yanında sponsorlu bağlantı yok, reklamverenlerin etkilediği yanıt yok. Claude Ads, Claude içindeki reklamlarla değil, kendi reklam hesaplarını denetlemekle ilgili.

Claude Ads hâlâ 100 üzerinden puan veriyor mu?

v2.1.0'da vermiyor. On iki hesap sağlığı puanlama profilinin tümü devre dışı, bu yüzden denetim puan yerine bulguları, bilinmeyenleri ve kanıt kapsamını raporluyor. Her kontrol pass, fail, unknown veya not_applicable ile biter; unknown, verinin eksik olduğu anlamına gelir.

Claude Ads reklam kampanyalarımı değiştirebilir mi?

Kendi başına değiştiremez. Her adaptör varsayılan olarak salt okunurdur ve değişiklikler taslak olarak kalır. Bir değişikliği uygulamak için tam o işlem için etkinleştirilmiş bir yetenek, açık hesap ve nesne kimlikleri, öncesi ve sonrası diff'i, hesabın limitleri içinde sahibin onayı, bir geri alma planı ve hesabın o zamandan beri değişmediğinin kontrolü gerekir. Kalıcı silme v2'de desteklenmez.

Claude Ads, Codex veya Gemini CLI ile çalışıyor mu?

Kurulum aracında Codex, Gemini, Cursor, Windsurf ve Goose hedefleri var, ama README bunları deneysel olarak işaretliyor: yalnızca Claude Code doğrulanmış. Desteklenen yolu istiyorsan onu Claude Code'a kur.

Skill'i kur, ilk /ads audit komutunu çalıştır ve senin yokluğunda da çalışmasını istiyorsan: AgentsRoom'u indir ve reklam birimine geliştirme biriminle aynı altyapıyı ver.