Instagram 商务助手 Raxytw/dsh-instagram-plugin

DSH Instagram 商务与自动化职责插件（@luoyi-dsh/instagram-plugin）

DSH Instagram Plugin Banner

依赖 @luoyi-dsh/instagram-mcp 提供 FastMCP 连接和集中管理的账号凭据（username 与 masterUsername）。
本插件提供两项核心操作能力：
1. 安全的只读浏览与探索：浏览创作者帖子、Reels 短视频、探索时间线信息流，搜索用户和标签，全程不点赞、不发帖，不触发账号风险。
2. AI 驱动的社交职责：后台模糊话题巡查并给出智能推荐评论；对 Posts 和 Reels 做有依据的 @mention（RM）多模态推理；由 DSH Platform Subscriptions（dsh-plugin-subscriptions）或自定义 LLM API 驱动的 AI 私信（DM）回复。

[!CAUTION]
⚠️ 重要警告与免责声明
1. 违反 Instagram 服务条款与社区准则：本插件通过非官方逆向工程 API 与 Instagram 交互，明确违反 Instagram / Meta 的使用条款与社区准则。
2. 不要使用你的个人 / 主账号：绝不要使用你的个人账号、主账号或业务关键账号！ 运行自动化脚本有极高风险触发操作封锁、验证检查点、临时锁定，乃至永久封禁 / 封号。
3. 免责声明：本项目严格仅供教育与技术研究使用。使用风险完全由你自行承担！

🌟 核心特性

1. 零配置账号继承：
- 自动从 @luoyi-dsh/instagram-mcp 继承 Bot 账号（username）和主账号（masterUsername）。
2. 外部订阅配额与多层级 LLM 引擎：
- 从 dsh-plugin-subscriptions 读取授权配额（Google Antigravity、OpenAI Codex、xAI Grok、GitHub Copilot），支持自定义 OpenAI / DeepSeek API，遇到 HTTP 402 自动故障转移。
3. 有依据的 Post 与 Reel 提及回复（RM）：
- 回复 @mentions 之前，先读取完整的 Post 或 Reel 上下文（文案、标题、无障碍视觉描述、Reel 音频元数据、视频字幕、多模态图像检查、父级评论）——绝不臆造，也不用套话回复。
4. 严格的防 AIGC 过滤：
- 搜索和巡查时自动过滤 AI 生成的视频、动画、画作，以及内容农场文章。
5. 安全的只读浏览与多层级防风险保障：
- 强制限制单次运行上限、每小时 / 每日配额，加入拟人化抖动，并自动触发 30 分钟熔断冷却。

🚀 安装

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

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

📖 操作指南与工具参考

完整 DSH 工具定义、只读浏览与自动化 REST API、LLM 配置、用法示例，请参阅 AGENTS.md。

📁 目录结构

dsh-instagram-plugin/
├── client.js # Web UI dashboard
├── cordis.patch.yml # DSH Cordis bundle patch
├── package.json # Module definitions
├── 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
└── src/ # TypeScript source code (LLM engine, patrol, mentionReply, dmReply, tools)

📜 版本发布与许可

- 版本发布说明见 CHANGELOG.md。
- 本项目采用 MIT License 许可。