Instagram MCP 서버

AI 에이전트가 Instagram 비즈니스 계정 분석 및 인사이트에 액세스할 수 있도록 하는 MCP 서버입니다.

도구

Related MCP server: Instagram Complete MCP Server

설정

cd instagram-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install "mcp[cli]" httpx

자격 증명이 포함된 .env 파일을 생성하세요:

INSTAGRAM_ACCESS_TOKEN=your_token
INSTAGRAM_ACCOUNT_ID=17841...

Instagram 자격 증명 얻기

1. Meta for Developers로 이동하여 앱을 생성합니다 (유형: 비즈니스)

2. 앱에 Instagram Graph API 제품을 추가합니다

3. Graph API 탐색기(developers.facebook.com/tools/explorer)에서:

   • 드롭다운에서 앱을 선택합니다

   • **액세스 토큰 생성(Generate Access Token)**을 클릭합니다

   • 권한 부여: instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement

4. Instagram 비즈니스 계정 ID를 가져옵니다:

   • Graph API 탐색기에서 me/accounts를 쿼리하여 페이지 ID를 가져옵니다

   • 그런 다음 {page-id}?fields=instagram_business_account를 쿼리합니다

   • 응답의 id 필드가 귀하의 INSTAGRAM_ACCOUNT_ID입니다

5. 탐색기에서 얻은 토큰은 단기용(1시간)입니다. 장기 토큰을 얻으려면:

   • 다음 주소에서 교환하세요: oauth/access_token?grant_type=fb_exchange_token&client_id={app-id}&client_secret={app-secret}&fb_exchange_token={short-lived-token}

   • 이렇게 하면 60일 동안 유효한 토큰을 얻을 수 있습니다

참고: 귀하의 Instagram 계정은 Facebook 페이지에 연결된 비즈니스 또는 크리에이터 계정이어야 합니다.

Claude Code와 함께 사용하기

claude mcp add instagram-mcp -e INSTAGRAM_ACCESS_TOKEN=your_token -e INSTAGRAM_ACCOUNT_ID=17841... -- python3 -m src.server

그런 다음 Claude에게 다음과 같이 질문하세요:

• "이번 달 내 상위 게시물은 무엇인가요?"

• "내 팔로워 인구 통계를 보여줘"

• "가장 많이 저장된 게시물은 무엇인가요?"

• "내 참여율 추세는 어떤가요?"

콘텐츠 전략가 에이전트

Instagram 데이터를 분석하고 7개의 게시물 아이디어, 캡션 및 게시 시간이 포함된 주간 콘텐츠 계획을 생성하는 독립형 에이전트입니다.

에이전트 실행

source .venv/bin/activate
python -m agent.content_strategist

AWS 자격 증명(Anthropic Bedrock 사용)이 구성되어 있어야 하며 MCP 서버와 동일한 .env 변수가 필요합니다. 에이전트는 다음을 수행합니다:

1. 계정 정보, 최근 게시물, 상위 게시물 및 팔로워 인구 통계를 가져옵니다

2. 성과가 좋은 콘텐츠의 패턴을 식별합니다

3. 특정 캡션, 해시태그 및 타이밍이 포함된 7일 콘텐츠 계획을 생성합니다

4. 계획을 HTML 파일로 저장하고 브라우저에서 엽니다