SocialAPIs — Facebook & Instagram Data

resmi

Data Facebook & Instagram untuk agen AI — halaman, postingan, grup, Ads Library, Marketplace, profil, dan reels. 47 alat read-only, output terstruktur. Tier gratis: 200 panggilan/bulan.

Apa yang bisa Anda lakukan dengan SocialAPIs — Facebook & Instagram Data MCP?

  • Data halaman dan grup Facebook — Ambil detail halaman atau grup, postingan, video, reels, dan album foto melalui tautan atau ID.
  • Pencarian postingan dan komentar Facebook — Ambil detail postingan, lampiran, komentar, dan balasan komentar dari tautan postingan.
  • Pencarian Meta Ads Library — Cari iklan berdasarkan kata kunci atau pengiklan, dapatkan detail halaman pengiklan, dan lihat daftar negara yang didukung.
  • Data profil dan postingan Instagram — Ambil detail profil, postingan, reels, sorotan, dan detail lengkap postingan berdasarkan nama pengguna atau shortcode.
  • Pencarian dan lokasi Instagram — Cari pengguna, tagar, dan tempat berdasarkan kata kunci, atau lihat daftar postingan yang ditandai di suatu lokasi.
  • Pencarian Facebook Marketplace — Cari listing, kendaraan, dan properti sewaan dengan filter, serta dapatkan detail listing atau penjual.

Server MCP Terhosting

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

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Berikan asisten AI akses langsung ke data publik Facebook dan Instagram dengan server Model Context Protocol (MCP) SocialAPIs.

Server ini menyediakan 12 alat hanya-baca yang mencakup 50 tindakan: halaman, postingan, komentar, grup, Meta Ads Library, Marketplace, profil Instagram, postingan, reels, dan lokasi. Setiap alat mencakup satu sumber daya dan menerima argumen action. Setiap panggilan mengembalikan output terstruktur, termasuk kredit yang dikenakan dan sisa kredit.

1. Dapatkan kunci API

Daftar di socialapis.io dan salin kunci Anda dari dasbor. Paket gratis mencakup 200 kredit per bulan, tanpa perlu kartu kredit.

2. Hubungkan klien Anda

Ada dua cara untuk terhubung.

Endpoint ter-host (disarankan)

Tidak perlu menginstal apa pun. Arahkan klien apa pun yang mendukung server MCP jarak jauh ke:

https://mcp.socialapis.io/mcp

Kirim kunci Anda di header:

Authorization: Bearer YOUR_API_KEY

x-api-token: YOUR_API_KEY juga bisa digunakan. Jangan pernah memasukkan kunci ke dalam URL.

Server lokal (npx)

Untuk klien yang hanya menjalankan server lokal, seperti Claude Desktop. Memerlukan Node.js 18 atau yang lebih baru.

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

Penyiapan klien

Claude Code

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

VS Code

Tambahkan ke .vscode/mcp.json. VS Code meminta kunci saat server dimulai, sehingga kunci tidak disimpan di dalam file:

