SocialAPIs — Facebook & Instagram Data
resmiData 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:
| Alat | Tindakan |
|---|---|
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 |
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.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 dengan exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 per 3 postingan yang dikembalikan (min. 1) |
videos | link atau profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (dari id) | limit (8-16), end_cursor | 1 |
album_items | album_id (dari albums) | end_cursor | 1 |
facebook_group
Grup Facebook publik: detail, ID grup, postingan, video, dan album foto.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 per 3 postingan yang dikembalikan (min. 1) |
videos | link | end_cursor | 1 |
albums | group_id (dari id) | limit (8-16) | 1 |
album_items | album_id (dari albums) | end_cursor | 1 |
facebook_post
Postingan, video, dan komentar Facebook: detail postingan, lampiran, komentar, dan balasan.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
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
Cari di Facebook berdasarkan kata kunci: halaman, orang, postingan, video, dan lokasi.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
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: cari iklan, temukan pengiklan berdasarkan kata kunci, detail halaman pengiklan, detail satu iklan, dan negara yang didukung.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
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: cari listing, kendaraan, dan properti sewaan; detail listing dan penjual; kategori; serta koordinat kota.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
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
Unduh media Facebook (gambar, video, audio) dari URL.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Profil Instagram: detail, ID pengguna, postingan, reels, sorotan, dan cerita sorotan.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
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
Postingan Instagram: detail lengkap postingan, atau shortcode dari URL postingan.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: feed yang sedang tren, atau reels yang menggunakan trek audio tertentu.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
Cari pengguna populer, tagar, dan tempat di Instagram berdasarkan kata kunci.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Lokasi Instagram: postingan yang ditandai di suatu tempat dan tempat di sekitar.
| Tindakan | Input wajib | Input opsional | Kredit |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_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
| Gejala | Solusi |
|---|---|
Missing SocialAPIs API key | Tambahkan header Authorization: Bearer <key> (ter-host) atau SOCIALAPIS_API_KEY (npx). |
| HTTP 401 atau 403 dalam hasil | Salin ulang kunci dari dasbor. |
Insufficient credits | Tingkatkan paket atau isi ulang di socialapis.io/pricing. |
| Tidak ada alat yang tercantum | Mulai 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.