Bir kurumun sosyal medya varlığı artık tek bir yerde yaşamıyor. X, Instagram, Facebook, YouTube, TikTok derken hesap sayısı artıyor; “kaç takipçimiz var, nereye gidiyoruz?” sorusunun cevabı beş ayrı uygulamada, beş ayrı ekranda dağılıyor. Mosaic bu dağınıklığı tek panele toplamak için geliştirdiğim platform.

Bu yazıda iki şeyi birden anlatacağım: Mosaicin ne yaptığını ve nasıl yazıldığını. İkinci kısım en az birincisi kadar ilginç — çünkü Mosaicin web platformu, API katmanı, MCP sunucusu ve iki ayrı native mobil uygulaması, hepsi baştan sona Claude Code ile yazıldı.

Mosaic Ne Yapar?

Mosaic, kurumların sosyal medya hesaplarını tek yerden takip etmesini, takipçi büyümesini görselleştirmesini ve içgörü elde etmesini sağlayan bir analitik paneli.

Çoklu kurum yönetimi. Birden fazla kurumun tüm hesaplarını tek panelden yönetip karşılaştırabilirsiniz. Ben Mosaici LKD, Radyo C, Tartı Medikal ve Mustafa Akgül Özgür Yazılım Kış Kampı gibi birbirinden bağımsız kurumların takibi için aktif kullanıyorum — hepsi aynı panelde, ayrı organizasyonlar olarak, kendi erişim yetkileriyle.

On platform desteği. X (Twitter), Instagram, Facebook, YouTube, TikTok, LinkedIn, Bluesky, Mastodon, Telegram Kanalı ve WhatsApp Kanalı. Fediverse de dahil — çünkü özgür yazılım camiasının yaşadığı platformları görmezden gelen bir analitik aracı bana eksik kalırdı. Her platformun kendine göre bir bağlanma yolu var: çoğu OAuth ile bağlanıyor; Bluesky ve Mastodon herkese açık APIleri sayesinde token bile istemiyor; WhatsApp Kanalı ise ayrı bir gateway üzerinden besleniyor.

Takipçi büyüme grafikleri. Her gece otomatik olarak takipçi snapshotları alınır ve zaman içindeki büyüme grafiklerle izlenir. Hangi kampanyanın, hangi etkinliğin takipçi eğrisinde nasıl bir kırılma yarattığını net görürsünüz. Anlık bir sayı değil, bir zaman serisi elde edersiniz — asıl değerli olan da bu.

Otomatik veri toplama. Bağlı platformlardan veriler kendiliğinden çekilir; manuel giriş yok. Platform anahtarları panele bir kez girilir ve veritabanında şifrelenmiş olarak saklanır — sunucu ortam değişkenlerinde açıkta gezinmez.

Verinizi Dışarı Açın: API ve MCP

Mosaic sadece bir gösterge paneli değil; topladığı veriyi dışarı açan bir platform.

Read-only API. Kuruma özel salt-okunur bir API anahtarıyla takipçi sayılarını, geçmiş trendleri ve özet metrikleri kendi web sitenize gömebilirsiniz. Basit JSON uçları ve CORS desteğiyle dakikalar içinde entegre olur. Örneğin bir derneğin ana sayfasındaki “X takipçimiz var” sayacı, doğrudan Mosaicten canlı beslenebilir. Anahtarın salt-okunur olması riski de sınırlıyor: en kötü senaryoda yalnızca takipçi istatistikleri okunabilir, hesaplara veri yazılamaz ya da müdahale edilemez.

MCP sunucusu. Mosaic aynı zamanda bir Model Context Protocol (MCP) sunucusu olarak çalışır. Panel hesabınızdan tek tıkla aldığınız token ile /mcp endpointini Claude Code, Claude Desktop ve diğer AI istemcilerine ekleyebilirsiniz. Sonrası doğal dil: “LKDnin son bir aydaki Instagram büyümesini özetle” ya da “Radyo Cnin en çok etkileşim alan gönderilerini listele” demek yeterli. Yapay zeka asistanınız, kurumsal sosyal medya verinize doğrudan erişip raporluyor.

