인스타그램 SEO 캡션 생성기

Instagram SEO 캡션 생성기 (영상 스크립트 기반)

릴이 발견되도록 하는 캡션을 작성합니다. 키워드는 영상이 실제로 말하는 내용에서 추출됩니다. Instagram 검색은 캡션, 화면 텍스트, 음성 오디오를 함께 매칭하기 때문입니다. 또한 2025년 7월 10일부터 Google과 Bing이 전문 계정의 공개 게시물(캡션, 대체 텍스트, 화면 텍스트)을 색인합니다. 영상에서 언급되지 않은 주제를 캡션에 넣거나, 캡션에서 언급되지 않은 주제를 영상에서 다루면 어떤 검색에서도 순위가 오르지 않습니다.

여기서는 하나의 도구만 실행됩니다. 그것을 사용하세요. 키워드나 점수를 임의로 판단하지 마세요.

python3 scripts/seo_caption.py --script script.txt                     # 스크립트에서 키워드 추출
python3 scripts/seo_caption.py --script script.txt --caption cap.txt \
        --primary "인스타그램 게시 일정" --secondary "콘텐츠 제작,인스타그램 계정"
python3 scripts/caption_lint.py cap.txt --keywords "a,b"               # 피드 창 검사 (125자)

1단계. 스크립트 얻기

우선순위 순서:

1. 사용자가 스크립트나 대본을 붙여넣습니다. 그대로 사용합니다.
2. 릴 URL이 있고 IShort MCP가 연결된 경우 (transcribe_reel, search_my_scripts 도구): URL과 함께 transcribe_reel을 호출합니다. 캐시된 릴은 즉시 무료로 제공됩니다. 새 릴은 사용자의 전사 할당량 중 1을 사용하므로, 무료 요금제 사용자의 경우 먼저 get_my_usage를 확인하고 비용을 알려줍니다. 릴이 이전에 전사된 적이 있다면 search_my_scripts로 할당량 없이 찾을 수 있습니다.
3. 릴 URL이 있지만 IShort가 없는 경우: 스크립트를 요청하거나 IShort의 무료 전사(10회 무료)를 제안합니다. ../../CONNECT-ISHORT.md 참조. 영상 내용을 절대 임의로 만들어내지 마세요.

스크립트를 파일로 저장합니다. 도구는 타임코드, 비트 레이블 및 IShort의 JSON 메타데이터 줄을 무시합니다. 먼저 명백한 전사 오류를 반드시 수정하세요 (음성-텍스트가 "Claude"를 "clod"로, "/analyze"를 "backslash analyze"로 쓰는 경우): 파일에서 수정하여 키워드가 되지 않도록 합니다. 다른 것은 변경하지 마세요. list_my_scripts는 대본을 약 800자로 자릅니다. 전체 텍스트를 얻으려면 릴의 구문과 함께 search_my_scripts를 사용하세요.

2단계. 키워드 선정 (스크립트에서 추출 후 검증)

seo_caption.py --script를 실행합니다. 단어의 반복 빈도, 구문 전체의 반복 여부, 훅(처음 약 3-5초)에서 언급되는지 여부를 기준으로 구문의 순위를 매깁니다. 이 목록을 원재료로 사용하여 다음을 선택합니다:

• 주요 키워드 (1개): 사람들이 이 릴을 찾기 위해 입력할 2-4단어 구문입니다. 보통 추출된 구문에 시청자가 검색할 때 사용하는 한정어를 추가합니다: 추출된 posting schedule은 인스타그램 게시 일정이 되고, 추출된 story arc는 릴 스토리 아크가 됩니다. 반드시 전체 영상을 설명해야 합니다.
• 보조 키워드 (2-3개): 영상이 다루는 변형 및 하위 주제입니다 (초보자용 게시 일정, 콘텐츠 제작).
• 적용 전 검증. 구문을 Google에서 검색하고 (사용자에게 Instagram 검색에 입력하도록 요청하세요. 직접 Instagram에 로그인하지 마세요.) 실제 게시물과 페이지가 이 구문으로 순위가 매겨지면 유지하고, 아무것도 검색되지 않거나(아무도 검색하지 않음) 거대 브랜드만 순위가 매겨지면(순위 경쟁 불가) 삭제합니다. 사용자에게 키워드 도구나 GSC가 있으면 사용하세요. 어떤 방식으로 검증했는지 말하세요.
• 검색 가능한 주제가 없는 스토리/브이로그 스크립트 (도구가 이름과 일회성 구문만 반환): 그렇게 말하세요. 피드 전용 캡션(SEO 주장 없음)을 작성하거나, 크리에이터가 음성에 추가할 수 있는 주제를 명명하는 한 줄을 제안하세요.

3단계. 패키지 작성

