Sosyal medya connector'ları

Sosyal connector'lar ajana üç yetenek kazandırır: halka açık içeriği okumak, bağlı hesaplara paylaşım yapmak ve görsel/video üretmek. Ayrı bir ekranda yaşarlar: /settings/social-connectors.

Menüyü göremiyorsanız

Sosyal connector'lar üç kapının arkasındadır. Üçü birden açık değilse menü görünmez, API 403 döner ve sosyal araçlar ajanın araç listesinden tamamen çıkarılır — model onları görmez bile.

1. Platform anahtarı — SemAgent tarafında açık olmalıdır.
2. Tenant anahtarı — hesabınız için sosyal connector'lar etkinleştirilmiş olmalıdır.
3. Yapılandırılmış sağlayıcı — en az bir connector kayıtlı ve açık olmalıdır.

İlk ikisi kapalıysa yöneticinizle iletişime geçin.

Üç aile

Aile	Ne yapar	Sağlayıcılar
📥 Okuma	Halka açık içeriği okur/izler	Apify, Reddit
🔗 Toplu Yönetim	Tek panelden çok hesaba paylaşım	WoopSocial, Ayrshare, Zernio
🎨 Medya Üretimi	Video üretimi (kendi anahtarınızla)	fal.ai, Higgsfield

Her sağlayıcıda akış aynıdır: alanları doldurun → Kaydet → Test. Her satırda son test durumu ve hata mesajı görünür. Sırlar şifreli tutulur ve panele *** olarak maskeli döner; maskeyi olduğu gibi bırakırsanız eski değer korunur.

Okuma: Apify ve Reddit

Apify

Halka açık içeriği çeker: X/Twitter, Instagram, TikTok, Facebook, YouTube, LinkedIn, Pinterest, Etsy. Ayrıca ajan, Apify mağazasındaki herhangi bir actor'ı çalıştırabilir.

1. apify.com hesabı açın → Settings › Integrations → API token'ı kopyalayın.
2. Token'ı ve bir Max sonuç limiti girin (harcama koruması; örneğin 25).
3. Kaydet → Test.

Kullanım: ajana "şu Instagram profilini oku" derseniz social_read çalışır. Belirli bir actor için "Apify actor apify/google-maps-scraper ile şu input'u çalıştır" derseniz apify_run çalışır.

İsteğe bağlı Actor eşlemesi alanıyla bir platformun varsayılan actor'ını değiştirebilirsiniz, örneğin {"linkedin":"harvestapi/linkedin-profile-posts"}.

Reddit

Reddit'in resmî API'si (PRAW) üzerinden salt-okuma, ücretsiz.

1. reddit.com/prefs/apps → create app → tür olarak script seçin.
2. Redirect URI alanına http://localhost yazın (script uygulamasında kullanılmaz) ve oluşturun.
3. Uygulama adının altındaki Client ID ile secret'ı kopyalayın.
4. Client ID + secret + (opsiyonel) User-Agent girin → Kaydet → Test.

Kullanım: "r/Turkey'de en çok konuşulanları getir" → reddit_read.

Toplu yönetim: WoopSocial ve Ayrshare

Aggregator'lar, her platform için ayrı geliştirici uygulaması açma derdini ortadan kaldırır: hesaplarınızı onların panelinde OAuth ile bağlarsınız, ajan tek bir araçla (social_post) paylaşım yapar.

WoopSocial

1. woopsocial.com'da hesap açın ve sosyal hesaplarınızı panelden bağlayın (her platform tek tık OAuth).
2. API erişimi Pro paket ve üzeri gerektirir — ücretsiz pakette yalnız panel vardır, API yoktur. app.woopsocial.com/api-access adresinden Bearer API key'i kopyalayın.
3. API key'i girin → Kaydet → Test.

Kullanım: "WoopSocial'daki Instagram hesabıma şu metni paylaş" → social_post. "Bağlı hesaplarımı listele" → social_channels. Görsel ve video paylaşımı desteklenir; medya otomatik olarak medya kütüphanesine yüklenir.

