Instagram 댓글 관리 (instagram-comments)

개요

발행된 Instagram 미디어의 댓글을 조회하고, 답글을 달고, 댓글을 숨긴다. 이 스킬은 Instagram Graph API 의 댓글 엔드포인트(manage_comments 권한 게이트) 를 통해 instagram_comments_list / instagram_comments_reply / instagram_comments_hide 도구를 호출한다.

> 권한: 세 가지 도구 모두 Meta 앱에 manage_comments 권한이 부여되어 있어야 한다. 권한이 없으면 API 가 거부한다.

트리거 키워드

댓글, comment, 답글, reply, 숨김, hide, 모더레이션, 스팸, 정리

워크플로우

1단계: 댓글 목록 조회

특정 미디어(media_id) 의 댓글을 나열한다:

python
instagram_comments_list(media_id="<미디어 ID>")
# → {"data": [{"id", "text", "username", "timestamp", "hidden": false}, ...]}

• media_id 는 instagram_publish_image 등 발행 도구가 반환한 media_id (또는 instagram_insights 로 조회한 미디어 ID).

2단계: 답글 작성

특정 댓글(comment_id) 에 답글을 단다:

python
instagram_comments_reply(comment_id="<댓글 ID>", text="<답글 본문>")
# → {"id": "<새 답글 ID>"}

답글 본문도 저장된 문체 프로필을 반영해 작성한다 (있으면). 공격적/스팸 댓글에는 답글 대신 숨김을 권장.

3단계: 댓글 숨김

스팸/비난 댓글을 숨긴다 (삭제가 아님 — 작성자와 페이지 관리자만 안 보이거나, 정책에 따라 전체 숨김):

python
instagram_comments_hide(comment_id="<댓글 ID>")
# → {"hidden": true}

숨김은 가역적이다 — Meta 정책에 따라 다시 보이게 할 수 있다.

주의사항

| 상황 | 대응 | |------|------| | manage_comments 권한 없음 | Meta 앱 검수(App Review) 로 권한 추가 필요 | | setup_required 에러 | IG_ACCESS_TOKEN / IG_USER_ID 환경변수 설정 | | Personal 계정 | Graph API 미지원 — Professional 계정 필요 | | 엔드포인트 미검증 | comments 엔드포인트 경로는 run-phase 검증 대상(@MX:TODO) — 최초 사용 시 공식 문서로 경로 재확인 권장 |

출력 형식

markdown
## 댓글 관리 결과

**미디어**: <media_id>
**댓글 수**: N

| 댓글 ID | 작성자 | 본문 | 상태 |
|---|---|---|---|
| ... | ... | ... | 표시/숨김 |

**조치**: (답글/숨김 내역)

발행 전 설정 (최초 1회)

Threads 와 동일한 Instagram 자격증명(IG_ACCESS_TOKEN / IG_USER_ID) 에 추가로 Meta 앱에 manage_comments 권한이 부여되어야 한다. 발급 절차는 mcp-servers/moai-mcp-threads-poster/CONNECTORS.md 의 Instagram 섹션 참조.

관련 스킬

| 스킬 | 사용 시점 | |------|----------| | instagram-post | 포스트 발행 (댓글 관리 전에 발행이 선행) |

이 스킬을 사용하지 말아야 할 때

• 포스트 발행: instagram-post 스킬
• 인사이트 조회: instagram_insights 도구 직접 호출
• Threads 댓글: Threads API 는 본 플러그인 범위 밖