Community寫作與編輯github.com

shaul1991/seo-orchestrator

多個搜尋、分享與 AI 通路(Google、Naver、Daum/Kakao、Bing、Brave、DuckDuckGo、Apple、X、KakaoTalk、Meta、ChatGPT·Perplexity·Claude 搜尋)一次對齊的 SEO 起點。決定目標通路後,依序組合子技能進行檢查、實作與回報。

seo-orchestrator 是什麼?

這項 AI 代理技能「seo-orchestrator」是 SEO 工作的協調入口點,不自行執行所有檢查,而是根據使用者指定的目標通路(如 Google、Naver、Daum、Bing、Brave、Apple、ChatGPT 等 AI 搜尋、KakaoTalk、X、Meta),動態調用一系列子技能(例如 google-search、naver-search、structured-data、social-preview、indexnow 等)並按固定順序執行。它支援 Claude Code、Cursor 等開發工具,讓 AI 代理能夠自動化處理搜尋引擎最佳化(SEO)任務,例如提交請求「SEO 幫我處理」、「檢查搜尋曝光」、「Google 和 Naver 都要」、「SEO 稽核」或「發布前 SEO 檢查清單」。 此技能的核心價值在於簡化跨通路 SEO 的複雜性:它會先問最多三個關鍵問題(目標通路、網站狀態、頁面類型),然後自動依序完成「爬蟲與索引基礎」、「頁面 Meta 與結構化資料」、「AI 搜尋曝光」、「大量頁面品質」、「提交與測量」以及「瀏覽器相容性」等七大階段。此外,它內建一個無依賴的 Node.js 腳本 `seo-check.mjs`,可用於單頁面的快速標記檢查。報告採用統一的 Markdown 表格格式,並提醒 AI 代理不要虛假填充資料、避免關鍵字堆砌或 cloaking 等違規行為。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/shaul1991/seo-skills/tree/HEAD/skills/seo-orchestrator

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

SEO 組合起點

此技能不直接包含所有規則。確定目標通路後,依序呼叫以下子技能進行組合。

子技能涵蓋範圍
google-searchGoogle 爬蟲、索引、標題、摘要、Sitemap、Canonical、網站名稱、AI 功能、垃圾政策、Search Console
naver-searchNaver 搜尋顧問:Yeti、robots.txt、所有權驗證、Meta·Open Graph、RSS·Sitemap 提交、收集請求、Favicon、垃圾內容
structured-dataJSON-LD 範本(Event、Organization/sameAs、WebSite、BreadcrumbList)及 Google·Naver 差異
daum-searchDaum(Kakao)搜尋:Daum/Daum-Preview 機器人、搜尋註冊、站長工具 PIN、關聯通路、KakaoTalk 頻道·KakaoMap
other-search-enginesBing(Edge·Copilot)、Brave Search(Brave 瀏覽器)、DuckDuckGo、Apple(Safari·Spotlight·Siri)
ai-crawlersChatGPT·Perplexity·Claude·Meta AI·Apple·Google·Bing 的 AI 搜尋·訓練爬蟲政策
social-previewOpen Graph、X(Twitter)卡片、KakaoTalk、Meta(Facebook·Instagram·Threads)、Daum 預覽
indexnow透過 IndexNow 向 Naver·Bing 等通知 URL 變更
scaled-pages大量產生區域·日期·類別組合頁面時的品質標準(避免內容貧乏頁面·Doorway 頁面)
browser-compatBrave Shields·De-AMP、Favicon·theme-color·manifest、各瀏覽器顯示·測量

與其他技能的界線

SEO(發現·索引·顯示·AI 搜尋曝光)由本倉庫負責。性質不同的工作不在此處理,必要時請另外使用該技能。

工作本倉庫其他技能範例
爬蟲·索引·Meta·結構化資料·分享預覽·AI 爬蟲·搜尋引擎註冊✅—
目標用戶·差異化·客戶語言·品牌調性(行銷語境)僅讀取marketingskills product-marketing
要做什麼·主題分組·發布時程(內容規劃)僅讀取marketingskills content-strategy
UI 設計—Impeccable 等
  • 如果專案中有行銷語境文件(例如 .agents/product-marketing.md、PRODUCT.md)或內容計劃,請先讀取,並用於判斷標題·說明文案及要索引的頁面。若無則直接進行。
  • 若同時啟用類似的技術 SEO 檢查技能(例如 marketingskills 的 seo-audit),指示會重疊。請只使用一個。
  • scaled-pages 僅處理「是否要索引產生的頁面」。「要產生哪些頁面」屬於內容規劃範疇。

1. 先決定的事項

問題最多三個。能從程式碼得知的不問。

  1. 目標通路: 搜尋(Google·Naver·Daum·Bing·Brave·Apple)、AI 搜尋(ChatGPT·Perplexity·Claude 等)、分享(KakaoTalk·X·Meta)中哪些重要。預設值:韓國服務則 Google + Naver + Daum + KakaoTalk + X + Meta,AI 搜尋(ChatGPT·Claude·Grok·Gemini·Copilot·Perplexity)曝光允許為預設,封鎖訓練由營運者決定。
  2. 網站狀態: 僅有程式碼 / 已部署(有 URL) / 已註冊 Search Console·搜尋顧問。
  3. 頁面類型: 首頁、列表、詳細(活動·商品·文章)、區域·每月彙整等。如有大量產生的頁面,務必包含 scaled-pages。

2. 組合順序

  1. 爬蟲·索引基礎(共通): robots.txt、HTTP 狀態碼、重新導向、canonical、伺服器 HTML 是否有本文、<a href> 連結、Sitemap。 → 套用 google-search §爬蟲、naver-search §收集、daum-search §機器人、other-search-engines。Googlebot 規則也會影響 Brave·Apple,因此要特別小心。衝突時採用較嚴格的規則(例如 Naver 在擁有權驗證中不支援 JavaScript·meta refresh 重新導向 → 請使用 HTTP 301/302)。
  2. 頁面 Meta: 獨特的 <title>、meta description、og:*、twitter:*、Favicon、html lang。 → 套用 google-search §標題·摘要、naver-search §內容標記、social-preview。
  3. 結構化資料: 符合頁面類型的 JSON-LD。僅使用與可見本文一致的數值。 → 套用 structured-data。
  4. AI 搜尋曝光(預設套用): 允許 AI 搜尋·使用者請求爬蟲、WAF·CDN 未封鎖其 IP、檢查 Claude 用的 Brave 索引·Grok 用的 X 貼文。訓練封鎖另行決定,但須通知 Google-Extended·ai-grounding 與曝光衝突。 → 套用 ai-crawlers。
  5. 大量頁面品質: 若有組合頁面,檢查索引目標標準與 noindex 標準。 → 套用 scaled-pages。
  6. 通知·測量: Google Search Console(提交 Sitemap、URL 檢查)、Naver 搜尋顧問(擁有權驗證、提交 Sitemap·RSS)、IndexNow、分享除錯器。 → 套用 google-search §Search Console、naver-search §站長工具、daum-search §搜尋註冊、other-search-engines §Bing·Brave、indexnow、social-preview §快取。
  7. 瀏覽器確認: 在使用者佔比較高的瀏覽器(包括 Brave Shields)中檢查主要流程·圖示·測量。 → 套用 browser-compat。

3. 自動檢查腳本

若有已部署的 URL 或建置好的 HTML 檔案,請先執行此腳本。位於此技能資料夾的 scripts/seo-check.mjs(無依賴、Node 18+)。<skill 資料夾> 為此 SKILL.md 所在的資料夾。

node <skill 資料夾>/scripts/seo-check.mjs https://example.com/page      # URL(也會檢查 robots.txt·Sitemap 位置)
node <skill 資料夾>/scripts/seo-check.mjs ./out/events/123.html         # 本機 HTML
node <skill 資料夾>/scripts/seo-check.mjs --json https://example.com/   # 機器用輸出

腳本僅檢查單一頁面的標記。無法得知排名·索引狀態·渲染結果。請透過 Search Console·搜尋顧問的 URL 檢查另行確認。

4. 報告格式

## SEO 檢查結果(<URL 或路徑>,<檢查時間>)
| 通路 | 項目 | 狀態 | 依據 | 處理方式 |
| --- | --- | --- | --- | --- |
| 共通 | robots.txt | ✅/⚠️/❌ | 觀察值 | 待辦事項 |
...
### 無法確認的事項
- 例如:實際索引狀態(未連接 Search Console)、KakaoTalk 預覽快取(需登入分享除錯器)
  • 請區分觀察值與推論。不保證結果(如「排名會上升」),因為 Google·Naver 皆明確表示不保證索引·曝光。
  • 本倉庫的規則以 2026-11-04 確認為準。若政策·數值影響判斷,請重新開啟子技能中記載的官方原文。

禁止事項

  • 在結構化資料或 Meta 中放入頁面上不存在的價格·日期·評論·評分
  • 為搜尋曝光而重複關鍵字、隱藏文字、大量產生內容相同的頁面
  • 對不同搜尋引擎提供不同的 HTML(Cloaking)
  • 無依據地將 llms.txt 等 AI 專用檔案宣傳為「必要」(Google 已明確表示 AI 功能不需要額外檔案或標記 — 請參閱 google-search)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能