MCP Instagram

🚀 Insta MCP Server

Instagramと統合するためのMCP (Model Context Protocol) サーバーです。このサーバーを使用することで、Instagramのユーザープロファイルや投稿情報を取得したり、エンゲージメントアクションを実行したりできます。

✨ 主な機能

• 包括的なアクセス：ユーザープロファイル、タイムライン、ストーリー、投稿の詳細情報を閲覧できます。
• スマートなエンゲージメント：MCPクライアントから直接、投稿やコメントにいいねをしたり、ユーザーをフォローしたりできます。
• 検索と発見：強力な検索機能でアカウントを見つけ、コンテンツを探索できます。
• 安全な認証：二段階認証 (2FA) をサポートする堅牢なログイン処理があります。
• 開発者向け：Claude Desktop、CursorなどのMCP互換ツールとシームレスに統合できます。

📦 インストール

このMCPサーバーは、Claude DesktopやCursor IDEなどのMCP互換クライアントで使用できます。以下の手順に従って、クライアントでサーバーを設定してください。

前提条件

• Node.js 18+ または 20+ がインストールされていること
• Instagramアカウントの資格情報 (IG_USERNAME と IG_PASSWORD)

Claude Desktopの場合

1. Claude Desktopの設定ファイルを見つける
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
2. 設定ファイルを開く（存在しない場合は作成する） し、mcpServers セクションに以下を追加します。

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

3. 資格情報を置き換える
   • your_instagram_username をあなたのInstagramユーザー名に置き換えます。
   • your_instagram_password をあなたのInstagramパスワードに置き換えます。
4. Claude Desktopを再起動する 変更を有効にするために、Claude Desktopを再起動します。利用可能なツールのリストにInstagram MCPサーバーが表示されるはずです。

Cursor IDEの場合

1. CursorのMCP設定ファイルを見つける
   • ワークスペース設定：.cursor/mcp.json（プロジェクトルートにあります）
   • グローバル設定：~/.cursor/mcp.json
2. 設定ファイルを開く（存在しない場合は作成する） し、mcpServers セクションに以下を追加します。

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

3. 資格情報を置き換える
   • your_instagram_username をあなたのInstagramユーザー名に置き換えます。
   • your_instagram_password をあなたのInstagramパスワードに置き換えます。
4. Cursorを再起動する 変更を有効にするために、Cursorを再起動します。

代替方法：ローカルインストールを使用する場合

リポジトリをローカルにクローンした場合は、絶対パスを使用することができます。

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "/absolute/path/to/mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

注意：/absolute/path/to/mcp-instagram を、クローンしたリポジトリの実際の絶対パスに置き換えてください。

セキュリティに関する注意事項

• 資格情報をバージョン管理にコミットしないでください
• MCP設定の env セクションを使用して資格情報を提供することをおすすめします。
• 資格情報はLLMからは要求されません。環境変数を介して提供する必要があります。
• Instagramアカウントで2FAを有効にしている場合は、初回ログイン後に instagram_complete_2fa ツールを使用して2FAフローを完了する必要があります。

インストールの検証

MCPクライアントを再起動した後、利用可能なサーバーのリストにInstagram MCPサーバーが表示されるはずです。AIアシスタントに以下のようなInstagramツールを使用するように依頼することで、正常に動作していることを確認できます。

認証

• instagram_login - Instagramアカウントにログインする
• instagram_complete_2fa - 二段階認証を完了する
• instagram_logout - Instagramからログアウトする

プロファイルとコンテンツの閲覧

• instagram_search_accounts - Instagramアカウントを検索する
• instagram_get_user_profile - IDまたはユーザー名でユーザープロファイル情報を取得する
• instagram_get_current_user_profile - 認証されたユーザー自身のプロファイルを取得する
• instagram_get_user_posts - ユーザーの投稿のページ付きフィードを取得する
• instagram_get_post_details - 特定の投稿の詳細情報を取得する
• instagram_get_user_stories - ユーザーのアクティブなストーリーを取得する
• instagram_get_timeline_feed - ホームフィード（フォローしているアカウントの投稿）を取得する

エンゲージメントアクション

• instagram_like_post - 投稿またはリールにいいねをする
• instagram_like_comment - コメントにいいねをする
• instagram_comment_on_post - 投稿にコメントを追加するか、コメントに返信する
• instagram_get_post_comments - 投稿のコメントを取得する

ソーシャルアクション

• instagram_follow_user - Instagramユーザーをフォローする

⚠️ 法的免責事項とリスク

重要：使用前に必ず読んでください

このソフトウェアは非公式のInstagram APIアクセス方法を利用しており、Meta Platforms, Inc. (Instagram) と関連している、承認されている、またはサポートされているものではありません。このMCPサーバーを使用することで、あなたは以下のことを承認し同意するものとみなされます。

リスクと制限事項

1. アカウント制限：このソフトウェアを使用すると、あなたのInstagramアカウントが疑わしいまたは自動化されたアクティビティとしてフラグが立てられる可能性があります。Instagramは警告を発行したり、アカウントの機能を一時的に制限したり、アカウントを永久に停止または削除することがあります。
2. 保証なし：このソフトウェアの機能は保証されておらず、Instagramのプラットフォーム、セキュリティ対策、またはポリシーの変更により、いつでも機能しなくなる可能性があります。

責任の制限

このソフトウェアの作者および貢献者は、明示または黙示を問わず、いかなる保証も提供しません。いかなる場合も、作者は、契約、不法行為、またはその他の理由による、ソフトウェアまたはソフトウェアの使用に起因する、または関連するいかなる請求、損害、またはその他の責任について責任を負いません。これには、以下のものが含まれますが、これらに限定されません。

• Instagramアカウントの停止、制限、または削除
• データ、コンテンツ、またはInstagramサービスへのアクセスの喪失
• 直接的、間接的、偶発的、特別な、結果的、または懲罰的な損害

このソフトウェアを使用することで、あなたはその使用により生じる可能性のあるすべての結果に対して完全な責任を負うことを受け入れます。自己責任で使用してください。

推奨事項

• メインのアカウントではなく、サブまたはテスト用のInstagramアカウントを使用してください。
• アカウントの警告や異常なアクティビティを監視してください。
• 検出のリスクを最小限に抑えるために、適切なレート制限と使用パターンを実装してください。
• Instagramの利用規約を定期的に確認し、すべての適用される法律や規制に準拠してください。

要約すると：常識的なことですが、1時間に10,000件の投稿にいいねをしたり、地球上のすべての人をフォローしたりしないでください。Instagramは人間を装うロボットを好きではありません。落ち着いて、やり過ぎなければ、多分大丈夫でしょう。多分。