instagram-analyzer MCP

공개 인스타그램 게시물 URL을 받아 캡션(텍스트) + 사진(들) 을 반환하는 로컬 MCP 서버입니다. 릴스/영상 게시물은 키프레임 이미지 + 음성 자막(Whisper) 을 반환합니다. 사진·프레임을 MCP 이미지 콘텐츠로 돌려주므로, Claude 같은 멀티모달 모델이 직접 보고 시각 분석할 수 있습니다. 별도의 유료 비전 API가 필요 없습니다.

도구

영상 자막은 GROQ_API_KEY 가 env 또는 ~/.config/watch/.env 에 있어야 생성됩니다(없으면 자막만 건너뛰고 키프레임 분석은 동작). 키프레임 추출에는 ffmpeg 가 필요합니다.

Related MCP server: Instagram Download MCP Server

요구사항

• Python ≥ 3.10, uv

• 의존성: mcp (v1), instaloader

설치

git clone https://github.com/SsangG77/instagram-analyzer-mcp.git
cd instagram-analyzer-mcp
uv sync

MCP 등록 (Claude Code)

claude mcp add --scope user instagram-analyzer -- \
  uv --directory "$(pwd)" run server.py

인증 (필수)

⚠️ 익명(비로그인) 접근은 인스타그램이 403 / rate-limit 으로 차단합니다. 본인 계정 세션이 필요합니다.

# 1) instaloader 로 세션 파일 생성 (대화형 로그인 — 비밀번호/2FA 입력)
instaloader --login <your_instagram_username>

그런 다음 MCP 환경변수를 설정합니다.

예) 세션 생성 후 계정명만 지정해 재등록:

claude mcp remove --scope user instagram-analyzer
claude mcp add --scope user instagram-analyzer -e IG_USERNAME=<your_username> -- \
  uv --directory "$(pwd)" run server.py

비용 / 한계 (trade-off)

• 무료 — 로컬 실행, 외부 유료 API 0.

• 단, 본인 인스타 로그인 세션이 필요하고, 인스타의 anti-bot 로 rate-limit / 계정 차단 가능.

• 인스타 스크래핑은 ToS 회색지대이며, 인스타 내부 변경 시 깨질 수 있습니다(유지보수 부담).

• 안정성·무유지보수가 중요하면 Apify Instagram Scraper 같은 유료 스크래핑 서비스가 대안입니다.

라이선스

MIT