İçeriğe atla
← Hazır setler ve kurulum rehberleri

Kurulum rehberi · son kontrol 17 Ekim 2026

Rakiplerin reklamlarını inceleyip, kendi müşteri adaylarını sıralayan analiz sistemi

İki ayrı yol: rakiplerin yayındaki reklamlarını kaynaklı bir gözlem raporuna dönüştürmek ya da kendi/izinli aday listeni açık ölçütlerle sıralayıp takip görevi çıkarmak. Claude Ads'in denetim komutu yalnız kendi hesabının dışa aktarımına bakar.

Resmî belgelerden düzenlendi. Her adımın dayanağı altında yazılı.

Ne elde edersin

Rakip yolunda kaynağı ve tarihi yazılı bir karşılaştırma raporu; aday yolunda ölçütlerle puanlanmış bir aday listesi ve sorumluya verilmiş takip görevleri.

Nasıl çalışır

Sen başlatırsın. Her çalıştırmayı sen başlatırsın; sistem kendiliğinden tekrar etmez, hiçbir hesapta değişiklik yapmaz, kimseye mesaj göndermez. Aday yolunda listeni kullandığın hizmetlere (Claude, istersen Clay) yüklersin.

Nerede çalışır

Windows · macOS · Linux · Tarayıcı

Maliyet neye bağlı

Abonelik · Ücret yok · API kullanımı · Kurulum hizmeti

Kime uygun

  • Rakiplerinin hangi mesajı ve formatı kullandığını düzenli görmek isteyen işletme sahipleri ve ajanslar
  • Elindeki izinli müşteri adayı listesini kriterlere göre sıralayıp takip işini sorumluya vermek isteyen satış ve pazarlama ekipleri

Kime uygun değil

  • Takipçi listesi ya da e-posta kazıyıp aday listesi yapmak isteyenler
  • Toplu doğrudan mesaj ya da otomatik WhatsApp zinciri göndermek isteyenler
  • Reklam hesabının kendi kendine harcama yapmasını ya da kampanya yönetmesini isteyenler
  • Rakibin reklamda görünmesini o reklamın kârlı olduğunun kanıtı sayanlar

Sistem nasıl bağlanıyor

