Instagram Engagement MCP

🚀 InstagramインタラクションMCP

このプロジェクトはMCPサーバーで、Instagramのインタラクション指標を分析し、人口統計情報の洞察を抽出し、Instagramの投稿やアカウントから潜在顧客を特定する機能を提供します。

🚀 クイックスタート

InstagramインタラクションMCPを使えば、Instagramの投稿やアカウントのデータを分析し、潜在顧客を特定することができます。以下のセクションでは、インストール方法や使用方法を詳しく説明します。

✨ 主な機能

• 投稿コメントの分析：投稿のコメントから感情、テーマ、潜在顧客を抽出します。
• アカウントの比較：異なるInstagramアカウントのインタラクション指標を比較します。
• 人口統計データの抽出：投稿やアカウントとインタラクションしたユーザーから人口統計情報を取得します。
• 潜在顧客の特定：インタラクションパターンと基準に基づいて潜在顧客を特定します。
• インタラクションレポートの生成：実行可能な洞察を含む包括的なレポートを作成します。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてInstagramインタラクション分析Claudeデスクトップ版を自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @Bob-lance/instagram-engagement-mcp --client claude

オプション1：npmからインストール

npm install -g instagram-engagement-mcp

オプション2：GitHubからクローン

git clone https://github.com/Bob-lance/instagram-engagement-mcp.git
cd instagram-engagement-mcp
npm install

設定

1. .env.exampleファイルを.envにコピーし、Instagramの認証情報を追加します。

   cp .env.example .env
   

2. .envファイルを編集し、Instagramのユーザー名とパスワードを入力します。

ソースコードからのビルド

リポジトリをクローンした場合は、以下のコマンドを実行してビルドします。

npm run build

設定

サーバーをMCP設定ファイルに追加します。

npmからインストールした場合

{
  "mcpServers": {
    "instagram-engagement": {
      "command": "npx",
      "args": ["instagram-engagement-mcp"],
      "env": {
        "INSTAGRAM_USERNAME": "your_instagram_username",
        "INSTAGRAM_PASSWORD": "your_instagram_password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

GitHubからクローンした場合

{
  "mcpServers": {
    "instagram-engagement": {
      "command": "node",
      "args": ["/path/to/instagram-engagement-mcp/build/index.js"],
      "env": {
        "INSTAGRAM_USERNAME": "your_instagram_username",
        "INSTAGRAM_PASSWORD": "your_instagram_password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 使用例

基本的な使用法

以下は、各ツールの基本的な使用方法の例です。

analyze_post_comments

投稿のコメントを分析し、感情、テーマ、潜在顧客を抽出します。

# 必須パラメータ: postId
# オプションパラメータ: commentCount (デフォルト: 100)
npx instagram-engagement-mcp analyze_post_comments --postId 123456789 --commentCount 200

compare_accounts

異なるInstagramアカウントのインタラクション指標を比較します。

# 必須パラメータ: accountId1, accountId2
# オプションパラメータ: metric (デフォルト: postEngagement)
npx instagram-engagement-mcp compare_accounts --accountId1 12345 --accountId2 67890 --metric following

extract_demographics

投稿やアカウントとインタラクションしたユーザーから人口統計情報を抽出します。

# 必須パラメータ: accountId
# オプションパラメータ: postId, limit (デフォルト: 100)
npx instagram-engagement-mcp extract_demographics --accountId 12345 --postId 67890 --limit 150

identify_leads

インタラクションパターンと基準に基づいて潜在顧客を特定します。

# 必須パラメータ: accountId
# オプションパラメータ: engagementThreshold (デフォルト: 75%), interests
npx instagram-engagement-mcp identify_leads --accountId 12345 --engagementThreshold 80% --interests "fashion,travel"

generate_engagement_report

実行可能な洞察を含む包括的なインタラクションレポートを生成します。

# 必須パラメータ: accountId
# オプションパラメータ: startDate, endDate, format (デフォルト: pdf)
npx instagram-engagement-mcp generate_engagement_report --accountId 12345 --startDate 2024-01-01 --endDate 2024-01-31 --format csv

📚 ドキュメント

利用可能なツール

analyze_post_comments

投稿のコメントを分析し、感情、テーマ、潜在顧客を抽出します。 パラメータ:

• postId（必須）：分析する投稿のID
• commentCount（オプション）：分析するコメントの数、デフォルトは100

compare_accounts

異なるInstagramアカウントのインタラクション指標を比較します。 パラメータ:

• accountId1（必須）：最初のアカウントのID
• accountId2（必須）：2番目のアカウントのID
• metric（オプション）：比較する指標、"following"、"follower"、または"postEngagement"が指定可能、デフォルトは"postEngagement"

extract_demographics

投稿やアカウントとインタラクションしたユーザーから人口統計情報を抽出します。 パラメータ:

• accountId（必須）：分析するアカウントのID
• postId（オプション）：分析する投稿のID
• limit（オプション）：抽出するユーザーの数、デフォルトは100

identify_leads

インタラクションパターンと基準に基づいて潜在顧客を特定します。 パラメータ:

• accountId（必須）：分析するアカウントのID
• engagementThreshold（オプション）：インタラクションの閾値、この閾値を超えるユーザーが潜在顧客と見なされます、デフォルトは75%
• interests（オプション）：興味のあるタグまたはテーマのリスト

generate_engagement_report

実行可能な洞察を含む包括的なインタラクションレポートを生成します。 パラメータ:

• accountId（必須）：分析するアカウントのID
• startDate（オプション）：レポートの開始日、デフォルトは過去1週間
• endDate（オプション）：レポートの終了日、デフォルトは現在の日付
• format（オプション）：出力形式、"pdf"、"csv"、または"json"が指定可能、デフォルトは"pdf"

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はこちらを参照してください。

注意事項

⚠️ 重要提示

このプロジェクトはInstagramの非公開APIを使用しているため、Instagramのサービス利用規約に違反する可能性があります。ご利用には十分に注意してください。

💡 使用建议

APIキーと認証情報を定期的に更新し、アカウントのセキュリティを確保してください。何か問題や提案があれば、いつでもお問い合わせください。