AI导哈

Instagram管理协议服务器

一个专业的Instagram模型上下文协议服务器，提供全面的工具包用于管理账户、分析社交图谱、发现内容并与Instagram社区互动。

  • by arjun1194
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 arjun1194/insta-mcp

使用说明

Instagram MCP服务器

一个专业的模型上下文协议（MCP）服务器，为与Instagram的交互提供了一个全面的工具包。此服务器使LLM（如Claude或Gemini）能够直接从其界面管理帐户、分析社交图、发现内容并与Instagram社区互动。

🚀 特性

  • 完全帐户控制：编辑个人资料、管理隐私和跟踪活动。
  • 高级消息传递：读取历史记录，发送文本/媒体，并对消息做出反应。
  • 内容创作：支持照片、视频、卷轴和旋转木马/相册。
  • 深度洞察：分析帖子表现、关注者和参与度。
  • 社交图谱：智能比较工具，用于查找未关注者和粉丝。
  • 发现：按用户、标签或位置搜索。

📋 先决条件

  • Node.js：v18或更高版本。
  • Instagram帐户：标准帐户凭据。

🛠 安装

git clone https://github.com/your-repo/insta-mcp.git
cd insta-mcp
npm install
npm run build

⚙️ 配置

服务器支持通过环境变量或本地JSON文件进行灵活配置。

环境变量

变量 描述 默认值
INSTAGRAM_USERNAME 您的Instagram用户名 -
INSTAGRAM_PASSWORD 您的Instagram密码 -
INSTA_DATA_DIR 存储会话/凭据的路径 ./data

方法1： .env 文件（本地开发人员）

创建一个 .env 根：

INSTAGRAM_USERNAME=your_user
INSTAGRAM_PASSWORD=your_pass

方法2： credentials.json

复制示例并填写您的详细信息：

cp config/credentials.example.json data/credentials.json

🔧 工具编目

帐户和活动

  • get_account_overview：获取个人资料统计数据（关注者、关注者、个人简介）。
  • get_activity：查看通知（点赞、关注等）。
  • edit_profile：更新姓名、个人简介、网站和电子邮件。
  • block_user：阻止特定用户。
  • set_privacy：在私人和公共帐户之间切换。

社交图谱

  • get_followers：列出用户的关注者。
  • get_following：列出用户关注的对象。
  • compare_follow_lists：检测“取消关注者”或“粉丝”。
  • follow_user / unfollow_user：管理友谊。

媒体与互动

  • get_recent_posts：查看任何用户的最新帖子。
  • get_post_insights：详细的统计数据（点赞、评论、观众）。
  • upload_photo / upload_video / upload_reel：帖子内容。
  • upload_album：张贴包含多个项目的旋转木马。
  • search_locations：查找标记位置。
  • like_post / add_comment / reply_to_comment：与帖子互动。

直接消息（DM）

  • get_inbox：查看最近的消息线程。
  • get_direct_messages：获取特定线程的历史记录。
  • send_direct_message：向用户或组发送文本。
  • react_to_message：在消息中添加心脏反应。
  • get_pending_requests：管理DM请求。
  • mute_thread / leave_thread：线程管理。

订阅与发现

  • search_instagram：搜索用户、标签或地点。
  • get_timeline：你的主要家庭饲料。
  • get_discover：探索页面提要。
  • get_saved_posts：你的书签收藏。
  • get_liked_posts：你喜欢的历史。
  • get_tag_feed：标签的最新帖子。

故事

  • get_stories：查看托盘或用户中的活动故事。
  • get_highlights：访问用户故事亮点。

🖥 与MCP客户端一起使用

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "instagram": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/insta-mcp/dist/index.js"],
      "env": {
        "INSTAGRAM_USERNAME": "your_username",
        "INSTAGRAM_PASSWORD": "your_password"
      }
    }
  }
}

发展

要在自动重新加载的开发模式下运行：

npm run format # Format code
npm run dev    # Build and start

⚠️ 安全与道德

该项目使用 instagram-private-api.

  • 速率限制：服务器包括内置节流功能。避免激进的自动请求。
  • 合规：遵守Instagram的服务条款。仅用于个人分析和合法的社交管理。

📄 许可证

麻省理工学院

相关 MCP