Instagram Engagement

🚀 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 is an MCP server that provides functions to analyze Instagram engagement metrics, extract demographic insights, and identify 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 Demographic Data: Obtain demographic insights from users interacting with posts or accounts.
• Identify Potential 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 Instagram engagement analysis 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

🛠️ Setup

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

cp .env.example .env

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

🏗️ Build from Source

If you cloned the repository, build the project:

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 from the repository 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": []
    }
  }
}

💻 Usage Examples

analyze_post_comments

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

• postUrl (Required): The URL of the Instagram post to analyze.
• maxComments (Optional): The maximum number of comments to analyze (Default: 100).

compare_accounts

Compare the engagement metrics of different Instagram accounts. Parameters:

• accounts (Required): A list of Instagram account handles to compare.
• metrics (Optional): The metrics to compare (Default: All).

extract_demographics

Extract demographic data from users interacting with a post or account. Parameters:

• postUrl (Required): The URL of the Instagram post to analyze.
• maxComments (Optional): The maximum number of comments to analyze (Default: 100).

identify_leads

Identify potential leads. Parameters:

• accounts (Required): A list of Instagram account handles to compare.
• metrics (Optional): The metrics to compare (Default: All).

generate_report

Generate an engagement report. Parameters:

• None

⚠️ Important Note

• Please ensure that all dependencies are installed.
• Keep your API keys secure.
• Comply with Instagram's terms of use.