Instagram Engagement MCP

🚀 Instagram Engagement MCP

An MCP server that offers features to analyze Instagram engagement metrics, extract demographic insights, and identify potential leads from Instagram posts and accounts.

🚀 Quick Start

This Instagram Engagement MCP is an MCP server that provides functions such as analyzing Instagram engagement metrics, extracting demographic insights, and identifying potential leads from Instagram posts and accounts.

✨ Features

• Analyze Post Comments: Extract sentiment, topics, and potential leads from post comments.
• Compare Accounts: Compare the engagement metrics of different Instagram accounts.
• Extract Demographics: Obtain demographic information from users who interact with posts or accounts.
• Identify Leads: Identify potential leads based on interaction patterns and criteria.
• Generate Engagement Reports: Create comprehensive reports with actionable insights.

📦 Installation

Install via Smithery

To automatically install the Instagram Engagement Analysis Claude Desktop version via Smithery:

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

Option 1: Install from npm

npm install -g instagram-engagement-mcp

Option 2: Clone from GitHub

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

💻 Usage Examples

Setup

1. Copy the .env.example file to .env and add your Instagram credentials:

cp .env.example .env

2. Edit the .env file and enter your Instagram username and password.

Build from Source

If you cloned the repository, execute the following command to build:

npm run build

Configuration

Add the server to your MCP settings file:

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

If you cloned the repository from GitHub instead of installing from npm, use:

{
  "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": []
    }
  }
}

Available Tools

analyze_post_comments

Analyze post comments to extract sentiment, topics, and potential leads. Parameters:

• postId (required): The ID of the post to analyze.
• commentCount (optional): The number of comments to analyze, default is 100.

compare_accounts

Compare the engagement metrics of different Instagram accounts. Parameters:

• accountId1 (required): The ID of the first account.
• accountId2 (required): The ID of the second account.
• metric (optional): The metric to compare, can be "following", "follower", or "postEngagement", default is "postEngagement".

extract_demographics

Extract demographic information from users who interact with a post or account. Parameters:

• accountId (required): The ID of the account to analyze.
• postId (optional): The ID of the post to analyze.
• limit (optional): The number of users to extract, default is 100.

identify_leads

Identify potential leads based on interaction patterns and criteria. Parameters:

• accountId (required): The ID of the account to analyze.
• engagementThreshold (optional): The engagement threshold, users exceeding this threshold are considered potential leads, default is 75%.
• interests (optional): A list of tags or topics of interest.

generate_engagement_report

Generate a comprehensive engagement report with actionable insights. Parameters:

• accountId (required): The ID of the account to analyze.
• startDate (optional): The start date of the report, default is the past week.
• endDate (optional): The end date of the report, default is the current date.
• format (optional): The output format, can be "pdf", "csv", or "json", default is "pdf".

📄 License

This project is licensed under the MIT License.

⚠️ Important Note

This project uses Instagram's private API, which may violate Instagram's terms of service. Please use it with caution.

💡 Usage Tip

Regularly update your API keys and credentials to ensure account security. If you have any questions or suggestions, please feel free to contact us.