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_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のフォロワー数を比較して。」

「米国のMeta Ads Libraryで、『running shoes』に言及している配信中の広告を探して。」

トラブルシューティング

症状対処方法
Missing SocialAPIs API keyAuthorization: Bearer <key> ヘッダー(ホステッド)または SOCIALAPIS_API_KEY(npx)を追加します。
結果にHTTP 401または403が表示されるダッシュボードからキーをコピーし直します。
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。