Instagram Engagement

by bob-lance

3 stars

140 downloads

Not rated

GitHub

About

Enables detailed Instagram interaction analysis by processing comments, user profiles, and post metrics to extract demographic insights and identify potential marketing leads through a private API integration.

Details

Author: bob-lance
Repository: Bob-lance/instagram-engagement-mcp
GitHub stars: 3
Downloads: 140
License: MIT License
Categories: Developer Tools, Design, File Management, AI, Community, Media, Frontend, Infrastructure, Other
Tags: #visualization, #analytics

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Instagram Engagement

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 instagram-engagement-mcp
Environment
- INSTAGRAM_PASSWORD your_instagram_password
- INSTAGRAM_USERNAME your_instagram_username
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "instagram engagement": {
            "env": {
                "INSTAGRAM_PASSWORD": "your_instagram_password",
                "INSTAGRAM_USERNAME": "your_instagram_username"
            },
            "args": [
                "/c",
                "npx",
                "instagram-engagement-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

{
    "mcpServers": {
        "instagram engagement": {
            "env": {
                "INSTAGRAM_PASSWORD": "your_instagram_password",
                "INSTAGRAM_USERNAME": "your_instagram_username"
            },
            "args": [
                "/c",
                "npx",
                "instagram-engagement-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "instagram engagement": {
            "env": {
                "INSTAGRAM_PASSWORD": "your_instagram_password",
                "INSTAGRAM_USERNAME": "your_instagram_username"
            },
            "args": [
                "/c",
                "npx",
                "instagram-engagement-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

{
    "mcpServers": {
        "instagram engagement": {
            "env": {
                "INSTAGRAM_PASSWORD": "your_instagram_password",
                "INSTAGRAM_USERNAME": "your_instagram_username"
            },
            "args": [
                "/c",
                "npx",
                "instagram-engagement-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "instagram engagement": {
            "env": {
                "INSTAGRAM_PASSWORD": "your_instagram_password",
                "INSTAGRAM_USERNAME": "your_instagram_username"
            },
            "args": [
                "/c",
                "npx",
                "instagram-engagement-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

From the repository

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

To install Instagram Engagement Analysis for Claude Desktop automatically via Smithery:

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

npm install -g instagram-engagement-mcp

`analyze_post_comments`

Analyze comments on an Instagram post to identify sentiment, themes, and potential leads. Parameters: postUrl (required), maxComments (optional)

`compare_accounts`

Compare engagement metrics across different Instagram accounts. Parameters: accounts (required), metrics (optional)

`extract_demographics`

Extract demographic insights from users engaged with a post or account. Parameters: accountOrPostUrl (required), sampleSize (optional)

`identify_leads`

Identify potential leads based on engagement patterns. Parameters: accountOrPostUrl (required), criteria (optional)

`generate_engagement_report`

Generate a comprehensive engagement report for an Instagram account. Parameters: account (required), startDate (optional), endDate (optional)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

{
    "env": {
        "INSTAGRAM_PASSWORD": "your_instagram_password",
        "INSTAGRAM_USERNAME": "your_instagram_username"
    },
    "args": [
        "/c",
        "npx",
        "instagram-engagement-mcp"
    ],
    "command": "cmd"
}

Instagram Engagement MCP

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

Features

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

analyze_post_comments

compare_accounts

extract_demographics

identify_leads

generate_engagement_report

Claude Desktop / Cursor

Linux

Macos

Windows

Instagram Engagement MCP

Features

Installation

Installing via Smithery

Option 1: Install from npm

Option 2: Clone from GitHub

Setup

Building from Source

Configuration

Available Tools

analyze_post_comments

compare_accounts

extract_demographics

identify_leads

generate_engagement_report

Notes

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`analyze_post_comments`

`compare_accounts`

`extract_demographics`

`identify_leads`

`generate_engagement_report`