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_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

उदाहरण कॉल:

{ "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, पोस्ट, वीडियो, रील और फ़ोटो एल्बम।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
detailslinkexact_followers_count1 (exact_followers_count=true के साथ 5)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezoneलौटाए गए हर 3 पोस्ट पर 1 (न्यूनतम 1)
videoslink या profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (id से)limit (8-16), end_cursor1
album_itemsalbum_id (albums से)end_cursor1

facebook_group

सार्वजनिक Facebook समूह: विवरण, समूह ID, पोस्ट, वीडियो और फ़ोटो एल्बम।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezoneलौटाए गए हर 3 पोस्ट पर 1 (न्यूनतम 1)
videoslinkend_cursor1
albumsgroup_id (id से)limit (8-16)1
album_itemsalbum_id (albums से)end_cursor1

facebook_post

Facebook पोस्ट, वीडियो और टिप्पणियाँ: पोस्ट का विवरण, अटैचमेंट, टिप्पणियाँ और जवाब।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
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 पर खोजें: पेज, लोग, पोस्ट, वीडियो और लोकेशन।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
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: विज्ञापन खोजें, कीवर्ड से विज्ञापनदाता ढूँढ़ें, विज्ञापनदाता के पेज का विवरण, किसी एक विज्ञापन का विवरण और समर्थित देश।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
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: लिस्टिंग, वाहन और किराये की जगहें खोजें; लिस्टिंग और विक्रेता का विवरण, श्रेणियाँ और शहर के निर्देशांक देखें।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
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

URL से Facebook मीडिया (छवियाँ, वीडियो, ऑडियो) डाउनलोड करें।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
downloadurl—1

instagram_profile

Instagram प्रोफ़ाइल: विवरण, यूज़र ID, पोस्ट, रील, हाइलाइट और हाइलाइट स्टोरीज़।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Instagram पोस्ट: पूरी पोस्ट का विवरण या पोस्ट URL से शॉर्टकोड।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: ट्रेंडिंग फ़ीड या किसी दिए गए ऑडियो ट्रैक का इस्तेमाल करने वाली रील।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

लोकप्रिय यूज़र, हैशटैग और जगहें खोजने के लिए कीवर्ड से Instagram पर खोजें।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
searchkeywordend_cursor1

instagram_location

Instagram लोकेशन: किसी जगह पर टैग की गई पोस्ट और आस-पास की जगहें।

कार्रवाईज़रूरी इनपुटवैकल्पिक इनपुटक्रेडिट
postslocation_idtab, end_cursor1
nearbylocation_id—1

उदाहरण प्रॉम्प्ट

"Nike के Facebook पेज का विवरण प्राप्त करें और उनकी पिछली 10 पोस्ट का सारांश दें।"

"Instagram पर Adidas और Nike के फ़ॉलोअर की संख्या की तुलना करें।"

"US में 'running shoes' का ज़िक्र करने वाले Meta Ads Library के सक्रिय विज्ञापन ढूँढ़ें।"

समस्या निवारण

समस्यासमाधान
Missing SocialAPIs API keyAuthorization: Bearer <key> हेडर (होस्टेड) या SOCIALAPIS_API_KEY (npx) जोड़ें।
किसी परिणाम में HTTP 401 या 403डैशबोर्ड से key फिर से कॉपी करें।
Insufficient creditssocialapis.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।