ICY_MCP
ICY_MCP is a toolkit for analyzing Instagram engagement using the Instagram Private API (unofficial). It provides a set of tools for post comment analysis, account engagement comparison, demographic extraction, lead identification, and engagement reporting.
Note:
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.
Features
- analyze_post_comments: Analyze sentiment, themes, and potential leads from Instagram post comments.
- compare_accounts: Compare engagement metrics across multiple Instagram accounts.
- extract_demographics: Extract demographic insights from engaged users based on posts or accounts.
- identify_leads: Find potential leads by analyzing engagement patterns.
- generate_engagement_report: Generate comprehensive engagement reports for Instagram accounts over a specified date range.
Usage
Each tool is accessed via its respective API endpoint or CLI command. Example usage and parameters are as follows:
1. Analyze Post Comments
analyze_post_comments(postUrl, maxComments=100)
postUrl: URL of the Instagram post to analyze (required)maxComments: Maximum number of comments to analyze (optional, default 100)
2. Compare Accounts
compare_accounts(accounts, metrics='all')
accounts: List of Instagram account handles to compare (required)metrics: Metrics to compare (optional, default 'all')
3. Extract Demographics
extract_demographics(accountOrPostUrl, sampleSize=50)
accountOrPostUrl: Instagram account handle or post URL (required)sampleSize: Number of users to sample for demographic analysis (optional, default 50)
4. Identify Leads
identify_leads(accountOrPostUrl, criteria)
accountOrPostUrl: Instagram account handle or post URL (required)criteria: Criteria for identifying leads (optional)
5. Generate Engagement Report
generate_engagement_report(account, startDate, endDate)
account: Instagram account handle (required)startDate: Start date for the report (YYYY-MM-DD, optional)endDate: End date for the report (YYYY-MM-DD, optional)
Installation
Note:
This project requires Python 3.x and may need additional dependencies for interacting with the Instagram Private API.
git clone https://github.com/GeekyRiolu/ICY_MCP.git
cd ICY_MCP
# Install dependencies
pip install -r requirements.txt
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
License
This project is licensed under the MIT License.
Disclaimer
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.