SocialAPIs — Facebook & Instagram Data
공식AI 에이전트용 Facebook 및 Instagram 데이터 — 페이지, 게시물, 그룹, 광고 라이브러리, 마켓플레이스, 프로필, 릴스. 읽기 전용 도구 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 등에 설치됩니다
문서
AI 어시스턴트가 SocialAPIs Model Context Protocol (MCP) 서버를 통해 공개 Facebook 및 Instagram 데이터에 직접 액세스할 수 있습니다.
이 서버는 50개 작업을 지원하는 읽기 전용 도구 12개를 제공합니다. 페이지, 게시물, 댓글, 그룹, Meta Ads Library, Marketplace, Instagram 프로필, 게시물, 릴스 및 위치를 다룹니다. 각 도구는 하나의 리소스를 다루며 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, 게시물, 동영상, 릴스 및 사진 앨범.
| 작업 | 필수 입력값 | 선택 입력값 | 크레딧 |
|---|---|---|---|
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의 shortcode.
| 작업 | 필수 입력값 | 선택 입력값 | 크레딧 |
|---|---|---|---|
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의 팔로워 수를 비교해 줘."
"미국에서 'running shoes'를 언급하는 Meta Ads Library의 활성 광고를 찾아 줘."
문제 해결
| 증상 | 해결 방법 |
|---|---|
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 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.