Yasin Arsal

25 MAYIS 2026

Meta Ads Skill: Kurulum Rehberi

Herhangi bir marka URL'sini 4 bitmiş Meta reklamına 3 dakikada dönüştür. Claude Max, bir KIE.ai anahtarı ve tek bir slash komutu yeterli.

Sonunda elinde ne olacak

Claude Code içinde çalışan bir /meta-ads <url> komutu. Herhangi bir DTC marka URL'sini yapıştır, enter'a bas, 3 dakika sonra elinde şunlar var:

  • 4 bitmiş PNG reklam, 2K çözünürlük, Meta'ya yüklemeye hazır
  • Her konsepti açıklayan 1 sayfalık strateji özeti
  • Araştırma dosyası (site analizi, gerçek yorumlar, rakip kalıpları, tüketici psikolojisi)

4 reklam, Meta'da gerçekten ölçeklenen 4 DTC arketipini kapsar:

  1. Product Hero — cesur ürün fotoğrafı, başlık, markalı arka plan. Soğuk kitleler için.
  2. Lifestyle — gerçek bağlamda ürünü kullanan gerçek insan. Orta huniler için.
  3. Stat-Led — kaydırmayı durduran tek bir rakam. Soğuk retargeting için.
  4. Receipt / Comparison — yan yana maliyet hesabı veya "bu değil, şu". Sıcak retargeting ve kategori-bilinçli alıcılar için.

Run başına yaklaşık $0.20 KIE kredisi. Günde 10 markada çalıştır, maliyeti $2.

Gereksinimler

