Facebook MCP Server

Bu proje, Facebook Graph API'sini kullanarak Facebook Sayfasında etkileşimleri otomatikleştiren ve yöneten bir MCP sunucusudur. Yazı oluşturma, yorumları yönetme, yazı öngörülerini alma ve negatif geri bildirimi filtreleme araçlarını sunarak Claude veya diğer LLM tabanlı ajanlarla entegrasyon için hazırdır.

---

🤖 Bu Nedir?

Bu MCP, doğrudan bir Facebook Sayfasına bağlanan ve yaygın API işlemlerini LLM-dostça fonksiyonlar olarak soyutlayan yapay zeka tarafından çağrılabilir araçlar takımı sağlar.

✅ Faydalar

• Sosyal medya yöneticilerini moderasyon ve analitiği otomatikleştirmeye güçlendirir.
• Claude Desktop veya herhangi bir Agent istemcisiyle sorunsuz şekilde entegre olur.
• Facebook içeriğini doğal dilden ince kontrol sağlar.

---

📦 Özellikler

Araç	Açıklama
post_to_facebook	Bir ileti ile yeni bir Facebook yazısı oluşturun.
reply_to_comment	Bir yazı üzerindeki belirli bir yoruma yanıt verin.
get_page_posts	Sayfadaki son yazıları alın.
get_post_comments	Belirli bir yazı üzerindeki yorumları alın.
delete_post	Belirli bir yazıyı ID'ye göre silin.
delete_comment	Belirli bir yorumu ID'ye göre silin.
hide_comment	Bir yorumu genel görüşten gizleyin.
unhide_comment	Daha önce gizlenen bir yorumu gösterin.
delete_comment_from_post	Belirli bir yazıdan yorumu silmek için takma ad.
filter_negative_comments	Negatif duyarlılık anahtar kelimeleri içeren yorumları filtreleyin.
get_number_of_comments	Bir yazı üzerindeki yorum sayısını sayın.
get_number_of_likes	Bir yazı üzerindeki beğeni sayısını sayın.
get_post_impressions	Bir yazı üzerindeki toplam gösterimleri alın.
get_post_impressions_unique	Yazıyı gören benzersiz kullanıcı sayısını alın.
get_post_impressions_paid	Yazı üzerindeki ödenen gösterim sayısını alın.
get_post_impressions_organic	Yazı üzerindeki organik gösterim sayısını alın.
get_post_engaged_users	Yazıyla etkileşimde bulunan kullanıcı sayısını alın.
get_post_clicks	Yazı üzerindeki tıklama sayısını alın.
get_post_reactions_like_total	Toplam 'Beğen' tepki sayısını alın.
get_post_top_commenters	Bir yazı üzerindeki en çok yorum yapanları alın.
post_image_to_facebook	Altyazılı bir resmi Facebook sayfasına gönderin.
send_dm_to_user	Bir kullanıcıya doğrudan mesaj gönderin.
update_post	Mevcut bir yazının mesajını güncelleyin.
schedule_post	Yazıyı gelecekte yayınlanmak üzere planlayın.
get_page_fan_count	Sayfa hayran sayısını alın.
get_post_share_count	Bir yazı üzerindeki paylaşım sayısını alın.
get_post_reactions_breakdown	Tek çağrıda bir yazı için tüm tepki sayılarını alın.
bulk_delete_comments	Birden çok yorumu ID'ye göre silin.
bulk_hide_comments	Birden çok yorumu ID'ye göre gizleyin.
bulk_unhide_comments	Birden çok yorumu ID'ye göre gösterin.
get_comment_replies	Belirli bir yoruma tüm yanıtları alın.
get_post_permalink	Bir yazının permalink URL'sini alın.
get_scheduled_posts	Sayfa üzerindeki tüm planlanan (yayınlanmamış) yazıları listeleyin.
get_page_info	Genişletilmiş sayfa ayrıntılarını alın (ad, hakkında, kategori, website).

---

🚀 Kurulum ve Yükleme

1. Depoyu Klonlayın

git clone https://github.com/your-org/facebook-mcp-server.git
cd facebook-mcp-server

2. 🛠️ Yükleme

Hızlı Python paket yöneticisi uv kullanarak bağımlılıkları yükleyin: Eğer uv henüz yüklü değilse, şunu çalıştırın:

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

uv yüklendikten sonra, proje bağımlılıklarını yükleyin:

uv pip install -r requirements.txt

3. Ortamı Ayarlayın

Kök dizinde bir .env dosyası oluşturun ve Facebook Sayfası kimlik bilgilerinizi ekleyin. Bunları https://developers.facebook.com/tools/explorer adresinden alabilirsiniz

FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_page_id

🧩 Claude Desktop ile Kullanım

FacebookMCP'yi Claude'da ayarlamak için:

1. Claude'u açın.
2. Ayarlar → Geliştirici → Yapılandırmayı Düzenle'ye gidin.
3. Açılan yapılandırma dosyasında aşağıdaki girişi ekleyin:

"FacebookMCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "requests",
    "mcp",
    "run",
    "/path/to/facebook-mcp-server/server.py"
  ]
}

---

✅ Başlamaya Hazırsınız!

Hepsi bu — Facebook MCP sunucunuz artık tam olarak yapılandırılmış ve Claude Desktop'u güçlendirmeye hazırdır. Artık yazı oluşturabilir, moderasyon yapabilir ve tüm etkileşimi doğal dil komutlarıyla ölçebilirsiniz!

---

🤝 Katkıda Bulunun

Katkılar, sorunlar ve özellik istekleri memnuniyetle karşılanır!
Depoyu forklayın ve bir pull request gönderin.

• Bir branch oluşturun: git checkout -b feature/YourFeature
• Değişikliklerinizi commit edin: git commit -m 'feat: add new feature'
• Branch'e push edin: git push origin feature/YourFeature
• Bir pull request açın 🎉