Instagram 服务核心 Raxytw/dsh-instagram-mcp

DSH Instagram FastMCP 核心服务插件（@luoyi-dsh/instagram-mcp）

DSH Instagram MCP Banner

DeepSeek Harness（DSH）的官方基础 Instagram FastMCP 服务插件。
负责管理 Python FastMCP 子进程生命周期，集中维护 Bot（username）与 Master（masterUsername）账号绑定，持久化 Instagram 会话凭据与 2FA 挑战，并为 DSH AI 模型和消费方插件提供标准 Model Context Protocol（MCP）工具。

[!CAUTION]
⚠️ 重要警告与免责声明
1. 违反 Instagram 服务条款与社区准则：本插件及底层 FastMCP 服务器通过非官方逆向 API（instagrapi）与 Instagram 交互，明确违反 Instagram / Meta 的使用条款与社区准则。
2. 切勿使用个人 / 主账号：绝不要使用你的个人账号、主账号或业务关键 Instagram 账号！ 运行自动化任务会带来严重风险，包括操作封锁、挑战检查点、临时锁定，以及永久封禁 / 停用账号。
3. 使用专用小号 / 备用账号与干净代理：只使用一次性测试账号，并搭配干净的住宅代理运行本服务。
4. 免责声明：本软件仅用于教育与研究目的。因使用本项目导致的任何账号封禁或限制，开发者不承担任何责任或义务。

🌟 核心特性

1. 集中账号绑定：
- 在 MCP 中配置一次 Bot Instagram 账号（username）与 Master Instagram 账号（masterUsername），消费方插件（@luoyi-dsh/instagram-plugin 和 @luoyi-dsh/instagram-scroll）自动继承。
2. 自动化 Python 环境与 FastMCP 生命周期：
- 自动检测 Python / uv，创建隔离的 .venv，管理 stdio FastMCP 子进程，支持优雅重连。
3. 多阶段模糊帖子与 Reel 搜索（ig_fuzzy_search_posts）：
- 组合 Instagram Top SERP（fbsearch/top_serp）、Reels SERP、创作者时间线和话题标签分区，即使话题标签页受限也能可靠检索帖子。
4. 完整帖子与 Reel 上下文提取（ig_get_post_context 与 ig_get_recent_mentions）：
- 提取完整文案、标题、无障碍视觉描述、Reel 音频元数据、视频字幕、图片 URL，以及嵌套评论回复（preview_child_comments）。
5. 多层反风控保护：
- 人性化随机抖动、读取微节奏、每小时写入上限，检测到速率限制或操作封锁时自动熔断冷却。

📦 安装

Via DSH Plugin CLI
dsh plugin --profile web add @luoyi-dsh/instagram-mcp

Or via npm
npm install @luoyi-dsh/instagram-mcp

📖 操作指南与工具参考

完整的 MCP 工具定义、自然语言提示词、HTTP REST API 路由、跨插件 SDK 示例和配置参数，请参阅 AGENTS.md。

📁 目录结构 text dsh-instagram-mcp/ ├── cordis.patch.yml # DSH bundle patch manifest ├── package.json # Module definitions and dependencies ├── tsconfig.json # TypeScript compiler configuration ├── AGENTS.md # Operational & Agent Tool Guide ├── CHANGELOG.md # Version release notes ├── README.md # English overview (This file) ├── README.zh-Hant.md # Traditional Chinese overview ├── client.js # DSH Web UI control panel ├── vendor/instagram-mcp/ # Standalone Python FastMCP server (server.py, auth.py, core.py) └── src/ # TypeScript service, MCP client wrapper, and tool registrations

📜 版本发布与许可

- 版本历史见 CHANGELOG.md。
- 采用 MIT License 许可。