SocialAPIs — Facebook & Instagram Data

resmi

Yapay zeka ajanları için Facebook ve Instagram verileri — sayfalar, gönderiler, gruplar, Reklam Kitaplığı, Marketplace, profiller ve reels. 47 salt-okunur araç, yapılandırılmış çıktı. Ücretsiz katman: ayda 200 çağrı.

SocialAPIs — Facebook & Instagram Data MCP ile neler yapabilirsiniz?

  • Facebook sayfa ve grup verileri — Bağlantı veya kimlik numarasıyla sayfa ya da grup ayrıntılarını, gönderileri, videoları, Reels içeriklerini ve fotoğraf albümlerini alın.
  • Facebook gönderi ve yorum arama — Bir gönderi bağlantısından gönderi ayrıntılarını, ekleri, yorumları ve yorum yanıtlarını alın.
  • Meta Ads Library araması — Anahtar kelimeye veya reklamverene göre reklamları arayın, reklamveren sayfası ayrıntılarını alın ve desteklenen ülkeleri listeleyin.
  • Instagram profil ve gönderi verileri — Kullanıcı adına veya kısa koda göre profil ayrıntılarını, gönderileri, Reels içeriklerini, öne çıkanları ve gönderi ayrıntılarının tamamını alın.
  • Instagram arama ve konumlar — Kullanıcıları, hashtag’leri ve yerleri anahtar kelimeyle arayın veya bir konumda etiketlenen gönderileri listeleyin.
  • Facebook Marketplace araması — Filtrelerle ilanları, araçları ve kiralık yerleri arayın; ilan veya satıcı ayrıntılarını alın.

Barındırılan MCP Sunucusu

npx add-mcp 'https://mcp.socialapis.io/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Yapay zekâ asistanlarına SocialAPIs Model Context Protocol (MCP) sunucusuyla herkese açık Facebook ve Instagram verilerine doğrudan erişim sağlayın.

Sunucu, 50 eylemi kapsayan 12 salt okunur araç sunar: sayfalar, gönderiler, yorumlar, gruplar, Meta Ads Library, Marketplace, Instagram profilleri, gönderiler, Reels ve konumlar. Her araç tek bir kaynağı kapsar ve bir action bağımsız değişkeni alır. Her çağrı, harcanan krediler ve kalan krediler dâhil yapılandırılmış çıktı döndürür.

1. API anahtarı alın

socialapis.io adresinde kaydolun ve anahtarınızı dashboard üzerinden kopyalayın. Ücretsiz plan ayda 200 kredi içerir; kredi kartı gerekmez.

2. İstemcinizi bağlayın

Bağlanmanın iki yolu vardır.

Barındırılan uç nokta (önerilen)

Kurulum gerekmez. Uzak MCP sunucularını destekleyen herhangi bir istemciyi şu adrese yönlendirin:

https://mcp.socialapis.io/mcp

Anahtarınızı bir başlıkta gönderin:

Authorization: Bearer YOUR_API_KEY

x-api-token: YOUR_API_KEY da çalışır. Anahtarı asla URL'ye koymayın.

Yerel sunucu (npx)

Yalnızca Claude Desktop gibi yerel sunucuları çalıştıran istemciler içindir. Node.js 18 veya üzeri gerekir.

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp"],
      "env": {
        "SOCIALAPIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

İstemci kurulumu

Claude Code

claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

VS Code

.vscode/mcp.json dosyasına ekleyin. VS Code, sunucu başladığında anahtarı sorar; bu nedenle anahtar dosyada saklanmaz:

{
  "servers": {
    "socialapis": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:socialapis-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "socialapis-key",
      "description": "SocialAPIs API key",
      "password": true
    }
  ]
}

Cline

MCP Servers → Configure bölümünde cline_mcp_settings.json dosyasına ekleyin:

{
  "mcpServers": {
    "socialapis": {
      "type": "streamableHttp",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "socialapis": {
      "serverUrl": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Kullanılabilir araçlar

Geçerli sürüm: 2.0.2. Sunucuda 12 salt okunur araç bulunur. Her araç tek bir kaynağı kapsar ve bir action bağımsız değişkeninin yanı sıra ilgili eylemin girdilerini alır:

AraçEylemler
facebook_pagedetails, id, posts, videos, reels, albums, album_items
facebook_groupdetails, id, posts, videos, albums, album_items
facebook_postdetails, details_extended, id, attachments, video, comments, comment_replies
facebook_searchpages, people, posts, videos, locations
facebook_adssearch, keywords, page_details, archive_details, countries
facebook_marketplacesearch, vehicles, rentals, listing, seller, categories, city_coordinates
facebook_media_downloaddownload
instagram_profiledetails, id, posts, reels, highlights, highlight_details
instagram_postdetails, id
instagram_reelsfeed, by_audio
instagram_searchsearch
instagram_locationposts, nearby

Örnek çağrı:

{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }

Eksik bir action veya gerekli girdi, herhangi bir kredi harcanmadan önce hata döndürür. İstemcinizdeki her aracın açıklamasında eylem başına aynı girdiler listelenir.

1.x sürümünden mi yükseltiyorsunuz? Eski uç nokta başına araç adları (ör. facebook_get_page_details) doğrudan çağrıldığında hâlâ çalışır; dolayısıyla mevcut betikler çalışmaya devam eder. İstemciniz araçları ada göre otomatik onaylıyor veya izin listesine alıyorsa yukarıdaki yeni adları ekleyin.

Eyleme göre girdiler

Aksi belirtilmedikçe krediler çağrı başınadır. Sayfalama: sonraki sayfayı almak için yanıttaki end_cursor değerini gönderin.

facebook_page

Facebook sayfaları: profil ayrıntıları, sayfa kimliği, gönderiler, videolar, Reels ve fotoğraf albümleri.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
detailslinkexact_followers_count1 (exact_followers_count=true ile 5)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezoneDöndürülen her 3 gönderi için 1 (en az 1)
videoslink veya profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (id kaynağından)limit (8-16), end_cursor1
album_itemsalbum_id (albums kaynağından)end_cursor1

facebook_group

Herkese açık Facebook grupları: ayrıntılar, grup kimliği, gönderiler, videolar ve fotoğraf albümleri.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezoneDöndürülen her 3 gönderi için 1 (en az 1)
videoslinkend_cursor1
albumsgroup_id (id kaynağından)limit (8-16)1
album_itemsalbum_id (albums kaynağından)end_cursor1

facebook_post

Facebook gönderileri, videoları ve yorumları: gönderi ayrıntıları, ekler, yorumlar ve yanıtlar.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
detailslink—1
details_extendedlink—1
idlink—1
attachmentspost_id—5
videovideo_id—1
commentslinklimit, end_cursor, include_reply_info1
comment_repliescomment_feedback_id, expansion_token—1

facebook_search

Facebook'ta anahtar kelimeyle arama: sayfalar, kişiler, gönderiler, videolar ve konumlar.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
pagesquerylocation_uid, end_cursor1
peoplequerylocation_uid, end_cursor1
postsquerylocation_uid, start_time, end_time, recent_posts, end_cursor1
videosquerymost_recent, videos_live, fields, end_cursor1
locationsquery—1

facebook_ads

Meta Ads Library: reklamları arama, anahtar kelimeyle reklamveren bulma, reklamveren sayfası ayrıntıları, tekil reklam ayrıntıları ve desteklenen ülkeler.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
search—query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor1
keywordsquerycountry1
page_detailspage_id—1
archive_detailsad_archive_idpage_id, country, is_ad_non_political, is_ad_not_aaa_eligible1
countries——1

facebook_marketplace

Facebook Marketplace: ilanları, araçları ve kiralık yerleri arama; ilan ve satıcı ayrıntıları; kategoriler ve şehir koordinatları.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
search—query, category_url, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, limit, end_cursor1
vehicles—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, end_cursor1
rentals—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, end_cursor1
listinglisting_id—1
sellerseller_id—1
categories——1
city_coordinatescitycountry, exactly_one1

facebook_media_download

Facebook medyasını (görseller, videolar, ses) bir URL'den indirme.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
downloadurl—1

instagram_profile

Instagram profilleri: ayrıntılar, kullanıcı kimliği, gönderiler, Reels, öne çıkanlar ve öne çıkan hikâyeleri.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Instagram gönderileri: gönderinin tüm ayrıntıları veya gönderi URL'sindeki kısa kod.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: trend akışı veya belirtilen ses parçasını kullanan Reels.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Instagram'da popüler kullanıcıları, hashtag'leri ve yerleri anahtar kelimeyle arama.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
searchkeywordend_cursor1

instagram_location

Instagram konumları: bir yerde etiketlenen gönderiler ve yakındaki yerler.

EylemGerekli girdilerİsteğe bağlı girdilerKrediler
postslocation_idtab, end_cursor1
nearbylocation_id—1

Örnek istemler

"Nike'ın Facebook sayfası ayrıntılarını al ve son 10 gönderisini özetle."

"Instagram'da Adidas ve Nike'ın takipçi sayılarını karşılaştır."

"ABD'de 'running shoes' ifadesinden bahseden aktif reklamları Meta Ads Library'de bul."

Sorun giderme

BelirtiÇözüm
Missing SocialAPIs API keyAuthorization: Bearer <key> başlığını (barındırılan) veya SOCIALAPIS_API_KEY değerini (npx) ekleyin.
Bir sonuçta HTTP 401 veya 403Anahtarı dashboard'dan yeniden kopyalayın.
Insufficient creditssocialapis.io/pricing adresinden planınızı yükseltin veya kredi yükleyin.
Araç listelenmiyorYapılandırmayı düzenledikten sonra istemciyi yeniden başlatın ve https://mcp.socialapis.io/health yanıt verdiğini kontrol edin (tarayıcıda açın).

Bize ulaşın

Sunucu, resmî MCP Registry üzerinde io.github.SocialAPIsHub/social-media-api adıyla listelenmiştir; ayrıca Smithery, Glama, cursor.directory, LobeHub, mcp.so ve mcpservers.org'da da bulunur. Bağlantılar için socialapis.io/integrations sayfasına bakın.

Kaynak kodu: github.com/SocialAPIsHub/mcp-server. Sorularınız için: support@socialapis.io.