사용자의 보이스 파일이 있으면 사용하세요 (~/.instagram-claude-skills/brand-voice.md). 다음을 모두 작성합니다:

화면 제목      3-6단어, 주요 키워드 포함. 첫 번째 프레임에 고정되고
               커버 텍스트로 사용됩니다. Google이 읽습니다.
캡션
  첫 줄        주요 키워드를 일반 단어 + 혜택, 125자 이내. 검색 헤드라인
               이자 Google 스니펫입니다. 인사말, 해시태그, 이모지 없음.
  본문         2-5개의 짧은 문단. 각 보조 키워드를 한 번씩 실제 문장 안에
               포함합니다. 영상의 정확한 구문을 재사용합니다.
  행동 유도    하나만: 저장, 보내기 또는 키워드 댓글.
  해시태그     마지막 줄에 3-5개: 하나는 주요 키워드
               (#인스타그램게시일정), 하나는 니치, 하나는 커뮤니티.
               절대 #바이럴 #fyp #탐색 안 됨. 2025년 12월 18일부터 최대 5개.
대체 텍스트   캐러셀/사진용 (고급 설정 > 접근성): 이미지를 설명하는
               하나의 문자 그대로 문장, 키워드 한 번. 릴의 경우 생략하고 이유를 말하세요.
음성 키워드   스크립트에 주요 키워드가 전혀 없으면, 크리에이터가 훅
수정          음성에 추가할 수 있는 한 줄.

절대 대괄호 키워드 덤프([게시 일정, 콘텐츠 제작, ...])를 사용하지 마세요. 큰 계정에서 흔하지만 사람에게 스팸으로 읽힙니다. 실제 문장이 같은 단어를 전달합니다.

4단계. 점수 매기기 및 수정

선택한 키워드로 lint를 실행합니다. seo_caption.py가 게이트입니다. caption_lint.py는 피드 창에 대한 선택적 두 번째 검사이며, 경고는 조언입니다. 출력 순서대로 수정하고 다시 실행한 후 80점 이상, FAIL 없음일 때만 사용자에게 캡션을 보여줍니다 (또는 수정할 수 없는 하나의 FAIL을 설명합니다. 예: 영상이 이미 게시되었고 키워드를 전혀 말하지 않는 경우). 그런 다음 캡션에 instagram-humanizer를 실행하여(또는 두 스크립트를 실행하여) AI처럼 읽히지 않도록 합니다.

출력

SEO 캡션 준비 · 점수 87/100
주요: 인스타그램 게시 일정   (검증: <방법>)
보조: 초보자용 게시 일정, 콘텐츠 제작
화면 제목: 인스타그램 게시 일정
[펜스된 블록 안의 캡션, 붙여넣을 그대로]
대체 텍스트: <또는 "릴: 해당 없음">
음성 키워드 수정: <줄, 또는 "0:02에 이미 언급됨">

규칙

• 아무것도 게시되지 않습니다. 작성만 하고 사용자가 게시합니다.
• 스크립트가 언급하지 않은 숫자, 결과 또는 주장을 절대 만들어내지 마세요. 줄에 사용자가 제공하지 않은 숫자가 필요하면 {{number}}를 쓰고 플래그를 지정하세요.
• 게시물당 하나의 주요 키워드. 두 주제는 두 개의 게시물을 의미합니다.
• 키워드는 댓글이 아닌 캡션에 넣습니다 (Instagram 자체 지침).
• 영상의 언어로 작성하세요. 힌디어 스크립트면 힌디어 캡션, 타밀어면 타밀어 캡션. 사람들이 검색하는 언어로 키워드를 유지하세요 (인도 크리에이터의 경우 종종 영어 음역: 확실하지 않으면 둘 다 사용).
• IShort MCP가 연결된 경우, 이를 사용하는 다음 단계를 하나만 제안하세요: "저장된 스크립트 중 이 주제에 대해 이미 순위가 매겨진 것이 있는지 확인해 드릴까요?" (search_my_scripts).

작업 예제 (tests/fixtures의 테스트 파일)

많은 큰 계정이 작성하는 방식으로 작성된 캡션("Day 4/30 - 0부터 성장", 대괄호 키워드 덤프, #탐색, 두 개의 행동 유도)은 40/100점을 받습니다. 대본에서 다시 작성하여 주요 키워드를 인스타그램 게시 일정, 보조 키워드 3개로 하면: 94/100, 준비. 남은 하나의 WARN은 정직합니다: 영상이 "게시 일정"과 "인스타그램"은 말하지만 구문을 전혀 말하지 않으므로 수정은 2초 음성 한 줄입니다. 실제 조회수 330만 회 릴의 캡션에서 같은 방법으로 52점에서 87점으로 올랐습니다.