FastSocial Instagram Data

Instagram Data MCP サーバー

AI アシスタントを FastSocial の Instagram Data API に接続すると、公開されている Instagram プロフィール、投稿、リール、ストーリーズ、ハイライト、コメント、ハッシュタグ、場所、音声を検索できます。読み取り専用です。投稿、フォロー、「いいね」、メッセージの送信は行いません。

サーバーはリモートサーバーです。インストールや実行は不要です。アシスタントは Streamable HTTP 経由で

https://data.fastsocial.co/mcp

に接続します。初回の接続時には、ブラウザーで fastsocial.co のページが開きます。サインインして「許可」をクリックしてください。

このリポジトリには、プラグインマニフェスト（plugin.json、mcp.json、および Cursor が読み込む .cursor-plugin/ 内のコピー）、公式 MCP Registry に io.github.FastSocialCo/instagram-data-mcp としてサーバーを登録する server.json、LobeHub マニフェストが含まれています。お使いのマシン上で実行されるコードは含まれていません。サーバーのコードもここにはありません。

インストール

Cursor

cursor.directory からプラグインをインストールするか、サーバーを .cursor/mcp.json（1 つのプロジェクト）または ~/.cursor/mcp.json（すべてのプロジェクト）に追加します。

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

「設定」を開き、「MCP」を選択して接続します。Cursor に FastSocial のサインインページが表示されます。

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

次に、Claude Code 内で /mcp を実行し、instagram-data を選択してサインインします。

Claude アプリ（ウェブおよびデスクトップ）

1. 「設定」を開き、「コネクター」を選択して、カスタムコネクターを追加します。
2. サーバー URL として https://data.fastsocial.co/mcp を貼り付けます。
3. OAuth クライアント ID とシークレットは空欄のままにします。
4. 接続し、開いた FastSocial のページでサインインします。

VS Code およびその他のクライアント

Streamable HTTP 経由の MCP に対応するクライアントであれば、サーバー URL を使って接続できます。VS Code では、.vscode/mcp.json に以下を追加して「開始」を押します。

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

このプラグインの機能と送信されるデータ

プラグイン自体

このプラグインは、サーバーのアドレスをクライアントに伝える 2 つの JSON ファイルで構成されています。コードは実行せず、インストールスクリプトもなく、何も保存しません。すべてのリクエストはクライアントが直接、HTTPS 経由で https://data.fastsocial.co/mcp に送信します。

クライアントが送信する内容

• **MCP ハンドシェイク：**クライアントの名前とバージョン、および使用するプロトコルのバージョン。
• **各ツール呼び出し：**ツール名と引数です。引数は、Instagram のユーザー名またはユーザー ID、投稿やリールのリンク、ハッシュタグ、検索語、場所、音声またはハイライトの ID、ページングカーソルなど、問い合わせた内容です。全項目は以下の表に記載されています。
• **サインイントークンまたは API キー：**リクエストヘッダーに含まれます。URL には含まれません。
• IP アドレスやクライアントのユーザーエージェントなど、通常のウェブリクエスト情報。

これ以外は送信されません。サーバーに見えるのは、アシスタントがツール呼び出しに含める引数だけです。ファイル、エディター、会話の内容は見えません。

返される内容

公開されている Instagram データが JSON で返され、meta.credits_remaining も含まれます。写真と動画はファイルではなくリンクとして返されます。非公開アカウントの場合は private_account エラーが返されます。Instagram アカウントの所有者はオプトアウトできます。その場合、そのアカウントについて API は 451 opted_out を返します。

読み取り専用

すべてのツールは読み取り専用です。Instagram 上の情報を変更するツールはありません。呼び出しによって変わるのは、月ごとの自身のクレジット残高だけです。サーバーは tools/list で、すべてのツールに readOnlyHint: true と openWorldHint: true を設定しています。書き込みや削除を行うツールはありません。

サインイン

クライアントが初めて接続すると、サーバーはサインインが必要であることと、手順を確認できる場所を返します。クライアントはブラウザーで fastsocial.co のページを開きます。そこで次の操作を行います。

1. メールアドレスと、FastSocial からメールで届いたコードを入力します。
2. どのアプリが要求しているかを確認し、Allow（許可）または Deny（拒否）をクリックします。

まだプランをお持ちでない場合は、Allow をクリックすると Free プランが作成されます。アシスタントにパスワードを入力することはなく、プラグインが認証情報を見ることも保存することもありません。クライアントは受け取ったトークンを保持します。アクセストークンの有効期間は 1 時間です。クライアントは、有効期間が 30 日で、使用するたびに変わるリフレッシュトークンを使って更新します。

接続したすべてのアプリを無効にするには、https://fastsocial.co/cart/api/account にサインインして、New key を押します。古いキーに紐付いたサインインはすべて、直ちに機能しなくなります。