Burada güzel bir mimari detay var: API anahtarı, mobil uygulama girişi ve MCP tokenı tek ve aynı token. Panelden bir kez token alırsınız; onunla hem uygulamaya girer, hem web sitenize sayaç gömer, hem de Claudea bağlanırsınız. Ve MCP sunucusu her sorguyu sizin yetkinizle sınırlar — hangi kurumları görebiliyorsanız yalnızca onların verisi döner. Her erişim de denetim kaydına (audit log) yazılır.

Mobil Uygulamalar: Cebinizdeki Panel

Mosaicin hem Google Play hem App Storeda yayında olan mobil uygulamaları var. Aynı panel hesabıyla giriş yapıyorsunuz; takipçi sayıları, büyüme grafikleri ve gönderiler her an elinizin altında.

İki ilkeye özellikle önem verdim: uygulamalarda hiçbir reklam veya izleme yok, ve erişim tokenları cihazda şifrelenmiş olarak saklanıyor. Gizlilik tarafında tavır net — Mosaic yalnızca bağlanan hesapların takipçi istatistiklerini okur, hiçbir içerik paylaşmaz, hiçbir veriyi üçüncü taraflara aktarmaz.

Hepsi Claude Code ile Yazıldı

Şimdi işin geliştirme tarafı. Mosaic tek kişilik bir proje — ama ortaya çıkan şey bir web platformu, bir API katmanı, bir MCP sunucusu ve iki farklı işletim sistemi için storelarda yayınlanmış native mobil uygulamalar. Bunların tamamı Claude Code ile yazıldı.

Arka tarafta modern ama sade bir yığın var: Laravel 13, PHP 8.4, kimlik doğrulama için Laravel Passport, platform bağlantıları için Laravel Socialite, ve MCP sunucusu için Laravelin resmi laravel/mcp paketi. Günlük snapshotlar zamanlanmış bir komutla (her gece 02:00de çalışan mosaic:fetch-followers) alınıyor; gönderiler ayrı bir komutla çekiliyor. MCP tarafında dört araç var — kurumları listele, sosyal hesapları listele, takipçi geçmişini getir, gönderileri getir — ve hepsi kullanıcının yetki kapsamına göre filtreleniyor.

Süreç şöyle işliyor: terminalde görevi tarif ediyorum, Claude Code kodu yazıyor, ben test edip yönlendiriyorum. Web panelinden takipçi grafiklerine, OAuth entegrasyonlarından Android ve iOS uygulamalarının store süreçlerine kadar her katman bu iterasyonla şekillendi. Content Manager projemde yaşadığım deneyimin daha da genişletilmiş hali: bir geliştirici, doğru yapay zeka araçlarıyla artık yalnızca bir web sitesi değil, çok platformlu komple bir ürün ekosistemi ayağa kaldırabiliyor.

İşin en hoş tarafı, hikayenin kendi kuyruğunu yakalaması: Claude Code ile yazılan Mosaic, MCP sunucusu sayesinde şimdi Claudeun veri kaynağı. Yapay zekanın inşa ettiği platform, yapay zekanın sorguladığı platforma dönüştü. Kodu yazan araç, artık ürettiği ürünün içinden veri okuyor.

Kimler Kullanmalı?

Mosaici özellikle dernekler, topluluklar, yerel radyolar, KOBİler ve birden fazla kurumun sosyal medyasını yöneten ajanslar/gönüllüler için düşündüm. Büyük kurumsal social listening araçlarının fiyatına ve karmaşıklığına ihtiyaç duymayan, ama “takipçilerimiz büyüyor mu?” sorusuna güvenilir ve tek ekrandan cevap isteyen herkes hedef kitlede.

Denemek için mosaic.net.tr adresinden panele göz atabilir, mobil uygulamaları indirebilir ya da API dokümantasyonunu inceleyebilirsiniz. Görüş ve önerilerinizi beklerim.