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_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 страницы, публикации, видео, Reels и фотоальбомы.
| Действие | Обязательные входные параметры | Необязательные входные параметры | Кредиты |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 с exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 за каждые 3 возвращённые публикации (минимум 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 | 1 за каждые 3 возвращённые публикации (минимум 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: поиск объявлений, поиск рекламодателей по ключевым словам, сведения о страницах рекламодателей, сведения об отдельном объявлении и поддерживаемые страны.
| Действие | Обязательные входные параметры | Необязательные входные параметры | Кредиты |
|---|---|---|---|
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
Загрузка медиафайлов Facebook (изображений, видео, аудио) по URL.
| Действие | Обязательные входные параметры | Необязательные входные параметры | Кредиты |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Профили Instagram: сведения, ID пользователя, публикации, Reels, подборки и истории из подборок.
| Действие | Обязательные входные параметры | Необязательные входные параметры | Кредиты |
|---|---|---|---|
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: полные сведения о публикации или shortcode из URL публикации.
| Действие | Обязательные входные параметры | Необязательные входные параметры | Кредиты |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: популярная лента или 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 публикаций».
«Сравните количество подписчиков 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.