Instagram Engagement分析MCP服务器

项目简介

本项目是一个MCP服务器，旨在为大型语言模型（LLM）客户端提供分析Instagram平台用户互动数据的能力。通过此服务器，LLM可以调用各种工具来分析Instagram帖子和账号的互动情况，提取有价值的商业洞察，例如用户情感分析、受众画像、潜在客户识别以及生成详细的互动报告。

主要功能点

评论分析: 分析Instagram帖子下的评论，提取用户情感、主题和潜在客户线索。
账号对比: 对比不同Instagram账号的互动指标，例如粉丝数量、互动率等。
用户画像: 从参与帖子或账号互动的用户中提取人口统计学特征和兴趣偏好。
潜在客户挖掘: 基于用户互动模式和预设条件，识别潜在的客户线索。
互动报告生成: 生成全面的Instagram账号互动报告，包含可执行的洞察分析。

安装步骤

方法一：通过 npm 全局安装 (推荐)

npm install -g instagram-engagement-mcp

方法二：从 GitHub 克隆安装

git clone https://github.com/Bob-lance/instagram-engagement-mcp.git
cd instagram-engagement-mcp
npm install
npm run build

服务器配置

要将此MCP服务器添加到您的MCP客户端，您需要在客户端的MCP服务器配置文件中添加以下配置信息。请注意，您需要替换 'INSTAGRAM_USERNAME' 和 'INSTAGRAM_PASSWORD' 为您自己的Instagram账号信息。

如果使用 npm 全局安装，配置如下：

{
  "mcpServers": {
    "instagram-engagement": {
      "command": "npx",
      "args": ["instagram-engagement-mcp"],
      "env": {
        "INSTAGRAM_USERNAME": "your_instagram_username", // 替换为您的Instagram用户名
        "INSTAGRAM_PASSWORD": "your_instagram_password"  // 替换为您的Instagram密码
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

如果使用 GitHub 克隆安装，配置如下 (请替换 '/path/to/instagram-engagement-mcp' 为您的实际仓库路径):

{
  "mcpServers": {
    "instagram-engagement": {
      "command": "node",
      "args": ["/path/to/instagram-engagement-mcp/build/index.js"], // 替换为您的仓库路径
      "env": {
        "INSTAGRAM_USERNAME": "your_instagram_username", // 替换为您的Instagram用户名
        "INSTAGRAM_PASSWORD": "your_instagram_password"  // 替换为您的Instagram密码
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明:

'server name': 'instagram-engagement' (服务器名称，客户端用此名称引用)
'command': 服务器启动命令。'npx' 用于执行全局安装的 npm 包，'node' 用于执行本地 Node.js 脚本。
'args': 启动命令的参数。对于 npm 安装，直接使用包名 'instagram-engagement-mcp'；对于本地安装，指向构建后的 'index.js' 文件路径。
'env': 环境变量配置。
- 'INSTAGRAM_USERNAME': 您的Instagram用户名。
- 'INSTAGRAM_PASSWORD': 您的Instagram密码。
'disabled': 'false' 表示服务器启用。
'autoApprove': '[]' 表示不自动批准任何工具调用 (可以根据需要配置自动批准的工具)。

基本使用方法

配置完成后，您的LLM客户端应该能够检测到名为 'instagram-engagement' 的MCP服务器。您可以通过客户端调用以下工具来分析Instagram数据：

analyze_post_comments: 分析帖子评论
- 参数: 'postUrl' (帖子URL), 'maxComments' (最大评论数，可选)
compare_accounts: 对比账号互动数据
- 参数: 'accounts' (账号名称列表), 'metrics' (对比指标列表，可选)
extract_demographics: 提取用户画像
- 参数: 'accountOrPostUrl' (账号名称或帖子URL), 'sampleSize' (样本数量，可选)
identify_leads: 挖掘潜在客户
- 参数: 'accountOrPostUrl' (账号名称或帖子URL), 'criteria' (筛选条件，可选)
generate_engagement_report: 生成互动报告
- 参数: 'account' (账号名称), 'startDate' (报告开始日期，可选), 'endDate' (报告结束日期，可选)

请参考仓库README或源代码 'src/index.ts' 中 'setupToolHandlers' 方法部分，获取每个工具的详细参数和使用说明。

重要提示:

本服务器使用非官方的 Instagram Private API，使用风险自负。
请负责任地使用，并遵守 Instagram 的服务条款。
注意API调用频率限制，避免被 Instagram 封禁。

关键词