instagram-analyzer MCP

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

도구

도구	설명
analyze_instagram_post(url, max_images=5)	게시물/릴스 URL의 캡션·메타(게시자·작성일·좋아요·댓글 수)와 사진(들)을 반환. 캐러셀(여러 장) 게시물도 각 사진을 반환.

요구사항

• 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 환경변수를 설정합니다.

환경변수	설명
IG_USERNAME	인스타 계정명. 지정하면 instaloader 기본 경로의 세션(session-<username>)을 자동 로드.
IG_SESSIONFILE	(선택) 세션 파일 경로를 직접 지정.
IG_PASSWORD	(대안) 비밀번호 직접 로그인 — 챌린지에 약하므로 세션 파일 권장.

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

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