Native MCP (opsiyonel): Native MCP araçlarını bağla kutusunu işaretlerseniz WoopSocial'ın kendi araçları doğrudan ajana bağlanır ve api.woopsocial.com egress iznine otomatik eklenir.

Ayrshare

Resmî partner aggregator — 13 ağ, geliştirici uygulaması gerekmez.

1. ayrshare.com'da hesap açın, Dashboard'dan API Key'i kopyalayın.
2. Tek hesap kullanıyorsanız bu yeterlidir. Çok profilli Business planında ayrıca Profile Key, JWT ile hesap bağlama akışı için Domain + Private Key girilir.
3. Kaydet → Test.

Kullanım: "Ayrshare profilimdeki LinkedIn'e şunu paylaş" → social_post. Platform belirtmezseniz gönderi bağlı tüm hesaplara gider.

Zernio

Zernio de bir toplu-yönetim aggregatörüdür (LinkedIn ve diğer ağlar). Portaldan hesaplarınızı bağlayıp API anahtarınızı SemAgent'a girersiniz; ardından social_post ile onaylı yayın, social_channels ile hesap listeleme yaparsınız. Görsel/video medya da yüklenir.

Postiz

Panelde bir Postiz kartı görürsünüz. Şu an yalnızca yapılandırma saklanır; yazma araçları henüz bağlı değildir. Paylaşım için WoopSocial, Ayrshare veya Zernio kullanın.

Gönderilerden öğrenme

Ajan yalnız yayınlamaz; yayınladığı gönderilerin performans metriklerini (etkileşim, erişim) toplar, bunlardan dersler çıkarır ve stratejisine (charter) uygular — böylece bir sonraki içerik daha isabetli olur. Bu öğrenme döngüsü tenant'a özeldir ve metrik biriktikçe güçlenir.

Medya üretimi: görsel santralde, video kendi anahtarınızla

Bu ikisi farklı çalışır — en sık karıştırılan nokta budur.

	Görsel üretimi	Video üretimi
Araç	image_generate	video_generate
Nerede çalışır	SemAgent santralinde	Sizin sağlayıcı hesabınızda
Kurulum	Gerekmez	Zorunlu — fal.ai veya Higgsfield bağlayın
Ücret	SemAgent kredinizden düşer	Kredi yakmaz; sağlayıcı bakiyenizden düşer
Bağlı değilse	Çalışır	Video üretilemez

Yani video üretimi kendi anahtarını getir (BYOC) modelindedir. Connector'ı bağlayıp açık konuma getirmeniz gerekir; kapatırsanız video üretimi anında durur. Günlük video üretim limiti BYOC'de de geçerlidir.

fal.ai

1. fal.ai'da hesap açın → Dashboard › Keys → yeni API key oluşturun (id:secret biçiminde tek dizedir).
2. Anahtarı yapıştırın → Kaydet → Test.

Açıkken: "şu konuda 5 saniyelik dikey video üret" → video sizin fal bakiyenizden üretilir. Maliyeti fal.ai/billing üzerinden izleyin.

Higgsfield

1. Higgsfield hesabınızdan API key + secret alın (platform.higgsfield.ai).
2. İkisini de girin → Kaydet → Test.

Üretim iki adımlıdır (önce görsel, sonra video) ve dakikalar sürebilir. Maliyet Higgsfield hesabınıza yansır.

Açılan araçlar

Araç	Ne yapar	Gereken connector
social_read	Bir profil/gönderi içeriğini okur	Apify
apify_run	Herhangi bir Apify actor'ını çalıştırır	Apify
reddit_read	Subreddit/gönderi okur	Reddit
social_channels	Bağlı hesapları listeler	WoopSocial
social_analytics	Gönderi metriklerini getirir	Aggregator
social_post	Bağlı hesaplara paylaşır	WoopSocial / Ayrshare
video_generate	Video üretir	fal.ai / Higgsfield

social_post dışa açık bir yayın işlemidir ve gözetimli modda onaya düşer. Okuma araçlarının getirdiği içerik dış içerik sayılır ve planlayıcıya girmeden önce karantinadan geçer — bkz. Güvenlik mimarisi.