SocialAPIs — Facebook & Instagram Data
resmiYapay 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_page | details, id, posts, videos, reels, albums, album_items |
facebook_group | details, id, posts, videos, albums, album_items |
facebook_post | details, details_extended, id, attachments, video, comments, comment_replies |
facebook_search | pages, people, posts, videos, locations |
facebook_ads | search, keywords, page_details, archive_details, countries |
facebook_marketplace | search, vehicles, rentals, listing, seller, categories, city_coordinates |
facebook_media_download | download |
instagram_profile | details, id, posts, reels, highlights, highlight_details |
instagram_post | details, id |
instagram_reels | feed, by_audio |
instagram_search | search |
instagram_location | posts, 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.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
details | link | exact_followers_count | 1 (exact_followers_count=true ile 5) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | Döndürülen her 3 gönderi için 1 (en az 1) |
videos | link veya profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (id kaynağından) | limit (8-16), end_cursor | 1 |
album_items | album_id (albums kaynağından) | end_cursor | 1 |
facebook_group
Herkese açık Facebook grupları: ayrıntılar, grup kimliği, gönderiler, videolar ve fotoğraf albümleri.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | Döndürülen her 3 gönderi için 1 (en az 1) |
videos | link | end_cursor | 1 |
albums | group_id (id kaynağından) | limit (8-16) | 1 |
album_items | album_id (albums kaynağından) | end_cursor | 1 |
facebook_post
Facebook gönderileri, videoları ve yorumları: gönderi ayrıntıları, ekler, yorumlar ve yanıtlar.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
details | link | — | 1 |
details_extended | link | — | 1 |
id | link | — | 1 |
attachments | post_id | — | 5 |
video | video_id | — | 1 |
comments | link | limit, end_cursor, include_reply_info | 1 |
comment_replies | comment_feedback_id, expansion_token | — | 1 |
facebook_search
Facebook'ta anahtar kelimeyle arama: sayfalar, kişiler, gönderiler, videolar ve konumlar.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
pages | query | location_uid, end_cursor | 1 |
people | query | location_uid, end_cursor | 1 |
posts | query | location_uid, start_time, end_time, recent_posts, end_cursor | 1 |
videos | query | most_recent, videos_live, fields, end_cursor | 1 |
locations | query | — | 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.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
search | — | query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor | 1 |
keywords | query | country | 1 |
page_details | page_id | — | 1 |
archive_details | ad_archive_id | page_id, country, is_ad_non_political, is_ad_not_aaa_eligible | 1 |
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ı.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
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_cursor | 1 |
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_cursor | 1 |
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_cursor | 1 |
listing | listing_id | — | 1 |
seller | seller_id | — | 1 |
categories | — | — | 1 |
city_coordinates | city | country, exactly_one | 1 |
facebook_media_download
Facebook medyasını (görseller, videolar, ses) bir URL'den indirme.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Instagram profilleri: ayrıntılar, kullanıcı kimliği, gönderiler, Reels, öne çıkanlar ve öne çıkan hikâyeleri.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
details | username | link | 1 |
id | — | link, username | 1 |
posts | — | username, user_id, end_cursor | 1 |
reels | user_id | end_cursor | 1 |
highlights | user_id | — | 1 |
highlight_details | highlight_id | — | 1 |
instagram_post
Instagram gönderileri: gönderinin tüm ayrıntıları veya gönderi URL'sindeki kısa kod.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: trend akışı veya belirtilen ses parçasını kullanan Reels.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
Instagram'da popüler kullanıcıları, hashtag'leri ve yerleri anahtar kelimeyle arama.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Instagram konumları: bir yerde etiketlenen gönderiler ve yakındaki yerler.
| Eylem | Gerekli girdiler | İsteğe bağlı girdiler | Krediler |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_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 key | Authorization: Bearer <key> başlığını (barındırılan) veya SOCIALAPIS_API_KEY değerini (npx) ekleyin. |
| Bir sonuçta HTTP 401 veya 403 | Anahtarı dashboard'dan yeniden kopyalayın. |
Insufficient credits | socialapis.io/pricing adresinden planınızı yükseltin veya kredi yükleyin. |
| Araç listelenmiyor | Yapı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.