instagram-analyzer MCP

instagram-analyzer MCP

Analyzes public Instagram post URLs, returning captions and photos as image content for multimodal models like Claude, without requiring paid vision APIs.

Category
Visit Server

README

instagram-analyzer MCP

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

도구

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

요구사항

설치

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured