Instagram SEO 標題產生器（從影片腳本）
產出能夠讓 Reels 被找到 的標題，而不只是被閱讀。關鍵字來自影片實際說的內容，因為 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 "instagram posting schedule" --secondary "content creation,instagram account"
python3 scripts/caption_lint.py cap.txt --keywords "a,b" # 摘要窗口檢查（125 字元）
第一步：取得腳本
依優先順序：
- 使用者直接提供腳本或轉錄文字。 直接使用。
- 有 Reels 網址，且已連接 IShort MCP（工具名稱為
transcribe_reel、search_my_scripts）：使用網址呼叫transcribe_reel。已快取的 Reels 立即且免費；新的則會消耗使用者 1 次的轉錄配額，因此對於免費方案使用者，請先透過get_my_usage檢查配額並告知所需成本。如果該 Reels 先前已轉錄過，search_my_scripts可以在不消耗配額的情況下找到它。 - 有 Reels 網址，但無 IShort：要求提供腳本，或提供 IShort 的免費轉錄服務（10 次免費）：請參閱
../../CONNECT-ISHORT.md。絕對不要自行編造影片內容。
將腳本儲存成檔案。工具會忽略時間碼、節拍標籤以及 IShort 的 JSON 中繼資料行。務必先修正明顯的轉錄錯誤（語音轉文字可能將「Claude」寫成「clod」、將「/analyze」寫成「backslash analyze」）：在檔案中修正這些錯誤，確保它們不會變成關鍵字。除此之外不要修改任何內容。list_my_scripts 會將轉錄內容截斷至約 800 字元；請使用 search_my_scripts 並提供 Reels 中的一個詞組來獲取完整文字。
第二步：選取關鍵字（從腳本中提出，然後驗證）
執行 seo_caption.py --script。它會根據詞彙的重複頻率、整個短語的重複性，以及該短語是否出現在鉤子（約前 3-5 秒）中來對短語進行排序。將列表視為原始素材，然後選擇：
- 主要關鍵字（1 個）： 一個 2-4 個詞的短語，使用者會輸入這個短語來找到這個 Reels。通常是提取的短語加上觀看者搜尋時會使用的限定詞：提取的
posting schedule變成instagram posting schedule；提取的story arc變成story arc for reels。它必須描述整個影片。 - 次要關鍵字（2-3 個）： 影片涵蓋的變體和子主題（
posting schedule for beginners、content creation）。 - 提交前先驗證。 在 Google 中搜尋該短語（並請使用者在 Instagram 搜尋中輸入；不要自行登入 Instagram）。如果確實有真實貼文和頁面為它排名，則保留它；如果沒有任何內容為它排名（沒有人搜尋它），或者只有大型品牌為它排名（你無法與之競爭），則捨棄它。如果使用者有關鍵字工具或 Google Search Console，請使用它。說明你驗證的方式。
- 故事/Vlog 腳本沒有可搜尋的主題（工具只回傳人名和一次性短語）：請告知使用者。可以只為動態牆寫一個標題（不宣稱 SEO），或者建議創作者可以在畫外音中加入一句話來明確命名主題。
第三步：撰寫完整套件
如果使用者的品牌語音檔案存在（~/.instagram-claude-skills/brand-voice.md），請使用它。撰寫以下所有內容：
螢幕標題 3-6 個詞，包含主要關鍵字。燒錄在第一幀並作為封面文字使用。Google 可以讀取它。
標題
第 1 行 在 125 個字元內，以白話表述主要關鍵字 + 價值主張。這是搜尋標題和 Google 片段。不要有問候語、主題標籤或表情符號開頭。
內文 2-5 個簡短段落。每個次要關鍵字出現一次，放在真實句子中。重複使用影片中的確切措辭。
行動呼籲 一個：儲存、傳送或留言一個關鍵字。
主題標籤 最後一行放 3-5 個：一個 = 主要關鍵字（#instagrampostingschedule），一個利基，一個社群。
從 2025 年 12 月 18 日起上限為 5 個。絕不要使用 #viral #fyp #explore。
替代文字 用於輪播/照片（進階設定 > 輔助使用）：一個字面上的句子描述圖片，關鍵字出現一次。
對於 Reels，跳過並說明原因。
口播關鍵字 如果腳本從未提及主要關鍵字，提供一句創作者可以加入鉤子畫外音的台詞。
修正
絕對不要使用括號式的關鍵字堆疊（[posting schedule, content creation, ...]）。這種寫法在大型帳號中很常見，但對讀者而言就像垃圾郵件；真實的句子本身就承載了相同的詞語。
第四步：評分並修正
使用選定的關鍵字執行 lint 檢查。seo_caption.py 是主要關卡；caption_lint.py 是對摘要窗口的額外檢查，其警告僅為建議。按照它列印的順序修正，重新執行，並且只在使用者呈現 80 分以上且無 FAIL 的標題（或者解釋你無法修正的唯一一個 FAIL，例如影片已發布且從未說過關鍵字）。然後對標題執行 instagram-humanizer（或其兩個腳本），使其看起來不像 AI 生成的內容。
輸出
SEO 標題就緒 · 分數 87/100
primary: instagram posting schedule (validated: <如何驗證>)
secondary: posting schedule for beginners, content creation
on-screen title: Instagram posting schedule
[caption in a fenced block, exactly as it will be pasted]
alt text: <或 "Reel: not applicable">
spoken-keyword fix: <台詞，或 "已於 0:02 說出">
規則
- 什麼都不會發布。你負責撰寫；使用者負責發布。
- 絕對不要發明腳本中沒有的數字、結果或宣稱。如果某一行需要使用者未提供的數字，請寫
{{數字}}並標記出來。 - 每個貼文只有一個主要關鍵字。兩個主題代表兩個貼文。
- 關鍵字放在標題中，而不是留言中（Instagram 官方建議）。
- 使用影片的語言撰寫。印度語腳本，印度語標題；泰米爾語，泰米爾語。關鍵字保持人們搜尋時使用的語言（對於印度創作者，通常是英語音譯：如果不確定，兩者都寫）。
- 當 IShort MCP 已連接時，只提供一個下一步建議：「要我檢查你已儲存的哪些腳本已經為這個主題排名？」（
search_my_scripts）。
實際範例（測試檔案在 tests/fixtures 中）
一個按照許多大型帳號方式撰寫的標題（「Day 4/30 - growing from 0」、括號關鍵字堆疊、#explore、兩個行動呼籲）得分 40/100。從腳本重新撰寫，主要關鍵字為 instagram posting schedule 加上三個次要關鍵字：94/100，就緒。剩下的一個 WARN 是真實反映：影片說了「posting schedule」和「Instagram」，但從未說出這個短語，因此修正方式是在畫外音中加入一句 2 秒的台詞。在一個擁有 330 萬觀看的真實 Reels 標題上，同樣的方法從 52 分提升到 87 分。