{
  "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

Di MCP Servers → Configure, tambahkan ke cline_mcp_settings.json:

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

Windsurf

Tambahkan ke ~/.codeium/windsurf/mcp_config.json:

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

Alat yang tersedia

Versi saat ini: 2.0.2. Server ini memiliki 12 alat hanya-baca. Setiap alat mencakup satu sumber daya dan menerima argumen action, ditambah input untuk tindakan tersebut:

AlatTindakan
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

Contoh panggilan:

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

action atau input wajib yang tidak disertakan akan menghasilkan error sebelum kredit apa pun digunakan. Deskripsi setiap alat di klien Anda mencantumkan input yang sama untuk setiap tindakan.

Meng-upgrade dari 1.x? Nama alat lama per endpoint (seperti facebook_get_page_details) tetap berfungsi jika dipanggil secara langsung, sehingga skrip yang sudah ada tetap berjalan. Jika klien Anda menyetujui otomatis atau membatasi alat berdasarkan nama, tambahkan nama-nama baru di atas.

Input berdasarkan tindakan

Kredit dihitung per panggilan, kecuali jika disebutkan lain. Paginasi: teruskan end_cursor dari respons untuk mendapatkan halaman berikutnya.

facebook_page

Halaman Facebook: detail profil, ID halaman, postingan, video, reels, dan album foto.

TindakanInput wajibInput opsionalKredit
detailslinkexact_followers_count1 (5 dengan exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 per 3 postingan yang dikembalikan (min. 1)
videoslink atau profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (dari id)limit (8-16), end_cursor1
album_itemsalbum_id (dari albums)end_cursor1

facebook_group

Grup Facebook publik: detail, ID grup, postingan, video, dan album foto.

TindakanInput wajibInput opsionalKredit
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 per 3 postingan yang dikembalikan (min. 1)
videoslinkend_cursor1
albumsgroup_id (dari id)limit (8-16)1
album_itemsalbum_id (dari albums)end_cursor1

facebook_post

Postingan, video, dan komentar Facebook: detail postingan, lampiran, komentar, dan balasan.

TindakanInput wajibInput opsionalKredit
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

Cari di Facebook berdasarkan kata kunci: halaman, orang, postingan, video, dan lokasi.

TindakanInput wajibInput opsionalKredit
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: cari iklan, temukan pengiklan berdasarkan kata kunci, detail halaman pengiklan, detail satu iklan, dan negara yang didukung.

TindakanInput wajibInput opsionalKredit
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: cari listing, kendaraan, dan properti sewaan; detail listing dan penjual; kategori; serta koordinat kota.

TindakanInput wajibInput opsionalKredit
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

Unduh media Facebook (gambar, video, audio) dari URL.

TindakanInput wajibInput opsionalKredit
downloadurl—1

instagram_profile

Profil Instagram: detail, ID pengguna, postingan, reels, sorotan, dan cerita sorotan.

TindakanInput wajibInput opsionalKredit
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Postingan Instagram: detail lengkap postingan, atau shortcode dari URL postingan.

TindakanInput wajibInput opsionalKredit
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: feed yang sedang tren, atau reels yang menggunakan trek audio tertentu.

TindakanInput wajibInput opsionalKredit
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Cari pengguna populer, tagar, dan tempat di Instagram berdasarkan kata kunci.

TindakanInput wajibInput opsionalKredit
searchkeywordend_cursor1

instagram_location

Lokasi Instagram: postingan yang ditandai di suatu tempat dan tempat di sekitar.

TindakanInput wajibInput opsionalKredit
postslocation_idtab, end_cursor1
nearbylocation_id—1

Contoh prompt

"Ambil detail halaman Facebook Nike dan rangkum 10 postingan terakhir mereka."

"Bandingkan jumlah pengikut Adidas dan Nike di Instagram."

"Temukan iklan aktif di Meta Ads Library yang menyebut 'running shoes' di AS."

Pemecahan masalah

GejalaSolusi
Missing SocialAPIs API keyTambahkan header Authorization: Bearer <key> (ter-host) atau SOCIALAPIS_API_KEY (npx).
HTTP 401 atau 403 dalam hasilSalin ulang kunci dari dasbor.
Insufficient creditsTingkatkan paket atau isi ulang di socialapis.io/pricing.
Tidak ada alat yang tercantumMulai ulang klien setelah mengedit konfigurasinya, dan periksa apakah https://mcp.socialapis.io/health merespons (buka di browser).

Temukan kami

Server ini tercantum di Official MCP Registry sebagai io.github.SocialAPIsHub/social-media-api, serta di Smithery, Glama, cursor.directory, LobeHub, mcp.so, dan mcpservers.org. Lihat socialapis.io/integrations untuk tautan.

Kode sumber: github.com/SocialAPIsHub/mcp-server. Pertanyaan: support@socialapis.io.