instagram-mcp
Verified@luoyi-dsh/instagram-mcp · v1.0.9 · MIT · Web UI
DeepSeek Harness (DSH) Instagram FastMCP 核心服務插件:提供 Python FastMCP 子進程管理、Session 會話維持、與 Instagram MCP 工具標準介面
Install
dsh plugin add @luoyi-dsh/instagram-mcp Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
DSH Instagram FastMCP 核心服務插件 (@luoyi-dsh/instagram-mcp)
DeepSeek Harness (DSH) 官方底層 Instagram 核心服務外掛。
負責自動管理獨立的 Python FastMCP 子進程、集中管理機器人帳號 (username) 與主人帳號 (masterUsername)、維持登入 Session 憑證,並向 DSH Tools 與上層外掛提供標準 Model Context Protocol (MCP) 操作介面。
[!CAUTION]
⚠️ 重要風險警告與免責聲明 (CRITICAL DISCLAIMER)
- 違反 Instagram 社群守則與服務條款:本插件與底層 FastMCP 服務使用非官方逆向 API(基於
instagrapi),明確違反 Instagram / Meta 的服務條款與社群守則。- 切勿使用本人主要帳號運行:嚴禁使用個人主要帳號或重要商業帳號!自動化讀寫操作極易觸發官方審查,導致功能限制 (Action Blocked)、安全驗證或永久封號。請務必使用測試小號並搭配純淨住宅代理。
- 免責宣告:本專案純屬技術研究用途,任何帳號停權或損失由使用者自負風險。
🌟 核心特性
- 全域統一帳號綁定:
- 於本插件集中設定「機器人帳號 (
username)」與「主人帳號 (masterUsername)」,上層插件@luoyi-dsh/instagram-plugin與@luoyi-dsh/instagram-scroll自動同步沿用,無須重複輸入。
- 於本插件集中設定「機器人帳號 (
- Python 虛擬環境與 FastMCP 子進程自動維護:
- 自動檢測系統 Python /
uv建立獨立.venv,並管理 Stdio FastMCP 伺服器生命週期與 Session 持久化 (data/ig_session.json)。
- 自動檢測系統 Python /
- 多階段模糊搜尋 (
ig_fuzzy_search_posts):- 結合 Instagram 綜合搜尋 (
top_serp)、Reels 搜尋與公開創作者最新貼文,徹底解決單純 Hashtag 標籤搜尋返回 0 則貼文的問題。
- 結合 Instagram 綜合搜尋 (
- 完整貼文與 Reel 內容解析 (
ig_get_post_context&ig_get_recent_mentions):- 完整提取貼文與 Reel 的內文、標題、無障礙視覺描述 (
accessibility_caption)、配樂/原聲資訊 (audio_info)、影片字幕 (video_subtitles)、圖片 URL 以及巢狀樓中樓子留言 (preview_child_comments)。
- 完整提取貼文與 Reel 的內文、標題、無障礙視覺描述 (
- 內建多重防風控安全機制 (Anti-Risk Control):
- 寫入隨機抖動延遲 (Jitter)、讀取微延遲 (Pacing)、每小時寫入上限與異常自動熔斷冷卻保護 (Circuit Breaker)。
📦 安裝方式
# 使用 DSH CLI 安裝外掛
dsh plugin --profile web add @luoyi-dsh/instagram-mcp
# 或透過 npm 安裝
npm install @luoyi-dsh/instagram-mcp
📖 插件操作方法與工具調用說明
完整的 MCP 工具清單、自然語言調用範例、HTTP REST API 路由、跨插件 Node.js 調用方法與設定參數表,請參閱 AGENTS.md。
📁 目錄結構
dsh-instagram-mcp/
├── cordis.patch.yml # DSH bundle patch 宣告
├── package.json # 模組定義與依賴宣告
├── tsconfig.json # TypeScript 編譯設定
├── AGENTS.md # 插件操作方法與 Agent 調用指南
├── CHANGELOG.md # 版本更新紀錄
├── README.md # 英文介紹文件
├── README.zh-Hant.md # 繁體中文介紹文件 (本檔案)
├── client.js # DSH Web 前端控制面板
├── vendor/instagram-mcp/ # 獨立 Python FastMCP 核心模組 (server.py, auth.py, core.py)
└── src/ # 外掛入口、單例服務、MCP Client 與工具註冊
📜 版本紀錄與授權條款
- 詳細版本演進與更新紀錄,請參閱 CHANGELOG.md。
- 本專案採用 MIT License 開源授權。
