instagram-use MCP server
2026년 11월 11일 커밋인증된 워크플로 또는 익명 공개 데이터 조사를 통해 AI 에이전트가 Instagram과 상호작용할 수 있도록 지원합니다.
다른 이름 dalroot/instagram-use
- 스타
- 0
- Tools
- 12
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
instagram-use MCP란?
인증된 워크플로 또는 익명 공개 데이터 조사를 통해 AI 에이전트가 Instagram과 상호작용할 수 있도록 지원합니다. 12개 도구를 제공합니다. 예: instagram_publish_story, instagram_publish_post, instagram_send_message.
프로젝트 README에서 생성된 요약
instagram-use MCP server 정보
instagram-use를 사용하면 대규모 언어 모델과 Instagram 사이의 가교 역할을 하여 AI 에이전트를 위한 소셜 미디어 워크플로 자동화가 가능합니다. 이 도구는 MCP server 또는 Hermes 에이전트 플러그인으로 작동하며, Claude Desktop, LangChain 또는 CrewAI와 같은 도구가 구조화된 JSON 페이로드를 사용하여 플랫폼과 상호작용할 수 있게 합니다. 시스템은 Meta Graph API v21.0 사양을 준수하여 동작의 예측 가능성과 신뢰성을 보장합니다.
사용자는 두 가지 별도의 운영 모드 중 하나를 선택할 수 있습니다. Ghost Mode는 로그인 정보 없이 해시태그 검색이나 경쟁사 프로필 감사와 같은 익명 공개 데이터 조사를 허용합니다. Authenticated Mode는 세션 쿠키가 포함된 instagram_session.json 파일을 사용하는 세션 기반 방식을 통해 능동적인 작업을 수행합니다. 이 모드를 통해 에이전트는 스토리를 게시하고 피드 게시물을 올릴 수 있으며, instagram_get_inbox 도구로 다이렉트 메시지를 관리하고, 30일간의 프로페셔널 계정 인사이트를 가져올 수 있습니다.
계정 안전을 유지하기 위해 서버에는 보안 문제가 발생할 경우 실행을 중단하는 회로 차단기가 포함되어 있으며, 스팸 감지를 방지하기 위해 반복적인 문자열 전송을 제한합니다. 설정에는 Python 3.10 이상, Node.js 18.0 이상, 그리고 twingraph engine CLI가 필요합니다.
활용 사례
- 1익명 경쟁사 조사에이전트가 계정에 로그인하지 않고도 경쟁사의 공개 프로필과 참여율을 분석할 수 있습니다.
- 2콘텐츠 게시 자동화개발자가 AI에게 Instagram 피드에 새로운 이미지나 스토리를 직접 게시하도록 지시할 수 있습니다.
- 3고객 문의 관리AI 에이전트가 사용자의 받은 편지함에 들어오는 다이렉트 메시지를 모니터링하고 요약할 수 있습니다.
- 4프로페셔널 계정 분석사용자가 프로페셔널 계정에 대한 상세한 성과 지표와 오디언스 데이터를 가져올 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
instagram-use MCP 도구 12
README에서 감지됨instagram_publish_storyinstagram_publish_postinstagram_send_messageinstagram_get_inboxinstagram_post_commentinstagram_get_insightsinstagram_get_profileinstagram_get_postsinstagram_get_media_metricsinstagram_get_commentsinstagram_searchinstagram_audit_account
| instagram_publish_story | — | |
| instagram_publish_post | — | |
| instagram_send_message | — | |
| instagram_get_inbox | — | |
| instagram_post_comment | — | |
| instagram_get_insights | — | |
| instagram_get_profile | — | |
| instagram_get_posts | — | |
| instagram_get_media_metrics | — | |
| instagram_get_comments | — | |
| instagram_search | — | |
| instagram_audit_account | — |
구성
INSTAGRAM_SESSION_PATH
| 이름 | 설명 | 유형 |
|---|---|---|
| INSTAGRAM_SESSION_PATH | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능dalroot/instagram-use is public and reachablegithub.com/dalroot/instagram-use ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/dalroot/instagram-use ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음12 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기instagram-use
Make Instagram usable for AI agents.
Standardized Meta Graph API v21.0 Twin architecture, Model Context Protocol (MCP) server, and Agent plugin for autonomous Instagram workflows via session cookies or anonymous Ghost Mode.
Overview
Modern AI agents need hands and eyes on social platforms, but integrating with Instagram has traditionally forced teams into one of two dead ends:
- The Official Meta App Wall: Requires burdensome corporate business verification, multi-week app reviews, and severely restricted permission scopes.
- Fragile Web Scrapers: Unstructured HTML parsing that breaks with every frontend release and triggers instant security checkpoints or account bans.
instagram-use bridges this gap. It models public actions and authenticated workflows 1:1 after the official Meta Graph API v21.0 specifications, executing them directly through clean GraphQL and private session transports.
Designed specifically for LLM tool-calling (Hermes, Claude Desktop/MCP, Antigravity, LangChain, CrewAI, AutoGen), instagram-use outputs strictly typed, structured JSON payloads with built-in safety circuit breakers.
Dual Operational Modes
instagram-use operates in two distinct modes depending on task requirements:
┌────────────────────────────────────────────────────────┐
│ instagram-use │
├───────────────────────────┬────────────────────────────┤
│ Ghost Mode │ Authenticated Mode │
│ (Zero Login / Public) │ (Cookie Session / Auth) │
├───────────────────────────┼────────────────────────────┤
│ • Profile Inspection │ • Story Publishing │
│ • Public Post / Reel Data │ • Feed Post Publishing │
│ • Public Comment Harvest │ • Direct Message (Send/DM) │
│ • Hashtag / User Search │ • Direct Inbox Inspection │
│ • Competitor Account Audit│ • Post / Reel Commenting │
│ │ • 30-Day Account Insights │
└───────────────────────────┴────────────────────────────┘
1. Ghost Mode (Zero Footprint / No Login)
- Zero Credentials Required: No account, password, or cookies necessary.
- Risk-Free Exploration: Inspect competitor profiles, harvest public comment threads, scan viral reels, and search hashtags without leaving an audit trail or risking primary accounts.
- Ideal For: Market intelligence agents, competitor monitoring, sentiment scrapers, and trend discovery bots.
2. Authenticated Mode (Session-Based Digital Twin)
- Cookie-Based Authentication: Operates through a standard desktop session file (
instagram_session.jsoncontainingsessionidandcsrftoken). No plaintext passwords ever stored or requested. - Full Action Surface: Publish stories and feed posts, respond to direct messages, post comments, and extract 30-day professional account analytics.
- Anti-Ban Protection: Enforces single-attempt fail-closed circuit breakers and strict string deduplication limits to protect account health.
Provided Tools Reference
instagram-use exposes 12 deterministic tools for LLM tool calling:
| Tool | Mode | Description | Key Parameters |
|---|---|---|---|
instagram_publish_story |
Authenticated | Publish an ephemeral story (24-hour lifecycle). | image_input (path or base64) |
instagram_publish_post |
Authenticated | Publish a feed post with caption, hashtags, and mentions. | image_input, caption |
instagram_send_message |
Authenticated | Send a direct message to a user (supports handles or numeric IDs). | recipient, message |
instagram_get_inbox |
Authenticated | Read direct message inbox threads and unread conversations. | limit |
instagram_post_comment |
Authenticated | Post an authentic comment on any post or reel. | media_id_or_url, text |
instagram_get_insights |
Authenticated | Fetch 30-day professional metrics, audience curves, and reach. | period, metric_type |
instagram_get_profile |
Ghost | Inspect public profile details (bio, follower count, avatar). | username |
instagram_get_posts |
Ghost | Fetch recent posts/reels with like counts and engagement rates. | username, count |
instagram_get_media_metrics |
Ghost | Retrieve performance metrics (views, discussion count) for a reel/post. | shortcode_or_url |
instagram_get_comments |
Ghost | Harvest public comments from any post or reel without logging in. | shortcode_or_url, limit |
instagram_search |
Ghost | Search for users, creators, and trending hashtags anonymously. | query |
instagram_audit_account |
Ghost | Perform a comprehensive analytical audit of any public account. | username |
Installation & Setup
Requirements
- Python
>= 3.10 - Node.js
>= 18.0.0 twingraphengine CLI (globally available inPATH)
Option A: Install as a Hermes Agent Plugin
hermes plugins install instagram-use
Or clone directly into your Hermes plugins directory:
git clone https://github.com/dalroot/instagram-use.git ~/.hermes/plugins/instagram-use
Option B: Use as an MCP Server (Model Context Protocol)
Add instagram-use to your MCP configuration (Claude Desktop, Cursor, Antigravity, etc.):
{
"mcpServers": {
"instagram": {
"command": "twingraph",
"args": ["mcp"],
"env": {
"INSTAGRAM_SESSION_PATH": "/path/to/instagram_session.json"
}
}
}
}
Option C: Standalone Python / CLI Integration
Clone and install dependencies:
git clone https://github.com/dalroot/instagram-use.git
cd instagram-use
pip install -e .
Authentication & Session Setup
For Ghost Mode, no authentication is required.
For Authenticated Mode:
- Run the interactive session generator:
This opens a secure browser window for you to log in to Instagram once.twingraph login - The session is automatically persisted to
~/instagram_session.json. - Alternatively, you can supply your existing cookies manually:
{ "cookies": { "sessionid": "YOUR_SESSION_ID", "ds_user_id": "YOUR_USER_ID", "csrftoken": "YOUR_CSRF_TOKEN" } }
Safety & Circuit Breaker Architecture
Automated agents can trigger platform checkpoints if they get stuck in loops or send repetitive payloads. instagram-use includes built-in protective layers:
- Single-Attempt Fail-Closed: If an authenticated request encounters a non-200 response or security challenge, the circuit breaker immediately trips and halts execution. Automated retry loops are strictly blocked.
- String Deduplication Caps: Dispatches of identical comments or messages are capped at safe thresholds to prevent triggering automated spam classifiers.
- Strict Parameter Coercion: URLs, shortcodes, and usernames are automatically validated and resolved before executing network requests.
Example Agent Prompts
# Publishing a Story
Agent Prompt: "Publish the graphic at /tmp/announcement.jpg as an Instagram story."
Tool Called: instagram_publish_story(image_input="/tmp/announcement.jpg")
# Direct Message Inquiries
Agent Prompt: "Check our direct message inbox for any unread customer questions and summarize them."
Tool Called: instagram_get_inbox(limit=10)
# Anonymous Competitor Audit (Ghost Mode)
Agent Prompt: "Inspect the public profile @competitor_brand, calculate their average reel engagement, and summarize their top 3 recent posts."
Tools Called:
1. instagram_get_profile(username="competitor_brand")
2. instagram_get_posts(username="competitor_brand", count=10)
Repository Metadata & Topics
Recommended configuration for the GitHub repository:
- Repository Name:
instagram-use - Short Description (About):
Make Instagram usable for AI agents. Meta Graph API v21.0 Twin architecture, MCP server, and Agent plugin for stories, posts, DMs, comments, and anonymous Ghost Mode. - Website:
https://github.com/dalroot/instagram-use - GitHub Topics:
instagram-use,ai-agents,mcp-server,llm-tools,instagram-agent,agent-toolkit,hermes-agent,meta-graph-api,cookie-session,automation
License
This project is licensed under the MIT License. See LICENSE for details.
instagram-use MCP 질문
instagram-use MCP는 어떤 도구를 제공하나요?
12개 도구를 제공합니다. 예: instagram_publish_story, instagram_publish_post, instagram_send_message, instagram_get_inbox, instagram_post_comment.
서버가 Instagram 계정의 차단을 어떻게 방지하나요?
스팸 감지를 방지하기 위해 단일 시도 실패 시 차단(fail-closed) 메커니즘과 문자열 중복 제거 제한을 포함하는 안전 회로 차단기(safety circuit breaker) 아키텍처를 사용합니다.