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のプロフィール、投稿、リール、位置情報です。各ツールは1つのリソースを対象とし、action 引数を受け取ります。すべての呼び出しは、請求されたクレジット数と残りのクレジット数を含む構造化出力を返します。
1. APIキーを取得する
SocialAPIs.io に登録し、ダッシュボードからキーをコピーします。無料プランでは月200クレジットを利用でき、クレジットカードは不要です。
2. クライアントを接続する
接続方法は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個の読み取り専用ツールがあります。各ツールは1つのリソースを対象とし、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のフォロワー数を比較して。」
「米国のMeta Ads Libraryで、『running shoes』に言及している配信中の広告を探して。」
トラブルシューティング
| 症状 | 対処方法 |
|---|---|
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。