Vercel용 Instagram Public MCP

Instagram 로그인, 쿠키, 비밀번호 또는 저장된 계정 세션이 없이 공개 Instagram 데이터만 조회하는 Python으로 작성된 원격 MCP 서버입니다.

중요: 모바일 피드 Instaloader 패치

이 빌드는 기본 Instaloader 4.15.3 패키지를 사용하지 않습니다.

Instaloader 풀 리퀘스트 #2722의 익명 프로필/게시물 수정 사항을 다음 위치에 고정합니다:

3f72b47466cc505b92c6e9b0ca2f5689e93a6a89

의존성:

instaloader @ https://github.com/alimony/instaloader/archive/3f72b47466cc505b92c6e9b0ca2f5689e93a6a89.zip

이 패치는 익명 동작을 다음과 같이 변경합니다:

• 프로필 확인이 api/v1/users/web_profile_info/에서 api/v1/feed/user/{username}/username/으로 폴백될 수 있습니다;

• 익명 게시물 페이지네이션은 api/v1/feed/user/{id}/를 사용합니다;

• 게시물 페이지는 max_id 페이지네이션을 사용합니다;

• 항목은 Instaloader의 iPhone/모바일 응답 모델을 통해 변환됩니다;

• web_profile_info 실패 시 긴 재시도/백오프 루프를 기다리지 않고 즉시 피드 폴백에 도달할 수 있습니다.

인증된 Instagram 계정은 사용되지 않습니다.

Related MCP server: Instagram Download MCP Server

아키텍처

MCP Client
    |
    v
Vercel /api/mcp
    |
    v
Patched Instaloader (PR #2722)
    |
    v
Instagram mobile feed endpoint

MCP 도구

get_instagram_profile

Instagram 프로필의 공개 메타데이터를 반환합니다.

{
  "username": "instagram"
}

get_instagram_posts

최근 공개 게시물을 반환합니다.

{
  "username": "instagram",
  "count": 3
}

debug_instagram_connection

원시 레거시 web_profile_info HTTP 응답을 검사합니다. 이 도구는 진단용으로 계속 사용할 수 있지만, 패치된 Instaloader는 해당 엔드포인트가 거부될 때 모바일 피드 엔드포인트로 폴백할 수 있습니다.

{
  "username": "instagram"
}

MCP 리소스

instagram://profile/{username}
instagram://profile/{username}/posts

캐시

기본 인메모리 캐시:

CACHE_TTL_SECONDS=600
DEFAULT_POST_COUNT=12
MAX_POST_COUNT=30

비활성화하려면 CACHE_TTL_SECONDS=0으로 설정하세요.

Vercel 인스턴스는 일시적이므로 이 캐시는 전역 공유 캐시가 아니라 웜 함수 인스턴스별 캐시입니다.

Vercel에 배포

npm install -g vercel
vercel --prod

포함된 vercel.json은 함수를 상파울루에 배포합니다:

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "regions": ["gru1"]
}

MCP 엔드포인트:

https://YOUR-PROJECT.vercel.app/api/mcp

헬스 엔드포인트:

https://YOUR-PROJECT.vercel.app/api/health

로컬 개발

python -m venv .venv
pip install -r requirements.txt
uvicorn api.index:app --reload

MCP 엔드포인트:

http://127.0.0.1:8000/api/mcp

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "instagram-public": {
      "url": "https://YOUR-PROJECT.vercel.app/api/mcp"
    }
  }
}

보안

이 저장소에는 Instagram 계정 자격 증명이 포함되어 있지 않습니다.

다음을 포함하거나 요구하지 않습니다:

• Instagram 사용자 이름/비밀번호 자격 증명

• sessionid

• csrftoken

• fb_dtsg

• 인증된 계정 ID

• 저장된 Instaloader 세션

• Instagram 쿠키

제한 사항

서버는 공개 데이터만 조회하며 비공개 프로필을 우회하려고 시도하지 않습니다.

Instagram은 배포 IP에 따라 익명 트래픽을 여전히 속도 제한하거나 차단할 수 있습니다. 모바일 피드 패치는 알려진 깨진 익명 web_profile_info/타임라인 경로를 수정하지만, Instagram이 모든 호스팅 제공업체 또는 IP 범위의 트래픽을 수락할 것이라고 보장할 수는 없습니다.

v2.1.1 프로필 호환성 수정

익명 모바일 피드 폴백은 일반적으로 web_profile_info에 존재하는 선택적 프로필 필드를 생략할 수 있습니다.

버전 2.1.1은 프로필 속성을 방어적으로 읽습니다. biography, external_url 또는 비즈니스 계정 메타데이터와 같은 누락된 값은 get_instagram_profile이 실패하는 대신 null로 반환됩니다.

게시물 가져오기 경로는 v2.1.0에서 변경되지 않았습니다.