SocialAPIs — Facebook & Instagram Data
आधिकारिकAI एजेंट्स के लिए Facebook और Instagram डेटा — पेज, पोस्ट, ग्रुप, Ads Library, Marketplace, प्रोफाइल और रील्स। 47 रीड-ओनली टूल, संरचित आउटपुट। फ्री टियर: 200 कॉल/महीना।
SocialAPIs — Facebook & Instagram Data MCP के साथ आप क्या कर सकते हैं?
- Facebook पेज और ग्रुप का डेटा — लिंक या ID से पेज या ग्रुप की जानकारी, पोस्ट, वीडियो, रील और फ़ोटो एल्बम प्राप्त करें।
- Facebook पोस्ट और टिप्पणियों की खोज — पोस्ट के लिंक से पोस्ट की जानकारी, अटैचमेंट, टिप्पणियाँ और टिप्पणी के जवाब प्राप्त करें।
- Meta Ads Library में खोज — कीवर्ड या विज्ञापनदाता के आधार पर विज्ञापन खोजें, विज्ञापनदाता के पेज की जानकारी प्राप्त करें और समर्थित देशों की सूची देखें।
- Instagram प्रोफ़ाइल और पोस्ट का डेटा — यूज़रनेम या शॉर्टकोड से प्रोफ़ाइल की जानकारी, पोस्ट, रील, हाइलाइट और पोस्ट की पूरी जानकारी प्राप्त करें।
- Instagram खोज और लोकेशन — कीवर्ड से यूज़र, हैशटैग और जगहें खोजें, या किसी लोकेशन पर टैग की गई पोस्ट की सूची देखें।
- Facebook Marketplace में खोज — फ़िल्टर के साथ लिस्टिंग, वाहन और किराये की जगहें खोजें, और लिस्टिंग या विक्रेता की जानकारी प्राप्त करें।
होस्ट किया गया MCP सर्वर
npx add-mcp 'https://mcp.socialapis.io/mcp'Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है
दस्तावेज़
SocialAPIs Model Context Protocol (MCP) सर्वर के ज़रिए AI सहायकों को सार्वजनिक Facebook और Instagram डेटा तक सीधी पहुँच दें।
यह सर्वर 50 कार्रवाइयों को कवर करने वाले 12 केवल-पढ़ने वाले टूल उपलब्ध कराता है: पेज, पोस्ट, टिप्पणियाँ, समूह, Meta Ads Library, Marketplace, Instagram प्रोफ़ाइल, पोस्ट, रील और लोकेशन। हर टूल एक संसाधन को कवर करता है और एक action आर्ग्युमेंट लेता है। हर कॉल संरचित आउटपुट लौटाती है, जिसमें खर्च किए गए और शेष क्रेडिट शामिल होते हैं।
1. API key प्राप्त करें
socialapis.io पर साइन अप करें और डैशबोर्ड से अपनी key कॉपी करें। मुफ़्त प्लान में हर महीने 200 क्रेडिट शामिल हैं; क्रेडिट कार्ड की ज़रूरत नहीं है।
2. अपने क्लाइंट को कनेक्ट करें
कनेक्ट करने के दो तरीके हैं।
होस्टेड एंडपॉइंट (अनुशंसित)
इंस्टॉल करने के लिए कुछ नहीं। रिमोट MCP सर्वर का समर्थन करने वाले किसी भी क्लाइंट को यहाँ पॉइंट करें:
https://mcp.socialapis.io/mcp
हेडर में अपनी key भेजें:
Authorization: Bearer YOUR_API_KEY
x-api-token: YOUR_API_KEY भी काम करता है। key को URL में कभी न डालें।
लोकल सर्वर (npx)
उन क्लाइंट के लिए जो केवल लोकल सर्वर चलाते हैं, जैसे Claude Desktop। इसके लिए Node.js 18 या नया संस्करण चाहिए।
{
"mcpServers": {
"socialapis": {
"command": "npx",
"args": ["-y", "@socialapis/mcp"],
"env": {
"SOCIALAPIS_API_KEY": "YOUR_API_KEY"
}
}
}
}
क्लाइंट सेटअप
Claude Code
claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
VS Code
.vscode/mcp.json में जोड़ें। सर्वर शुरू होने पर VS Code key पूछता है, इसलिए यह फ़ाइल में संग्रहीत नहीं होती:
{
"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 में, cline_mcp_settings.json में जोड़ें:
{
"mcpServers": {
"socialapis": {
"type": "streamableHttp",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json में जोड़ें:
{
"mcpServers": {
"socialapis": {
"serverUrl": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
उपलब्ध टूल
वर्तमान संस्करण: 2.0.2। सर्वर में 12 केवल-पढ़ने वाले टूल हैं। हर टूल एक संसाधन को कवर करता है और एक action आर्ग्युमेंट के साथ उस कार्रवाई के इनपुट लेता है:
| टूल | कार्रवाइयाँ |
|---|---|
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 |
उदाहरण कॉल:
{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }
अगर action या कोई ज़रूरी इनपुट मौजूद न हो, तो कोई क्रेडिट खर्च होने से पहले ही त्रुटि लौटाई जाती है। आपके क्लाइंट में हर टूल का विवरण, हर कार्रवाई के लिए वही इनपुट सूचीबद्ध करता है।
1.x से अपग्रेड कर रहे हैं? पुराने प्रति-एंडपॉइंट टूल नाम (जैसे facebook_get_page_details) सीधे कॉल किए जाने पर अब भी काम करते हैं, इसलिए मौजूदा स्क्रिप्ट चलती रहेंगी। अगर आपका क्लाइंट नाम के आधार पर टूल को अपने-आप मंज़ूरी देता है या अनुमति-सूची में रखता है, तो ऊपर दिए गए नए नाम जोड़ें।
कार्रवाई के अनुसार इनपुट
जब तक अलग से न बताया गया हो, क्रेडिट प्रति कॉल के हिसाब से लगते हैं। पेजिनेशन के लिए, अगला पेज पाने हेतु प्रतिक्रिया से end_cursor पास करें।
facebook_page
Facebook पेज: प्रोफ़ाइल विवरण, पेज ID, पोस्ट, वीडियो, रील और फ़ोटो एल्बम।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
details | link | exact_followers_count | 1 (exact_followers_count=true के साथ 5) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | लौटाए गए हर 3 पोस्ट पर 1 (न्यूनतम 1) |
videos | link या profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (id से) | limit (8-16), end_cursor | 1 |
album_items | album_id (albums से) | end_cursor | 1 |
facebook_group
सार्वजनिक Facebook समूह: विवरण, समूह ID, पोस्ट, वीडियो और फ़ोटो एल्बम।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | लौटाए गए हर 3 पोस्ट पर 1 (न्यूनतम 1) |
videos | link | end_cursor | 1 |
albums | group_id (id से) | limit (8-16) | 1 |
album_items | album_id (albums से) | end_cursor | 1 |
facebook_post
Facebook पोस्ट, वीडियो और टिप्पणियाँ: पोस्ट का विवरण, अटैचमेंट, टिप्पणियाँ और जवाब।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
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 पर खोजें: पेज, लोग, पोस्ट, वीडियो और लोकेशन।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
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: विज्ञापन खोजें, कीवर्ड से विज्ञापनदाता ढूँढ़ें, विज्ञापनदाता के पेज का विवरण, किसी एक विज्ञापन का विवरण और समर्थित देश।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
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: लिस्टिंग, वाहन और किराये की जगहें खोजें; लिस्टिंग और विक्रेता का विवरण, श्रेणियाँ और शहर के निर्देशांक देखें।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
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
URL से Facebook मीडिया (छवियाँ, वीडियो, ऑडियो) डाउनलोड करें।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Instagram प्रोफ़ाइल: विवरण, यूज़र ID, पोस्ट, रील, हाइलाइट और हाइलाइट स्टोरीज़।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
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 पोस्ट: पूरी पोस्ट का विवरण या पोस्ट URL से शॉर्टकोड।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: ट्रेंडिंग फ़ीड या किसी दिए गए ऑडियो ट्रैक का इस्तेमाल करने वाली रील।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
लोकप्रिय यूज़र, हैशटैग और जगहें खोजने के लिए कीवर्ड से Instagram पर खोजें।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Instagram लोकेशन: किसी जगह पर टैग की गई पोस्ट और आस-पास की जगहें।
| कार्रवाई | ज़रूरी इनपुट | वैकल्पिक इनपुट | क्रेडिट |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_id | — | 1 |
उदाहरण प्रॉम्प्ट
"Nike के Facebook पेज का विवरण प्राप्त करें और उनकी पिछली 10 पोस्ट का सारांश दें।"
"Instagram पर Adidas और Nike के फ़ॉलोअर की संख्या की तुलना करें।"
"US में 'running shoes' का ज़िक्र करने वाले Meta Ads Library के सक्रिय विज्ञापन ढूँढ़ें।"
समस्या निवारण
| समस्या | समाधान |
|---|---|
Missing SocialAPIs API key | Authorization: Bearer <key> हेडर (होस्टेड) या SOCIALAPIS_API_KEY (npx) जोड़ें। |
| किसी परिणाम में HTTP 401 या 403 | डैशबोर्ड से key फिर से कॉपी करें। |
Insufficient credits | socialapis.io/pricing पर अपग्रेड करें या क्रेडिट जोड़ें। |
| कोई टूल सूचीबद्ध नहीं है | कॉन्फ़िगरेशन संपादित करने के बाद क्लाइंट रीस्टार्ट करें और जाँचें कि https://mcp.socialapis.io/health जवाब देता है (इसे ब्राउज़र में खोलें)। |
हमसे कहाँ जुड़ें
यह सर्वर आधिकारिक MCP Registry में io.github.SocialAPIsHub/social-media-api के रूप में सूचीबद्ध है, और Smithery, Glama, cursor.directory, LobeHub, mcp.so और mcpservers.org पर भी उपलब्ध है। लिंक के लिए socialapis.io/integrations देखें।
सोर्स कोड: github.com/SocialAPIsHub/mcp-server। सवाल: support@socialapis.io।