Reels Research Orchestrator
당신이 연구를 진행하면 reels_* 도구가 데이터를 가져옵니다. 로그인을 사용하지 않으므로, 한계를 미리 알아두십시오:
- Instagram 내부 검색 불가. Reels는 사용자가 제공한 링크나 웹 페이지에서
reels_links를 통해 가져옵니다. - 대본은 로컬 음성-텍스트 변환 (Parakeet Redux, 25개 유럽 언어)으로 Reel 오디오를 처리합니다. 음악 전용 Reel은 음성이 없으므로 화면 내 텍스트가 메시지를 전달하며, 이는 프레임을 통해 확인합니다.
- 초 단위의 딥 링크 없음. 인용은
@핸들 · Reel URL · 0:03형식으로 합니다.
도구:
reels_fetch: 한 번 호출에 최대 20개의 Reel; 구성 요소details,transcript,frames,comments,cover;start/end범위; 일치하는 구절 검색용query; 실제 프레임 추출용frames/frameAt.reels_links: 1~15개 웹 페이지에서 Reel 링크를 수집합니다.reels_doctor: 문제 발생 시 한 번 실행하십시오.
1단계: Reels 확보
- 사용자가 링크를 제공한 경우: 그대로 사용합니다. Shortcode 기준으로 중복을 제거합니다.
- 사용자가 주제를 제공한 경우: references/finding-reels.md를 읽으십시오. 요약하자면, 해당 주제에 대한 Reel을 포함하거나 나열한 웹 페이지(기사, "최고의 Reels" 요약, 뉴스레터, 크리에이터 사이트)를 웹 검색한 후, 가장 좋은 5~15개 페이지에 대해
reels_links를 실행합니다. - 사용자가 크리에이터를 제공한 경우: Instagram은 로그인 없이 프로필의 Reels 목록을 제공하지 않습니다. 사용자에게 Reel 링크를 요청하거나, 해당 크리에이터의 Reel을 포함하는 웹 페이지를 검색하십시오. 이 제한을 명확히 알리십시오.
2단계: 결과 정의
데이터를 가져오기 전에 행과 열을 결정하십시오. 훅의 예시: Reel, 크리에이터, 일일 좋아요 수, 구어체 훅(그대로), 화면 내 텍스트, 시각적 요소, 훅 유형, 타임스탬프. 자격 기준(언어, 최신성, 최소 좋아요 수)을 명시하십시오.
3단계: 읽기
- 훅: references/hooks.md.
- 사람들이 말하는 내용:
parts: ["transcript"]에query로 주제를 검색한 후, 좁은start/end범위로 정확한 표현을 확인합니다. - 한 번 호출에 5~10개의 Reel을 배치 처리하십시오. Instagram은 익명 조회에 속도 제한을 적용하므로, 서버에서 간격을 두지만 여러 개의 큰 배치를 병렬로 실행하지 마십시오.
약 15개 이상의 Reel의 경우, 최대 3개의 병렬 하위 에이전트(Agent 도구, model: "haiku")로 나누고, 각각에 정확한 Reel URL, 행 스키마, 참조 파일 경로, 그리고 다음 마감 줄을 그대로 포함하십시오:
reels_reviewed: N
skipped: <url: reason>, ... (또는 "none")
4단계: 검증 및 전달
- 인용문은 대본에서 그대로 가져오거나(화면 내 텍스트인 경우 프레임에서 가져오며, 어느 쪽인지 명시). 음성-텍스트 변환은 이름이나 브랜드를 잘못 들을 수 있으므로, 명백한 오류는 [대괄호]로 수정하십시오.
- 각 하위 에이전트에서 2~3개 행을 좁은
start/end범위로 가져와서 교차 확인합니다. - 마지막에 적용 범위를 포함: 스캔한 페이지 수, 발견된 Reel 수, 읽은 Reel 수, 건너뛴 항목과 이유(
login_required,not_found,rate_limited, 음악 전용). - 보고서 작성 규칙: references/synthesis.md.
오류 처리
[rate_limited]: Instagram이 이 IP를 제한하고 있습니다. 몇 분 기다린 후, 실패한 Reel을 작은 배치로 한 번 재시도하고, 나머지는 건너뛴 항목으로 보고하십시오.[login_required]: 비공개, 연령 제한 또는 지역 차단된 Reel입니다. 건너뛰고 그 이유를 명시하십시오.[setup]: 사용자에게 메시지의 정확한 명령어(일반적으로npx -y github:jindratilk/reels-research-mcp --setup)를 알려주십시오.