SEO 組合起點
此技能不直接包含所有規則。確定目標通路後,依序呼叫以下子技能進行組合。
| 子技能 | 涵蓋範圍 |
|---|---|
google-search | Google 爬蟲、索引、標題、摘要、Sitemap、Canonical、網站名稱、AI 功能、垃圾政策、Search Console |
naver-search | Naver 搜尋顧問:Yeti、robots.txt、所有權驗證、Meta·Open Graph、RSS·Sitemap 提交、收集請求、Favicon、垃圾內容 |
structured-data | JSON-LD 範本(Event、Organization/sameAs、WebSite、BreadcrumbList)及 Google·Naver 差異 |
daum-search | Daum(Kakao)搜尋:Daum/Daum-Preview 機器人、搜尋註冊、站長工具 PIN、關聯通路、KakaoTalk 頻道·KakaoMap |
other-search-engines | Bing(Edge·Copilot)、Brave Search(Brave 瀏覽器)、DuckDuckGo、Apple(Safari·Spotlight·Siri) |
ai-crawlers | ChatGPT·Perplexity·Claude·Meta AI·Apple·Google·Bing 的 AI 搜尋·訓練爬蟲政策 |
social-preview | Open Graph、X(Twitter)卡片、KakaoTalk、Meta(Facebook·Instagram·Threads)、Daum 預覽 |
indexnow | 透過 IndexNow 向 Naver·Bing 等通知 URL 變更 |
scaled-pages | 大量產生區域·日期·類別組合頁面時的品質標準(避免內容貧乏頁面·Doorway 頁面) |
browser-compat | Brave 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. 先決定的事項
問題最多三個。能從程式碼得知的不問。
- 目標通路: 搜尋(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)曝光允許為預設,封鎖訓練由營運者決定。
- 網站狀態: 僅有程式碼 / 已部署(有 URL) / 已註冊 Search Console·搜尋顧問。
- 頁面類型: 首頁、列表、詳細(活動·商品·文章)、區域·每月彙整等。如有大量產生的頁面,務必包含
scaled-pages。
2. 組合順序
- 爬蟲·索引基礎(共通): 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)。 - 頁面 Meta: 獨特的
<title>、meta description、og:*、twitter:*、Favicon、html lang。 → 套用google-search§標題·摘要、naver-search§內容標記、social-preview。 - 結構化資料: 符合頁面類型的 JSON-LD。僅使用與可見本文一致的數值。
→ 套用
structured-data。 - AI 搜尋曝光(預設套用): 允許 AI 搜尋·使用者請求爬蟲、WAF·CDN 未封鎖其 IP、檢查 Claude 用的 Brave 索引·Grok 用的 X 貼文。訓練封鎖另行決定,但須通知
Google-Extended·ai-grounding與曝光衝突。 → 套用ai-crawlers。 - 大量頁面品質: 若有組合頁面,檢查索引目標標準與 noindex 標準。
→ 套用
scaled-pages。 - 通知·測量: 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§快取。 - 瀏覽器確認: 在使用者佔比較高的瀏覽器(包括 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)