mcpField
I
Instagram Engagement MCP

Instagram Engagement MCP

Local
github.com/Bob-lanceSocial Media46Updated 79w ago
Repository

About Instagram Engagement MCP

Instagram Engagement MCP is an MCP server that offers tools for analyzing Instagram engagement, extracting audience demographics, and finding potential leads from posts and accounts. It is aimed at marketing and social media teams who need to measure audience response.

Key features

  1. 01Analyze post comments for sentiment and themes
  2. 02Compare engagement metrics across accounts
  3. 03Extract demographic insights from engaged users
  4. 04Identify leads from engagement patterns
  5. 05Generate account engagement reports with date ranges

Use cases

  1. 01Reviewing audience feedback on a specific post
  2. 02Comparing engagement across several accounts
  3. 03Finding potential leads from post interactions

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "instagram-engagement": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Instagram Engagement MCP

npm version License: MIT smithery badge

An MCP server that provides tools for analyzing Instagram engagement metrics, extracting demographic insights, and identifying potential leads from Instagram posts and accounts.

Features

  • Analyze Post Comments: Extract sentiment, themes, and potential leads from comments on Instagram posts
  • Compare Accounts: Compare engagement metrics across different Instagram accounts
  • Extract Demographics: Get demographic insights from users engaged with a post or account
  • Identify Leads: Find potential leads based on engagement patterns and criteria
  • Generate Engagement Reports: Create comprehensive reports with actionable insights

Installation

Installing via Smithery

To install Instagram Engagement Analysis for Claude Desktop automatically 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 with your Instagram username and password

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

Available Tools

analyze_post_comments

Analyze comments on an Instagram post to identify sentiment, themes, and potential leads.

Parameters:

  • postUrl (required): URL of the Instagram post to analyze
  • maxComments (optional): Maximum number of comments to analyze (default: 100)
compare_accounts

Compare engagement metrics across different Instagram accounts.

Parameters:

  • accounts (required): List of Instagram account handles to compare
  • metrics (optional): Metrics to compare (default: all)
extract_demographics

Extract demographic insights from users engaged with a post or account.

Parameters:

  • accountOrPostUrl (required): Instagram account handle or post URL to analyze
  • sampleSize (optional): Number of users to sample for demographic analysis (default: 50)
identify_leads

Identify potential leads based on engagement patterns.

Parameters:

  • accountOrPostUrl (required): Instagram account handle or post URL to analyze
  • criteria (optional): Criteria for identifying leads
generate_engagement_report

Generate a comprehensive engagement report for an Instagram account.

Parameters:

  • account (required): Instagram account handle
  • startDate (optional): Start date for the report (YYYY-MM-DD)
  • endDate (optional): End date for the report (YYYY-MM-DD)

Notes

  • This server uses the Instagram Private API, which is not officially supported by Instagram
  • Use responsibly and in accordance with Instagram's terms of service
  • Be aware of rate limits to avoid being blocked by Instagram

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.