クライアント開発者向け：検出は https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp から始まります。認可サーバーは、パブリッククライアント向けに PKCE（S256 のみ）を使用する OAuth 2.1、動的クライアント登録、トークンの取り消しをサポートしています。

代わりに API キーを使う

クライアントがヘッダーを設定できてもサインインできない場合は、https://fastsocial.co/instagram-api?ref=github でキーを取得し、すべてのリクエストに X-API-Key: YOUR_KEY（または Authorization: Bearer YOUR_KEY）として送信します。Claude Code の場合：

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

コミットするファイルにキーを記載しないでください。

ポリシー

• プライバシーポリシー：https://fastsocial.co/privacy
• 利用規約：https://fastsocial.co/terms
• データの利用ポリシー（公開データのみ。人々の追跡や嫌がらせは禁止。未成年者に関する情報も禁止）：https://fastsocial.co/instagram-api/docs?ref=github
• セキュリティ上の問題の報告：SECURITY.md

28 個のツール

各呼び出しで、毎月の利用枠からクレジットが消費されます。失敗した呼び出しではクレジットは消費されません。すべてのツールは読み取り専用です。

ツール	機能	引数	クレジット
instagram_profile	Instagram プロフィールを取得します	username または user_id	1
instagram_user_id	Instagram のユーザー名からユーザー ID を取得します	username または user_id	1
instagram_username	Instagram のユーザー ID からユーザー名を取得します	user_id	2
instagram_check	Instagram のハンドルが存在し、公開されているか確認します	username	1
instagram_posts	Instagram の最近の投稿を取得します	username または user_id、cursor	1
instagram_reels	アカウントの Instagram リールを取得します	username または user_id、cursor	1
instagram_tagged	アカウントがタグ付けされている投稿を取得します	username または user_id、cursor	1
instagram_post	Instagram の投稿またはリールを 1 件取得します	url または shortcode	1
instagram_media	投稿、リール、カルーセルのダウンロード URL を取得します	url または shortcode	1
instagram_comments	Instagram の投稿に付いたコメントを取得します	url または shortcode	3
instagram_comment_replies	Instagram のコメントへの返信を取得します	url または shortcode、comment_id、cursor	3
instagram_likers	Instagram の投稿に「いいね！」したアカウントを取得します	url または shortcode	3
instagram_insights	Instagram のエンゲージメント率を計算します	username または user_id	2
instagram_followers	アカウントのフォロワーを取得します	username または user_id、cursor	3
instagram_following	アカウントがフォローしているアカウントを取得します	username または user_id、cursor	3
instagram_similar	類似した Instagram アカウントを見つけます	username または user_id	1
instagram_stories	Instagram ストーリーズを匿名で閲覧します	username または user_id	3
instagram_highlights	Instagram ストーリーズのハイライトを取得します	username または user_id	3
instagram_highlight	1 件のハイライトに含まれるアイテムを取得します	id	3
instagram_search	Instagram のアカウント、ハッシュタグ、場所を検索します	q	1
instagram_hashtag	Instagram のハッシュタグに付いた投稿を取得します	tag、cursor	1
instagram_place	Instagram の位置情報を取得します	id	3
instagram_place_posts	Instagram の位置情報でタグ付けされた投稿を取得します	id、cursor	1
instagram_audio	Instagram の音源と、それを使用しているリールを取得します	id	1
instagram_audio_search	Instagram の音楽やサウンドを検索します	q	3
instagram_reels_search	キーワードで Instagram リールを検索します	q、cursor	3
instagram_top_accounts	フォロワー数上位 2,000 アカウントの日次ランキング	sort、limit	0
instagram_usage	今月使用したクレジット数と残りのクレジット数を確認します	なし	0

全リファレンス：https://fastsocial.co/instagram-api/docs?ref=github

質問例

• 「@nasa と @spacex のエンゲージメント率を比較して。」
• 「このカルーセルのすべてのスライドをダウンロードして：https://www.instagram.com/p/...」
• 「@natgeo の現在のストーリーズを表示して、要約して。」
• 「@humansofny に似たアカウントを 10 件見つけて。」

ローカル版

クライアントがローカル（stdio）サーバーのみを実行する場合、同じツールを PyPI の instagram-data-mcp で利用できます。これはこのプラグインには含まれていません。ソースは FastSocialCo/instagram-data-mcp-python にあります。

リンク

• Instagram Data API：https://fastsocial.co/instagram-api?ref=github
• ドキュメント：https://fastsocial.co/instagram-api/docs?ref=github
• OpenAPI 仕様：https://fastsocial.co/instagram-api/openapi.json
• MCP Registry のエントリー：io.github.FastSocialCo/instagram-data-mcp

ライセンス

MIT。LICENSE を参照してください。