SocialAPIs — Facebook & Instagram Data

официальный

Данные Facebook и Instagram для AI-агентов — страницы, посты, группы, библиотека объявлений, Marketplace, профили и Reels. 47 инструментов только для чтения, структурированный вывод. Бесплатный тариф: 200 вызовов в месяц.

Что можно делать с SocialAPIs — Facebook & Instagram Data MCP?

  • Данные страниц и групп Facebook — Получайте сведения о страницах и группах, публикации, видео, Reels и фотоальбомы по ссылке или ID.
  • Поиск публикаций и комментариев Facebook — Получайте сведения о публикациях, вложения, комментарии и ответы на комментарии по ссылке на публикацию.
  • Поиск в библиотеке рекламы Meta — Ищите рекламу по ключевому слову или рекламодателю, получайте сведения о странице рекламодателя и список поддерживаемых стран.
  • Данные профилей и публикаций Instagram — Получайте сведения о профилях, публикации, Reels, актуальное и полные сведения о публикациях по имени пользователя или shortcode.
  • Поиск в Instagram и места — Ищите пользователей, хэштеги и места по ключевому слову или просматривайте публикации с отметкой места.
  • Поиск на Facebook Marketplace — Ищите объявления, автомобили и аренду с фильтрами, а также получайте сведения об объявлениях и продавцах.

Размещённый MCP-сервер

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

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Предоставьте ИИ-ассистентам прямой доступ к общедоступным данным Facebook и Instagram с помощью сервера SocialAPIs Model Context Protocol (MCP).

Сервер предоставляет 12 инструментов только для чтения, охватывающих 50 действий: страницы, публикации, комментарии, группы, библиотека рекламы Meta, Marketplace, профили Instagram, публикации, Reels и местоположения. Каждый инструмент охватывает один ресурс и принимает аргумент action. Каждый вызов возвращает структурированный результат, включая списанное и оставшееся количество кредитов.

1. Получите API-ключ

Зарегистрируйтесь на socialapis.io и скопируйте ключ из панели управления. Бесплатный план включает 200 кредитов в месяц, банковская карта не требуется.

2. Подключите клиент

Есть два способа подключения.

Размещённая конечная точка (рекомендуется)

Ничего устанавливать не нужно. Укажите для любого клиента, поддерживающего удалённые MCP-серверы, адрес:

https://mcp.socialapis.io/mcp

Передайте ключ в заголовке:

Authorization: Bearer YOUR_API_KEY

Также поддерживается x-api-token: YOUR_API_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 запрашивает ключ при запуске сервера, поэтому он не сохраняется в файле:

{
  "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 страницы, публикации, видео, Reels и фотоальбомы.

ДействиеОбязательные входные параметрыНеобязательные входные параметрыКредиты
detailslinkexact_followers_count1 (5 с exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 за каждые 3 возвращённые публикации (минимум 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, timezone1 за каждые 3 возвращённые публикации (минимум 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: поиск объявлений, поиск рекламодателей по ключевым словам, сведения о страницах рекламодателей, сведения об отдельном объявлении и поддерживаемые страны.

ДействиеОбязательные входные параметрыНеобязательные входные параметрыКредиты
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

Загрузка медиафайлов Facebook (изображений, видео, аудио) по URL.

ДействиеОбязательные входные параметрыНеобязательные входные параметрыКредиты
downloadurl—1

instagram_profile

Профили Instagram: сведения, ID пользователя, публикации, Reels, подборки и истории из подборок.

ДействиеОбязательные входные параметрыНеобязательные входные параметрыКредиты
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Публикации Instagram: полные сведения о публикации или shortcode из URL публикации.

ДействиеОбязательные входные параметрыНеобязательные входные параметрыКредиты
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: популярная лента или 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 публикаций».

«Сравните количество подписчиков Adidas и Nike в Instagram».

«Найдите активные объявления в библиотеке рекламы Meta, в которых упоминаются „кроссовки для бега“ в США».

Устранение неполадок

ПроблемаРешение
Missing SocialAPIs API keyДобавьте заголовок Authorization: Bearer <key> (размещённый сервер) или SOCIALAPIS_API_KEY (npx).
HTTP 401 или 403 в результатеСкопируйте ключ из панели управления ещё раз.
Insufficient creditsПерейдите на платный план или пополните баланс на socialapis.io/pricing.
Инструменты не отображаютсяПерезапустите клиент после изменения конфигурации и проверьте, отвечает ли https://mcp.socialapis.io/health (откройте его в браузере).

Где нас найти

Сервер представлен в официальном реестре MCP под именем 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.