Bu rehberde: Kısa video senaryolarınızı yazan ajanı tanırsınız: hangi platform ve tarzlar, senaryonun yapısı, sponsorlu içerikte Reklam etiketi ve çekim gününe nasıl hazırlanılır.
⏱ 8 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Tür | VIDEO_SCRIPTWRITER |
| Kategori | İçerik |
| Kutu tipi | agent.videoScriptwriter |
| Varsayılan model | claude-sonnet-5 (dengeli) |
| Ekonomik model | claude-haiku-4-5 |
| Araçlar | get_post_performance, web_search, fetch_url, knowledge_search |
| Rapor türü | VIDEO_SCRIPTS (Video senaryoları) |
| Önerilen hesaplar | Instagram, TikTok, YouTube (performans verisi için), Serper / Tavily (trendler için) |
Ne yapar?
Ajan bir konudan, telefonla tek seferde çekilebilecek kısa video senaryoları yazar. Yazmadan önce:
get_post_performanceile seçilen platformdaki son 90 günün performansına bakar: hangi konu, format ve uzunluk işe yaramış (hesap bağlı değilse bu adımı atlar).web_searchile konuyla ilgili güncel formatları ve soruları kontrol eder; görmediği bir trendi trend diye sunmaz.- Ürün anlatılıyorsa
knowledge_searchile bilgi bankasından bilgi alır.
Marka sesiniz ve strateji belgesindeki içerik sütunları her çalıştırmaya otomatik eklenir. Ajan videoyu üretmez; senaryoyu siz, ekibiniz ya da bir içerik üreticisi çeker.
Senaryonun yapısı
Her senaryo hook → bağlam / sorun → değer (adımlar, gösterim, kanıt) → çağrı akışını izler:
- 3 hook: ilk 1–3 saniye için üç alternatif giriş, her biri farklı türde (önce sonuç, iddialı ama doğru bir cümle, soru, hata / efsane, POV, şaşırtan görüntü). İlk sahne birinci hook'u kullanır.
- Sahneler: her sahnenin süresi (saniye), görüntü (çekim açısı, aksiyon, ürün, mekân), seslendirme (saniyede ≈ 2,5 kelime) ve en fazla 8 kelimelik ekran yazısı. Sahne süreleri toplamı istenen uzunluğa ±%20 içinde uymak zorundadır; uymazsa sonuç reddedilir ve ajan düzeltir.
- Açıklama ve hashtag'ler: platform sınırlarında (Instagram 2.200 karakter / 30 hashtag, TikTok 2.200 / 5, YouTube 5.000 / 15); Shorts'ta "Shorts" etiketi.
- Çağrı: son sahnede söylenir ve açıklamaya eklenir.
- Çekim listesi: A-roll, B-roll, yakın çekim ve ekran kayıtları çekim sırasıyla, eşya ve mekânlarla.
- Başlık: YouTube / Shorts için ≤ 100 karakter, anahtar kelime başta; diğerlerinde çalışma başlığı.
Dört tarz vardır: UGC (müşteri veya içerik üreticisi telefonla kendini çeker, birinci tekil şahıs), konuşan kafa (kurucu veya uzman kameraya anlatır), eğitim (numaralı adımlar) ve ürün tanıtımı (ürün ilk saniyeden kullanımda).
Sponsorlu içerik ve Reklam etiketi
Bir içerik üreticisi veya influencer videoyu kendi hesabında paylaşacaksa ya da ücretli, hediyeli veya indirim kodlu bir iş birliği varsa senaryo sponsored: true olarak işaretlenir. Bu durumda:
- Açıklamanın ilk 125 karakterinde "Reklam |" veya "#reklam" gibi açık bir etiket zorunludur; yoksa sonuç reddedilir.
disclosurealanı etiketlemeyi anlatır: açıklamadaki etiket, videonun başında sözlü belirtme ve platformun ücretli ortaklık işareti (Ticaret Bakanlığı sosyal medya etkileyicileri kılavuzu).
Markanın kendi hesabında yayınlanan videolar sponsorlu sayılmaz. Görevde "içerik üreticisi", "iş birliği" veya "influencer" geçiyorsa ajan senaryoyu sponsorlu kabul eder.
Ayrıca kanıtsız üstünlük iddiası, 10 gün eski fiyat kuralı, sağlık vaadi yasağı ve alkol tanıtımı yasağı burada da geçerlidir; telifli müzik veya başkalarının içeriği senaryoya yazılmaz, platformun lisanslı ses kütüphanesi önerilir.
Girdiler
| Alan | Etiket | Tür | Varsayılan | Açıklama |
|---|---|---|---|---|
platform | Platform | seçim (zorunlu) | reels | reels, tiktok, shorts, youtube |
topic | Topic / brief | uzun metin (zorunlu) | – | Videonun konusu |
durationSeconds | Duration (seconds) | sayı (15–180) | 30 | Hedef uzunluk |
style | Style | seçim | ugc | ugc, talking_head, tutorial, product_demo |
count | Scripts | sayı (1–5) | 3 | Senaryo sayısı |
cta | Call to action | metin | – | Çağrı; boşsa ajan seçer |
Çıktılar
Sonuçta tek alan vardır: scripts. İş akışında main çıkışından her senaryo ayrı bir öğe olarak çıkar.
{
"title": "Evde filtre kahvede 3 hata",
"platform": "reels",
"style": "ugc",
"durationSeconds": 30,
"hooks": ["Filtre kahven acıysa sebebi bu", "Bu 3 hatayı ben de yapıyordum", "POV: ilk kez gerçekten iyi kahve demledin"],
"scenes": [{ "seconds": 3, "visual": "Selfie, elinde kupa", "voiceover": "Filtre kahven acıysa sebebi bu.", "onScreenText": "3 hata" }],
"caption": "Filtre kahven acıysa bu 3 hatadan birini yapıyorsun. Hangisi seninki?",
"hashtags": ["filtrekahve", "kahve", "evdekahve"],
"cta": "Çekirdekler profildeki linkte",
"shotList": ["Selfie A-roll, mutfak", "Öğütücü yakın çekim"],
"sponsored": false
}
Hashtag'ler # olmadan gelir. Sonraki kutularda {{ $json.caption }}, {{ $json.hooks[0] }}, {{ $json.shotList }} ile erişirsiniz.
Örnek görev metinleri
- "Evde filtre kahvede yapılan 3 hata üzerine 30 saniyelik 3 Reels senaryosu yaz; UGC tarzında, sonunda profildeki linke yönlendir."
- "Yeni çekirdeğimizi deneyecek bir içerik üreticisi için 45 saniyelik TikTok senaryosu yaz; ücretli iş birliği olduğu için Reklam etiketini ekle."
- "Kliniğimiz için diş beyazlatma hakkında 3 yanlış bilgiyi düzelten 60 saniyelik bir Shorts senaryosu hazırla; sağlık vaadinde bulunma."
- "Yeni şubemizin açılış haftası için kameraya konuşan kurucu tarzında 2 Reels senaryosu yaz; adresi ekran yazısında ver."
İpuçları
İpucu: Videoyu kimin çekeceğini ve nerede yayınlanacağını göreve yazın. "Ürünü bir içerik üreticisi kendi hesabında paylaşacak" derseniz senaryo Reklam etiketiyle gelir.
- Her senaryodaki üç hook'tan ikisini aynı çekimle deneyin; izlenme süresi uzun olanı sonraki videolarda kullanın.
- Hesabınızı bağlayın; ajan en iyi çalışan uzunluk ve formatlara göre yazar.
- Çekim listesini çekim gününe yazdırın; her şeyi tek seferde çekersiniz.
- Reels ve TikTok'ta 20–40 saniye çoğu zaman en iyi sonucu verir.
Beklenen rapor
Video senaryoları raporu: senaryo tablosu (başlık, süre, tarz, ilk hook, Reklam etiketi gerekip gerekmediği), sponsorlu senaryoların etiket notları ve her senaryo için hook'lar, zaman kodlu sahne tablosu (0:00–0:03 …), açıklama, hashtag'ler, çağrı ve çekim listesi. Metrik kartları: senaryo sayısı, ortalama süre, sponsorlu senaryo sayısı.
Maliyet beklentisi
3 senaryo × 30 saniye, performans ve trend araması (~20K giriş / ~9K çıkış token):
| Katman | Model | Tahmini maliyet |
|---|---|---|
| Ekonomi | claude-haiku-4-5 | ≈ 0.07 $ |
| Dengeli (varsayılan) | claude-sonnet-5 | ≈ 0.13 $ |
| Amiral gemisi | claude-opus-5 | ≈ 0.33 $ |
Web araması platform tarafından ayrıca ölçülür.
İş akışında kullanım
Zamanlama (pazartesi 09:00) → Video Senaryo ve UGC Yazarı → Onay → Ekibe bildir (senaryolar e-posta / Slack'e)
- İçerik takvimi: İçerik Üretici TikTok / YouTube gönderilerini, bu ajan çekim senaryolarını üretir.
- Sponsorlu senaryoları yayından önce Mevzuat Uyum Denetçisi ile denetleyin (sponsorlu içerik: açık).
Sık karşılaşılan sorunlar
| Sorun | Neden | Çözüm |
|---|---|---|
| Senaryo çok uzun konuşma içeriyor | Süre kısa, konu geniş | Konuyu daraltın veya süreyi artırın |
| Performans verisi kullanılmadı | Hesap bağlı değil | Instagram / TikTok / YouTube hesabını bağlayın |
| Reklam etiketi eklendi ama gerekmiyordu | Görevde iş birliği veya üretici geçti | Göreve "markanın kendi hesabında yayınlanacak" yazın |
Sık sorulan sorular
Videoyu da üretir mi? Hayır. Ajan senaryo, açıklama ve çekim listesi yazar.
Müzik önerir mi? Telif riskini önlemek için belirli şarkı yazmaz; platformun lisanslı ses kütüphanesinden güncel bir ses seçmenizi önerir.