Başlamadan önce bunlara ihtiyacın var. Hiçbiri karmaşık değil, hepsini 10 dakikada toplayabilirsin.

  • macOS veya Linux. Windows WSL ile çalışır.
  • Terminal erişimi (Mac'te: Spotlight → "Terminal")
  • Claude Max aboneliği ($200/ay, Anthropic tarafından faturalanır). Pro bu skill için hızla rate-limit'e takılır.
  • Claude Code kurulu (terminal uygulaması). Kurulum talimatları Adım 2'de.
  • KIE.ai hesabı ve $5 kredi yüklü (bir çalıştırma ~$0.20, yani $5 ile 25 çalıştırma yaparsın).
  • Tam kurulum için yaklaşık 15 dakika.

Geliştirici olman gerekmiyor. Bu rehberdeki her komut kopyala-yapıştır.

Opsiyonel araçlar (sadece bir marka sitesi WebFetch'i engellerse gerekli): firecrawl-mcp (npm) ve agent-browser (Vercel Labs Rust CLI).

Adım 1: Claude Max Al

Pro, kullanımı çok agresif kısıtlıyor. Bu skill marka araştırması ve görsel üretimi sırasında ciddi token harcıyor.

Fiyatlandırma (2026-05-14): Max ayda $200 sabit. Daha az kullanımlı $100/ay katmanı da var. 20$’lık pro versiyon ile de deneyebilirsin. Bütçene uygun oalnı al.

  1. https://claude.ai/upgrade adresine git
  2. Max, $200/ay'ı seç
  3. Ödeme sonrası Settings → Account'ta "Claude Max" aktif olduğunu doğrula

Adım 2: Claude Code Kur

Claude Code, aboneliğini bir ajana dönüştüren terminal uygulaması.

macOS veya Linux'ta:

bash
curl -fsSL https://claude.ai/install.sh | bash

macOS'ta Homebrew ile:

bash
brew install --cask claude-code

Windows'ta (PowerShell):

powershell
irm https://claude.ai/install.ps1 | iex

Doğrula:

bash
claude --version

Sonra claude komutunu bir kez çalıştırarak tarayıcı OAuth ile giriş yap.

Adım 3: KIE.ai API Anahtarı Al

KIE.ai görsel üretim geçididir. Tek anahtar GPT Image 2, Flux-2 Pro, Imagen 4, Nano Banana, Seedream'e erişim sağlar.

Neden KIE? OpenAI'nin gpt-image-2 endpoint'i organizasyon doğrulaması gerektiriyor. KIE bunu tek anahtarla atlatır, üstelik daha ucuz.

  1. https://kie.ai adresine git
  2. Hesap oluştur (Google ile giriş en hızlısı)
  3. Settings → API Keys → "Create new key"
  4. Anahtarı kopyala
  5. $5 kredi yükle

Anahtarı kaydet

Seçenek A (önerilen): Proje-yerel .env:

bash
mkdir -p ~/.claude/skills/meta-ads
echo "KIE_API_KEY=senin-gercek-anahtarin" > ~/.claude/skills/meta-ads/.env
chmod 600 ~/.claude/skills/meta-ads/.env

Seçenek B: Shell export:

bash
echo 'export KIE_API_KEY="senin-gercek-anahtarin"' >> ~/.zshrc
source ~/.zshrc

Doğrula:

bash
KEY="senin-gercek-anahtarin"
curl -sSL -X POST https://api.kie.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2-text-to-image","input":{"prompt":"a single green leaf on white background","aspect_ratio":"1:1","resolution":"1K"}}'

Adım 4: uv Kur (Python runner)

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Terminali yeniden aç, doğrula:

bash
uv --version

Adım 5: Skill Klasörünü Kur

Skill, Google Drive klasöründeki meta-ads-skill.zip olarak gelir.

bash
mkdir -p ~/.claude/skills
unzip ~/Downloads/meta-ads-skill.zip -d ~/.claude/skills/
mv ~/.claude/skills/meta-ads-skill ~/.claude/skills/meta-ads

Doğrula:

bash
ls ~/.claude/skills/meta-ads/

Adım 6: Claude Code'un Skill'i Gördüğünü Doğrula

bash
claude

Prompt içinde:

javascript
/skills list

Listede meta-ads görmelisin.

Adım 7: İlk Çalıştırma

javascript
/meta-ads https://im8health.com

Ne olur:

  1. Claude ana sayfayı, hakkında ve ürün sayfasını tarar
  2. 5 WebSearch ile gerçek müşteri yorumlarını bulur
  3. 3-5 rakip belirler
  4. Psikoloji sentezi yazar
  5. 4 reklam konsepti taslağı çıkarır
  6. Her konsept için prompt şablonunu doldurup KIE'ye gönderir
  7. 4 PNG indirir
  8. 1 sayfalık özet yazar

Toplam süre: 2-4 dakika.

Adım 8: Çıktıyı İncele

bash
open ~/.claude/skills/meta-ads/outputs/
  • ad_1_product_hero.png — 2K kare, marka renkli arka plan, ürün ortada
  • ad_2_lifestyle.png — sinematik fotoğraf, gerçek insan
  • ad_3_stat_led.png — büyük rakam, düz marka rengi
  • ad_4_receipt_comparison.png — fiş veya yan yana hesap
  • brief.md — strateji dokümanı

4 Reklam Konsept Şablonu

Product Hero — prompts/01-product-hero.md

Kalın başlık, marka renkli arka planda ürün. Soğuk kitleler için.

Lifestyle — prompts/02-lifestyle.md

Sinematik fotoğraf, gerçek insan, 35mm grain, Kodak Portra paleti.

Stat-Led — prompts/03-stat-led.md

Devasa tek rakam, düz marka rengi arka plan.

Receipt / Comparison — prompts/04-receipt-comparison.md

Fiş formatı veya Bu vs Şu bölünmüş ekran.

Sorun Giderme

KIE_API_KEY bulunamadı

bash
cat ~/.claude/skills/meta-ads/.env 2>/dev/null | grep KIE_API_KEY
echo "$KIE_API_KEY"

KIE 401 unauthorized

Anahtar yanlış veya süresi dolmuş. https://kie.ai'den yeniden oluştur.

KIE 429 rate limit

60 saniye bekle veya daha fazla kredi yükle.

Render 5 dakikadan uzun sürüyor

Komutu tekrar çalıştır.

WebFetch işe yaramıyor

  1. Daha spesifik URL dene
  2. firecrawl-mcp kur: npm install -g firecrawl-mcp
  3. Veya agent-browser kur: npm install -g agent-browser && agent-browser install

Reklam başlığı bozuk

  1. Başlıkları max 6 kelime tut
  2. Uzun metin gerekiyorsa başlıksız üret, sonra Figma'da ekle

/skills list meta-ads'i göstermiyor

bash
ls ~/.claude/skills/meta-ads/SKILL.md

Özelleştirme

Kareden dikeye geç

commands/meta-ads.md'de --aspect 1:1'i --aspect 9:16 veya --aspect 4:5 yap.

Grafik yerine fotogerçekçi

Prompt dosyalarında gpt-image-2-text-to-image'ı flux-2/pro-text-to-image yap.

5. arketip ekle

prompts/05-<arketip>.md oluştur, commands/meta-ads.md ve SKILL.md'yi güncelle.

Farklı sektörde çalıştır

references/ klasörünü kendi sektöründeki reklam örnekleriyle değiştir ve SKILL.md'yi güncelle.

Skill burada: https://drive.google.com/drive/folders/1RpI6WO6BQoNuMei2UQkXb4SZFBYZgt2i?usp=sharing