README.md•4.29 kB
# Instagram Engagement MCP
[](https://www.npmjs.com/package/instagram-engagement-mcp)
[](https://opensource.org/licenses/MIT)
[](https://smithery.ai/server/@Bob-lance/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
## Installation
### Installing via Smithery
To install Instagram Engagement Analysis for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Bob-lance/instagram-engagement-mcp):
```bash
npx -y @smithery/cli install @Bob-lance/instagram-engagement-mcp --client claude
```
### Option 1: Install from npm
```bash
npm install -g instagram-engagement-mcp
```
### Option 2: Clone from GitHub
```bash
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:
```bash
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:
```bash
npm run build
```
## Configuration
Add the server to your MCP settings file:
```json
{
"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:
```json
{
"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