Instagram Engagement MCP
This server provides tools for analyzing Instagram engagement metrics, extracting insights, and identifying opportunities:
Analyze Post Comments: Extract sentiment, themes, and potential leads from comments
Compare Accounts: Evaluate engagement metrics across different Instagram profiles
Extract Demographics: Gather demographic insights from users engaged with content
Identify Leads: Find potential leads based on engagement patterns and user activity
Generate Reports: Create comprehensive engagement reports with optional date ranges
Uses .env files for configuration of Instagram credentials and other environment variables.
Allows cloning the repository from GitHub as an installation option.
Provides tools for analyzing Instagram engagement metrics, extracting demographic insights from users and comments, comparing accounts, identifying potential leads based on engagement patterns, and generating comprehensive engagement reports for posts and accounts.
Supports installation and distribution through the npm package registry.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Instagram Engagement MCP analyze comments on https://instagram.com/p/ABC123XYZ for potential leads"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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
Related MCP server: Instagram MCP Server
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 claudeOption 1: Install from npm
npm install -g instagram-engagement-mcpOption 2: Clone from GitHub
git clone https://github.com/Bob-lance/instagram-engagement-mcp.git
cd instagram-engagement-mcp
npm installSetup
Copy the
.env.examplefile to.envand add your Instagram credentials:cp .env.example .envEdit the
.envfile with your Instagram username and password
Building from Source
If you cloned the repository, build the project:
npm run buildConfiguration
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 analyzemaxComments(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 comparemetrics(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 analyzesampleSize(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 analyzecriteria(optional): Criteria for identifying leads
generate_engagement_report
Generate a comprehensive engagement report for an Instagram account.
Parameters:
account(required): Instagram account handlestartDate(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
Available Tools
5 toolsanalyze_post_commentsC
Analyze comments on an Instagram post to identify sentiment, themes, and potential leads
Inputs: postUrl (required), maxComments.
compare_accountsC
Compare engagement metrics across different Instagram accounts
Inputs: accounts (required), metrics.
extract_demographicsC
Extract demographic insights from users engaged with a post or account
Inputs: accountOrPostUrl (required), sampleSize.
generate_engagement_reportC
Generate a comprehensive engagement report for an Instagram account
Inputs: account (required), startDate, endDate.
identify_leadsC
Identify potential leads based on engagement patterns
Inputs: accountOrPostUrl (required), criteria.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: analyzing comments, comparing accounts, extracting demographics, generating reports, and identifying leads. The descriptions specify unique actions and targets, making it easy for an agent to select the right tool without confusion.
All tool names follow a consistent verb_noun pattern (e.g., analyze_post_comments, compare_accounts, extract_demographics). The naming is uniform, using snake_case throughout, which enhances readability and predictability for agents.
With 5 tools, the server is well-scoped for Instagram engagement analysis. Each tool earns its place by covering distinct aspects of the domain, avoiding bloat or thinness, making it manageable and effective for the intended purpose.
The tool set covers key engagement analysis functions like sentiment analysis, comparison, demographics, reporting, and lead identification. A minor gap exists in direct engagement actions (e.g., posting or interacting), but the surface is largely complete for analytical workflows.
Related MCP Connectors
Instagram & TikTok data tools: demographic user search, analytics, posts, comments, hashtags.
Sort Instagram by views, likes and outliers. Export to Google Sheets, Excel, CSV and JSON.
Get social media data from Instagram and TikTok: profiles, posts, videos, comments, and more.
Read-only public Instagram data: profiles, posts, reels, stories, comments, top-accounts ranking.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Instagram engagement analysis using the unofficial Instagram Private API, including comment sentiment analysis, account comparison, demographic extraction, lead identification, and engagement reporting.44 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Instagram through a comprehensive toolkit for account management, content creation, messaging, social graph analysis, and content discovery.13-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Instagram Business accounts by automating content publishing, scheduling posts, and analyzing performance metrics. Supports posts, stories, reels, and carousels with detailed audience insights and hashtag discovery.1-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access Instagram Business account analytics and insights, including follower demographics, post performance, and audience reach.-