insta-mcp 是一个专业的 Model Context Protocol (MCP) 服务器，为大型语言模型（如 Claude 或 Gemini）提供全面的 Instagram 交互工具，使其能够直接在界面中管理账户、分析社交图谱、发现内容并与 Instagram 社区互动。
用途
该服务器旨在让 AI 助手通过标准化的 MCP 协议调用 Instagram 的各种功能，实现账户管理、数据分析、内容发布和社交互动等操作，适合个人分析、社交管理和内容发现场景。
主要能力
- 完整账户控制：编辑个人资料、管理隐私设置、追踪活动。
- 高级消息功能：读取消息历史、发送文本/媒体、对消息做出反应。
- 内容创作：支持照片、视频、Reels 和轮播/相册发布。
- 深度洞察：分析帖子表现、粉丝和互动情况。
- 社交图谱：提供智能比较工具，发现取消关注者和粉丝。
- 发现功能：按用户、话题标签或地点搜索。
工具目录
账户与活动：
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：访问用户的故事精选。
使用方式
先决条件
- Node.js：v18 或更高版本。
- Instagram 账户：标准账户凭据。
配置
服务器支持通过环境变量或本地 JSON 文件进行灵活配置。
方法 1：.env 文件（本地开发）
在根目录创建 .env 文件。
方法 2：credentials.json 复制示例并填写你的详细信息。
与 MCP 客户端使用
将以下内容添加到你的 claude_desktop_config.json 中。
要以开发模式运行并自动重载：
适用场景
适合需要通过 AI 助手自动化管理 Instagram 账户、分析社交数据、发布内容或与社区互动的个人用户或社交媒体管理者。
限制
- 该项目使用
instagram-private-api。 - 内置限流机制，避免激进的自动化请求。
- 需遵守 Instagram 服务条款，仅用于个人分析和合法的社交管理。