Rakip yolu: Meta Reklam Kütüphanesi gözlemleri → Claude'da kaynaklı rapor; kendi reklam hesabın varsa dışa aktarımı Claude Ads ile ayrıca denetlenir (denetim komutu /ads audit rakiplere değil, kendi dışa aktarımına bakar; rakip raporunu Claude'a gözlem tablosuyla sen yazdırırsın). Aday yolu: izinli liste → ölçütle sıralama → takip görevi; Clay isteğe bağlı.

  • Claude Code gerekli

    Gözlem tablosundan raporu ve aday sıralamasını yazdıran çalışma ortamı

    Araç rehberi

  • Claude Ads isteğe bağlı

    Kendi reklam hesabının dışa aktarımını denetleyen eklenti (/ads audit, salt okuma). Eklentide ayrıca şeffaf kaynaklardan rakip araştırması yapan /ads competitor yeteneği var; bu rehber onu kullandırmaz

    Alternatif: Reklam hesabın yoksa bu aracı kurma; rapor yalnız gözlemlere dayanır

    Araç rehberi

  • Meta Reklam Kütüphanesi gerekli

    Rakiplerin yayındaki reklamlarını gözlemlemek

    Alternatif: Kütüphane yerine arama, izleme ve yapay zekâ içgörüsü sunan bir araç istiyorsan Atria

    Aracı tanı

  • Atria isteğe bağlı

    Ek rakip reklam arama aracı; kapsamı Meta Reklam Kütüphanesi ile aynı değildir (Atria'nın kendi kütüphanesi)

    Alternatif: Meta Reklam Kütüphanesi'nin arayüzü yetmiyorsa ve ücretsiz hesapta deneyip beğenirsen

    Araç rehberi

  • Clay isteğe bağlı

    İsteğe bağlı: büyük listeyi düzenlemek; küçük listeyi CSV olarak doğrudan Claude'a verebilirsin

    Alternatif: Verini zaten bir CRM'de düzenleyebiliyorsan; Clay şart değil

    Araç rehberi

Araçlar arası bağlantılar

  • Meta Reklam Kütüphanesi Gözlem tablosu (CSV) · Elle aktarım · Gördüğün reklamın kaynağını, tarihini, mesajını ve biçimini sen tabloya yazarsın
  • Atria Claude · MCP ile bağlı · Claude'da özel bağlayıcı (claude.ai) ya da Claude Code'da claude mcp add; adres https://api.tryatria.com/mcp, Atria hesabınla giriş · izin: Atria kütüphanesini arama ve çalışma alanını okuma; değişiklik ve silme için onay ister
  • Kendi reklam hesabın Claude Ads · Dosya ile · Hesaptan aldığın CSV ya da JSON dışa aktarım dosyası
  • Aday listesi Clay · Dosya ile · CSV dosyası içe aktarılır, sütunlar eşlenir
  • Sıralanmış liste Takip görevi · Elle aktarım · Sorumluya görevi sen CRM'inde ya da görev listende verirsin

Başlamadan önce

Bilgisayar ve yazılım

  • İşletim sistemi: Windows, macOS, Linux, Tarayıcı
  • Claude Code: Güncel sürüm
  • Git: Güncel sürüm (depoyu etiketle indirmek için)
  • Python: 3.11 ya da 3.12 (Claude Ads'in yönetilen bağımlılıkları için; Windows'ta 64 bit)

Hesaplar

  • Claude Code erişimi olan hesap — Claude Ads yalnız Claude Code'da doğrulanmış çalışır. Pro, Max, Team, Enterprise ya da Console hesabı; ücretsiz claude.ai planı Claude Code erişimi içermez
  • Atria hesabı (isteğe bağlı) — Rakip reklam aramak ve izlemek için Meta Reklam Kütüphanesi'ne alternatif. Kalıcı ücretsiz plan var (bir reklam hesabı, bir marka); ücretsiz planda rakip takibinin ve MCP'nin açık olup olmadığı yazılı değil, önce ücretsiz hesapta deneyerek gör
  • Clay hesabı (yalnız aday yolu, isteğe bağlı) — Aday listesini içe aktarıp düzenlemek. Ücretsiz plan var: fiyat sayfası tablo başına 200 satır, ayda 500 eylem ve 100 veri kredisi yazıyor. Clay'in iki başka belgesi farklı sınır söylüyor (eski SSS: 50 satır, tarihsiz; kaynaklar belgesi: tüm planlarda 50.000 satır); kendi hesabındaki sınırı tablo ekranında kontrol et

Adım adım kurulum

Hangisini yapmak istiyorsun?

İşaretlediğin adımlar yalnız bu tarayıcıda kalır; kurulumun çalıştığını doğrulamaz. 0/8 adımı bitirdin.

  1. 1. adım · Kod editöründe

    Rakipleri ve sorularını yaz

    Ne için: Gözlemin neye cevap vereceği baştan belli olsun.

    1. Üç-beş rakip seç ve bir klasörde 'gozlem.csv' adlı bir tablo aç. Sütunlar: rakip, kütüphane kodu, kaynak adresi, kütüphanede yazan yayın başlangıç tarihi, senin gördüğün tarih, format (görsel, video), mesaj, çağrı, performans.
    2. Performans sütununu boş bırak. Rakibin reklamı kütüphanede görünüyor diye işe yaradığını varsayma; performans verin yoksa 'bilinmiyor' yaz.
    3. Cevap aradığın iki-üç soruyu yaz (ör. hangi mesaj tekrar ediyor, hangi çağrı kullanılıyor).

    Doğru yaptığını şuradan anlarsın

    • Klasörde başlıkları hazır bir gozlem.csv ve sorular yazılı.
  2. 2. adım · Tarayıcıda

    Reklam Kütüphanesi'nde rakip reklamlarını gözle

    Ne için: Rakiplerin yayındaki reklamları kaynağıyla not edilsin.

    1. Meta Reklam Kütüphanesi'ni aç (facebook.com/ads/library). Meta'nın yardım sayfası kütüphaneyi herkesin görüp arayabildiğini yazıyor; hesap açmadan kullanabilirsin. Alkol, kumar gibi yaş kısıtlı reklamların görselleri ve arama sonuçlarını indirme için Facebook girişi gerekir.
    2. Aramadan önce ülkeyi seç (Türkiye ya da rakibin hedeflediği ülke) ve Reklam Kategorisi olarak 'Tüm Reklamlar'ı seç; varsayılan arama siyasi reklamlar olabilir. Sonra rakibin sayfa adını ya da bir anahtar sözcüğü yaz.
    3. Her reklam için kütüphane kodunu, adresi, kütüphanede yazan yayın başlangıç tarihini, senin gördüğün tarihi, mesajı, biçimi ve çağrıyı gozlem.csv'ye yaz. Gördüğün ile yorumun ayrı sütunlarda dursun.
    4. Kütüphanenin API'si ayrı bir araçtır ve yetkilendirilmiş kullanıcılar içindir; bu rehber API'yi kullanmaz.

    Doğru yaptığını şuradan anlarsın

    • gozlem.csv'de her satırın bir kaynak adresi ve tarihi var; performans sütunu bilinmiyorsa boş ya da 'bilinmiyor'.
    Takılırsan: bu adıma özgü sorunlar
    • Rakibin reklamı kütüphanede çıkmıyor
      Reklam Kategorisi 'Tüm Reklamlar' değilse ticari reklam çıkmaz; kategoriyi ve ülkeyi kontrol et. Yine bulunmazsa reklam yayında olmayabilir; kütüphane yayındaki reklamları gösterir. Satırı 'bulunamadı' diye not et.
  3. 3. adım · Bir uygulamada

    İstersen Atria'yı Claude'a bağla

    Ne için: Kütüphane yerine Atria ile aramak ve çalışma alanını Claude'dan okumak.

    1. Atria'da hesap aç (kalıcı ücretsiz plan var, kart istemez; kesin sınırları Atria yayımlamıyor). Ücretsiz planda rakip takibinin ve MCP'nin açık olup olmadığı yazılı değil, önce ücretsiz hesapta Atria kütüphanesinde arayıp dene.
    2. claude.ai'de Settings > Connectors'a git, 'Atria' adında özel bağlayıcı ekle, adres olarak https://api.tryatria.com/mcp yaz, Add ve Connect'e bas, açılan pencerede Atria'ya giriş yap. Claude Code kullanıyorsan aşağıdaki komutu çalıştır (komut Claude Code belgesindeki uzak MCP biçimidir; Atria belgesi Claude Code için ayrıca komut vermiyor).
    3. claude.ai'de eklenen bağlayıcılar Claude Code'da yalnız claude.ai abonelik girişiyle görünür; API anahtarı ya da Console girişinde yüklenmeyebilir.
    4. Bulduğun reklamları yine kaynak adresi ve tarihiyle gozlem.csv'ye yaz. Atria kendi kütüphanesinde arar; Meta'daki yayındaki tüm reklamların kopyası olduğu varsayılmamalı. Atria'daki performans verisi senin bağladığın reklam hesaplarına aittir, rakibe değil.
    Windows · macOS · LinuxKlasör: Çalışma klasörün
    › claude mcp add --transport http atria https://api.tryatria.com/mcp

    Doğru yaptığını şuradan anlarsın

    • Claude, Atria kütüphanesinde arama yapabiliyor; ücretsiz planda MCP kapalıysa arama Atria'nın web arayüzünde yapılır.
    Takılırsan: bu adıma özgü sorunlar
    • Bağlayıcı çalışmıyor ya da MCP çağrıları beklenenden çabuk bitiyor
      Atria'nın kaynakları MCP ücretinde çelişiyor: fiyat sayfası Core planda ayda 600 MCP çağrısı yazıyor, yardım makalesi MCP'nin şimdilik her planda ücretsiz olduğunu ve kredi çekmediğini yazıyor. Planını Atria'dan kontrol et.
  4. 4. adım · Tarayıcıda

    Kendi reklam hesabının dışa aktarımını hazırla (varsa)

    Ne için: Rakip gözlemlerini kendi performans verinle karşılaştırabilmek.

    1. Kendi reklam hesabından CSV ya da JSON dışa aktarımı al (nasıl alınacağı platformun kendi yardım sayfasındadır). Tarih aralığını, para birimini ve saat dilimini not et.
    2. Dosyayı çalışma klasörüne koy. Hesap bilgilerini, anahtar ya da parolaları Claude'a yapıştırma.
    3. Reklam hesabın yoksa bu adımı atla; rapor yalnız gözlemlere dayanır ve performans yazmaz.

    Doğru yaptığını şuradan anlarsın

    • Klasörde tarih aralığı not edilmiş bir dışa aktarım dosyası var (ya da bu adım bilinçli atlandı).
    Takılırsan: bu adıma özgü sorunlar
    • Dışa aktarım sütunları analizde tanınmıyor
      Claude Ads her platformun yerel dışa aktarım biçimini tanımaz (Amazon ve X için normalleştirme kapalı); sütunları Claude'a göstererek eşlemeni iste ve bilinmeyeni 'bilinmiyor' bırak.
  5. 5. adım · Terminalde

    Claude Ads'i etiketli sürümden kur (yalnız reklam hesabın varsa)

    Ne için: Reklam dışa aktarımını okuyacak eklentiyi sabit sürümle kurmak.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Reklam hesabın yoksa bu adımı ve sonraki Claude Ads adımını atla; rapor yalnız gozlem.csv'ye dayanır.
    2. Proje kendini geliştirme adayı olarak tanımlıyor ve yalnız Claude Code doğrulanmış; kurulum tamamen isteğe bağlı. README'ye göre git etiketi doğrulanmış sürüm değil. Doğrulanmış yol: release sayfasındaki dört dosyayı (zip, release-manifest.json, sbom.cdx.json, SHA256SUMS) boş bir klasöre indir, doğrulamayı çalıştır, her satır OK ise zipi aç. Aşağıdaki git clone doğrulamasız kısa yoldur.
    3. Doğrulama (macOS/Linux): sha256sum -c SHA256SUMS (macOS'ta shasum -a 256 -c SHA256SUMS). Windows için README'de komut yok; PowerShell'de Get-FileHash <zip> özetini SHA256SUMS içindeki satırla elle karşılaştırabilirsin. Bu yalnız indirmenin bozulmadığını gösterir, kaynağın kanıtı değildir.
    4. Windows PowerShell'de .\install.ps1 -Source local, macOS ve Linux'ta bash install.sh --source=local çalıştır. Python 3.11/3.12 yoksa ya da uymuyorsa yalnız eklenti dosyaları için Windows'ta -NoDeps, macOS/Linux'ta --no-deps ekle (Python yardımcıları kurulmaz).
    5. Proje Python bağımlılık paketlerinin Windows ve macOS'ta yerel CI ile henüz nitelendirilmediğini yazıyor; Windows'ta kurulum takılırsa hata metniyle destek iste.
    6. Claude Code'u aç ve /ads setup ile iş modelini, hedefini ve aylık harcamanı gir. API anahtarı ya da parola girme.
    7. Alternatif: README'nin ilk sıradaki yolu eklenti pazaryeridir (/plugin marketplace add agricidaniel/claude-ads, sonra /plugin install claude-ads@ai-marketing-hub-claude-ads); komut /claude-ads:ads olur.
    LinuxKlasör: Dört dosyayı indirdiğin boş klasör
    › sha256sum -c SHA256SUMS
    macOSKlasör: Dört dosyayı indirdiğin boş klasör
    › shasum -a 256 -c SHA256SUMS
    Windows · macOS · LinuxKlasör: Çalışma klasörün
    › git clone --branch v2.1.0 --depth 1 https://github.com/AgriciDaniel/claude-ads.git

    Sürüm sabit (16 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    WindowsKlasör: claude-ads
    › .\install.ps1 -Source local
    WindowsKlasör: claude-ads
    › .\install.ps1 -Source local -NoDeps
    macOS · LinuxKlasör: claude-ads
    › bash install.sh --source=local
    macOS · LinuxKlasör: claude-ads
    › bash install.sh --source=local --no-deps

    Doğru yaptığını şuradan anlarsın

    • Claude Code'da /ads komutları görünür ve /ads setup sorularını sorar.
    Takılırsan: bu adıma özgü sorunlar
    • Kurulum Python sürümü yüzünden duruyor
      Yönetilen bağımlılıklar CPython 3.11 ya da 3.12 ister; desteklenmeyen sürüm kurulumdan önce hata verir. Uygun Python'u kur ya da -NoDeps (--no-deps) ile yalnız eklenti dosyalarını kur.
    • /ads komutu görünmüyor
      Claude Code'u kapatıp yeniden aç. Eklentiyi pazar yeri komutuyla kurduysan komut /claude-ads:ads biçiminde olabilir; bu rehber kopyadan kurulumu anlatır.
  6. 6. adım · Kod ajanında

    Kendi verini Claude Ads ile analiz ettir

    Ne için: Kendi reklamlarının bulguları, eksik veriyle birlikte ortaya çıksın.

    1. Reklam hesabın yoksa bu adımı atla. Bu rehber Claude Ads'te yalnız /ads audit komutunu kullandırır; o komut kendi hesabının dışa aktarımını denetler. Eklentide şeffaf kaynaklardan rakip araştırması yapan ayrı bir /ads competitor yeteneği de var (v2.1.0); bu rehber onu kullandırmaz. Rakip raporunu gozlem.csv ile Claude Code'a yazdırırsın.
    2. Claude Code'da /ads audit meta (veya ilgili platform) çalıştır ve dışa aktarım dosyasını göster. Rapor geçen, kalan ve kontrol edilemeyen maddeleri kanıtıyla birlikte verir.
    3. Hesap sağlık puanı beklenmez: Claude Ads'te puanlama profilleri kapalı ve hesap değişikliği yapmaz; bulgu, bilinmeyen ve kanıt kapsamı verir.
    4. Bilinmeyen çıkan maddeleri hangi veri eksik diye not et.

    Doğru yaptığını şuradan anlarsın

    • Rapor, geçen/kalan/bilinmeyen maddeleri ve eksik veriyi listeliyor; puan ya da otomatik değişiklik yok.
    Takılırsan: bu adıma özgü sorunlar
    • Rapor puan vermiyor
      Bu beklenen davranış: tüm platformlarda sağlık puanı profilleri kapalı; bulguları ve bilinmeyenleri oku.
  7. 7. adım · Kod ajanında

    Kaynaklı karşılaştırma raporunu yazdır

    Ne için: Gözlemlerin ve kendi verin yan yana, kaynağıyla okunsun.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Claude'a gozlem.csv'yi ve analiz çıktısını ver; her cümlenin yanında kaynak adresi ve tarih olmasını, performans bilinmeyen yerde 'bilinmiyor' yazılmasını iste.
    2. Gördüklerini (mesaj, format, çağrı) ve Claude'un yorumunu ayrı bölümlerde istedin mi kontrol et.
    3. 'En iyi reklam bu' türü iddiaları sil: kütüphanede görünmek kârlılığı göstermez.

    Doğru yaptığını şuradan anlarsın

    • Raporda her gözlemin kaynağı ve tarihi var, performans bilinmiyorsa belirtilmiş, yorumlar gözlemlerden ayrı.
  8. 8. adım · Bir uygulamada

    Kararı sen ver

    Ne için: Rapor karar için okunsun; hiçbir hesapta değişiklik yapılmasın.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Raporu oku ve test edeceğin fikirleri sen seç. Kendi reklamında bir değişiklik yapacaksan bunu platformda sen yaparsın.
    2. Claude Ads hesabına yazmaz; öneri taslak kalır.

    Doğru yaptığını şuradan anlarsın

    • Seçtiğin fikirlerin listesi var; reklam hesabında kendiliğinden yapılmış bir değişiklik yok.

Kurulum çalışıyor mu? Şunlara bak

  • Rapordaki her gözlemin yanında kaynak adresi ve tarih var; performans bilinmiyorsa 'bilinmiyor' yazıyor.
  • Reklam hesabın varsa Claude Ads kendiliğinden değişiklik yapmadı; analiz bulgu, bilinmeyen ve eksik veriyi gösteriyor.
  • Aday listesindeki her puanın açık bir gerekçesi var ve sorumluya atanmış görev dışında hiçbir şey gönderilmedi.

Neye para ödenir

Kalemler ayrıdır ve toplam değildir; hangilerinin sana gerektiği kurduğun yola bağlıdır. Fiyatlar değişir, her kalemin kaynağına bak.

  • AbonelikClaude Code hesabı

    Pro, Max, Team, Enterprise ya da Console hesabı gerekir; fiyat için Anthropic'in sayfasına bak. kaynak

  • Ücret yokClaude Ads

    Açık kaynak ve MIT lisanslı; proje kendini geliştirme adayı olarak tanımlıyor. Yalnız reklam hesabı olanlar için. kaynak

  • Ücret yokMeta Reklam Kütüphanesi

    Kütüphanenin kullanımı için bir ücret Meta'nın sayfasında belirtilmiyor; API ayrı bir araçtır. kaynak

  • AbonelikAtria (isteğe bağlı)

    Kalıcı ücretsiz plan var; ücretli plan Core yıllık ödemede ayda 129 $ listeleniyor. MCP ücreti kaynaklarda çelişiyor: fiyat sayfası Core'da ayda 600 çağrı yazıyor, yardım makalesi MCP'yi şimdilik her planda ücretsiz ve kredisiz diyor. (17 Ekim 2026) kaynak

  • AbonelikClay planı (isteğe bağlı)

    Ücretsiz plan var (fiyat sayfasında 0 $): ayda 500 eylem, 100 veri kredisi, tablo başına 200 satır; eski bir SSS 50 satır diyor. Ücretli plan fiyatları Clay'in sayfasında kendi içinde tutarsız, oradan kontrol et. (17 Ekim 2026) kaynak

  • API kullanımıClay zenginleştirme tüketimi (isteğe bağlı)

    Her zenginleştirilen kayıt bir eylem sayılır; veri sağlayıcı satın alımları veri kredisi tüketir. CSV indirmek eylem ya da kredi harcamaz. Küçük örnekle başla. kaynak

  • Kurulum hizmetiKurulum hizmeti

    Analiz düzenini ya da mevcut CRM bağlantısını bizden alabilirsin; kapsam görüşmeyle belli olur.

Kaynaklar

Kendin kurabilirsin; takıldığın adımı birlikte yapalım

İstediğin adımları işaretle. İstek formuna sistemin adı ve seçtiğin adımlar görünür bir özet olarak geçer; sen değiştirebilirsin. Şifre ya da API anahtarı paylaşmana gerek yok.

Yardım istediğin adımlar
Kurulum ihtiyacımı görüşelim Rakip gözlem tablosunun kurulması, Claude Ads kurulumu ve analiz düzeni, aday ölçütlerinin yazılması ve mevcut CRM ile takip görevi düzeni adımlarında yardım alınabilir. Kesin kapsam ve fiyat görüşmede belli olur.

Başka bir yol arıyorsan

Rehber ücretsiz ve üyeliksiz; buradaki adımları kendin uygulayabilirsin. Bir noktada profesyonel destek istersen ihtiyacına uygun yolu seç. Rehberdeki sıralama bundan etkilenmez.