Claude Code x 部落格架設(五)：用 Skills 打造 SEO 自動健檢
AI 文章延伸
選擇平台後可直接帶入閱讀脈絡，快速整理重點、補齊盲點，並延伸到同站相關文章。
上一篇我們把 SEO 的基本功做完了——meta 標籤、sitemap、Open Graph、Cloudflare Web Analytics、Google Search Console，全部設定到位。理論上，Google 應該知道你在這裡了。
經營了一陣子之後，發現都沒有什麼人來造訪嗎？於是我們設計了一個 Skills 來幫你檢查這些問題。
這篇會帶你走過我們協助客戶時遇到的真實情境：明明 SEO 都設定好了，搜尋自己的關鍵字卻完全找不到自己的網站。然後一步步診斷，找出問題、修正問題，最後把整個檢查流程包裝成一個 Claude Code Skill，讓以後只要打一句話就能跑完全套健檢。
搜尋自己的關鍵字，結果找不到自己
這種情況比你想像中常見。部落格寫了十幾篇文章，打開 Google 搜尋自己主攻的關鍵字，翻了三頁——沒有你，換個關鍵字再試，翻了五頁——還是沒有。
明明文章都有被 Google 收錄（用 site:你的網址 搜尋確認過），Search Console 也提交了 sitemap，但就是搜不到。
問題出在哪裡？
用數據說話：常見的四個 SEO 地雷
光猜不夠，你可以請 Claude Code 幫忙做一次全面診斷。用 Google Search Console 的數據（我們在上一篇已經串接好了），再搭配 DataforSEO 之類的 SEO 分析工具，通常會發現以下這些問題。
地雷一：首頁標題太短
還記得上一篇講的 title 標籤嗎？很多人設定的時候只填了網站名稱，比如「My Blog」三個字。Google 看到這個標題，完全不知道這個網站在做什麼——它不會通靈，你得明確告訴它。
好的首頁 title 要包含你的核心主題和關鍵字，長度建議 30 到 60 字元。比如：
不好： My Blog
好： My Blog | Claude Code 教學 · Astro 架站 · 前端開發筆記
差別在於後者直接告訴 Google 和搜尋者，這個網站在講什麼。
地雷二：文章描述只是複製標題
上一篇我們特別強調了 meta description 的重要性，但實際檢查的時候，很多部落格的 description 就是把標題再寫一次，等於在 Google 搜尋結果上，標題和描述講的是同一句話。
比如一篇叫「第一次安裝 Claude Code 就上手」的文章，description 也是「第一次安裝 Claude Code 就上手」。搜尋者看到這種結果，完全不知道點進去會看到什麼內容，自然不會想點。
另一個常見的陷阱是 Astro 的 frontmatter 欄位名稱寫錯——寫了 metaDescription 但 Astro 的 schema 定義是 description，結果系統根本沒讀到，等於白寫。
地雷三：頁面內容太薄
SEO 分析工具會檢查一個叫「content rate」的指標——頁面上純文字佔整體 HTML 的比例。如果你的首頁只有幾十個字的純文字，content rate 低於 1%，Google 會直接判定為「低品質頁面」，不值得排名。
最容易中招的是首頁和各種「封面頁」——這些頁面通常以視覺設計為主，文字內容很少。解法是加上一段摘要文字，讓 Google 有足夠的內容可以索引。
地雷四：被轉載的文章搶走了你的排名
如果你的文章被其他網站全文轉載，Google 遇到兩個網站有一模一樣的內容時，會選擇權重比較高的那個當「正本」。對方的網域權重如果遠高於你，Google 就會把他們的版本當正本，你的原文反而被壓下去。
這不是 SEO 設定能解決的問題，但值得知道——如果未來有人要轉載你的文章，記得請他們加上 <link rel="canonical"> 指回你的原文網址，告訴 Google 誰才是原作者。
檢查完一輪之後的問題
假設你用 Claude Code 跑完一次診斷，花了一兩個小時把問題修完——改首頁 title、補上缺少的 description、在內容太薄的頁面加上摘要段落。
然後呢？這些檢查項目，下次還得再做一遍嗎？
每次寫完新文章，都要手動去確認 description 有沒有寫、title 長度夠不夠、Google 有沒有正確收錄。這些事情每一件都不難，但全部加起來就是一個繁瑣的清單，更麻煩的是，你不會記得每次都要檢查。
於是我們想：能不能把這整套檢查流程包裝起來，以後一句話就能跑完？
Skills 是什麼？
如果你有跟著這個系列一路做下來，你已經跟 Claude Code 說過很多次話了——「幫我設定 meta 標籤」「幫我安裝 sitemap 套件」「幫我加上 Open Graph」，每一次，你都要從頭解釋你要做什麼。
Skill 就是把這些指令打包成一個可以重複使用的「技能包」。
延續這個系列的比喻：你的部落格是一間店，前幾篇我們蓋好了店面、掛上了招牌、裝了計數器。但每次要「巡店」的時候——招牌還在嗎、門口有沒有東西擋住、燈有沒有亮——你都要自己列一張清單，從頭檢查一遍。Skill 就是那張寫好的巡店清單，你把所有該檢查的項目寫成一份文件，以後只要說一句「巡店」，Claude Code 就會照著清單一項一項幫你跑完。
技術上來說，一個 Skill 就是一個 Markdown 檔案，裡面寫著：
- 什麼時候要啟動——觸發條件的描述
- 要做什麼事——具體的步驟和指令
- 怎麼呈現結果——輸出的格式
放在正確的位置之後，你就可以用 /skill名稱 的方式呼叫它，或者在對話中描述你的需求，Claude Code 會自動判斷要不要啟用這個 Skill。
Skill 放在哪裡？
Skill 檔案的存放位置有兩種：
專案層級——放在你的部落格專案裡，只有在這個專案中才能用：
你的專案/.claude/skills/skill名稱/skill.md全域層級——放在你的使用者目錄，任何專案都能用：
~/.claude/skills/skill名稱/skill.mdSEO 健檢這種工具，不管在哪個專案都可能用到，所以我們放在全域層級。
設計 SEO 健檢 Skill
知道了 Skill 的概念之後，接下來是設計我們的 SEO 健檢 Skill。
在手動診斷的過程中，我們發現有效的 SEO 檢查需要從三個不同的角度來看：
- 搜尋引擎怎麼看你——Google Search Console 的數據
- 訪客的實際行為——Cloudflare Web Analytics 的流量數據
- 頁面本身的體質——On-page SEO 分析
這三個資料來源各自回答不同的問題，合在一起才能看到全貌。如果繼續用店面的比喻：第一個是站在馬路上看有多少人經過你的店門口（搜尋曝光），第二個是進到店裡數人頭、看他們走了哪些動線（流量），第三個是檢查你的招牌夠不夠大、櫥窗有沒有擺東西、門口有沒有障礙物（頁面體質）。只看其中一個，你會漏掉真正的問題。
Skill 的五步流程
根據手動診斷的經驗，我們把整個健檢流程拆成五個步驟：
第一步：看 Google 怎麼說（Search Console 數據）
從 Google Search Console 拉出最近一週的搜尋數據：哪些關鍵字帶來了曝光、有多少人點擊、平均排名在第幾位，這一步回答的問題是：「Google 到底有沒有在推薦你的文章？」
如果曝光數不錯但點擊率很低，通常代表你的標題和描述不夠吸引人，如果連曝光都沒有，代表 Google 根本沒把你的文章排進搜尋結果。
第二步：看訪客怎麼來（Cloudflare Web Analytics）
拉出最近七天的流量數據：每天多少人來、最多人看的是哪幾頁、訪客從哪裡來（Google 搜尋、社群連結、還是直接輸入網址），這一步回答的問題是：「有人來嗎？他們怎麼找到你的？」
如果大部分流量都來自「Direct」（直接輸入網址），代表你的 SEO 還沒有起效果，來的都是已經知道你的人。
第三步：檢查每一頁的體質（On-Page 分析）
對首頁、重要頁面和最新幾篇文章做逐頁檢查：title 長度夠不夠、description 有沒有寫、頁面載入速度快不快、純文字內容夠不夠多，這一步回答的問題是：「你的頁面本身有沒有問題？」
前面提到的首頁內容太薄、description 複製標題，都是在這一步被抓出來的。
第四步：看搜尋排名（SERP 分析）
查詢你的目標關鍵字，看看你的網站有沒有出現在搜尋結果前 30 名，順便看看排在前面的競爭者是誰，這一步回答的問題是：「你跟別人比起來排在哪裡？」
比如你主攻「台北甜點推薦」這個關鍵字，查下去發現前三名是愛食記、窩客島和 Google 地圖——全部都是高權重平台。知道競爭者是誰，才能決定要正面對決還是換一組長尾關鍵字切入。
第五步：站內快速掃描
直接檢查所有文章的 frontmatter，看有沒有文章忘了寫 description。這是最簡單的一步，但也是最容易被忽略的——你以為每篇都有寫，結果一查發現一半都沒有。
寫成 Skill 檔案
把這五個步驟寫進一個 skill.md 檔案，結構長這樣：
---
name: seo-audit
description: |
對你的網站執行全面 SEO 健康檢查。
當你提到 SEO 檢查、網站健檢、搜尋排名分析時觸發。
---
# SEO Audit：網站全面健康檢查
## 使用方式
- `/seo-audit` — 執行完整檢查
- `/seo-audit https://你的網址/某篇文章/` — 針對特定頁面
## 審計流程
### 第一步：收集 Search Console 數據
（具體的查詢指令和要提取的數據欄位）
### 第二步：收集流量數據
（具體的查詢指令和要提取的數據欄位）
### 第三步：On-Page 分析
（要檢查哪些項目、每個項目的標準是什麼）
### 第四步：SERP 排名檢查
（用什麼關鍵字查、查多深）
### 第五步：站內快速掃描
（檢查 frontmatter 的腳本）
## 報告格式
（結果要用什麼格式呈現）重點是每一步都要寫清楚「做什麼」和「怎麼判斷好壞」。比如 title 長度，我們寫了「建議 30-60 字元」；content rate 寫了「低於 10% 視為過低」；純文字字數寫了「低於 300 字視為薄內容」。
有了這些明確的標準，Claude Code 才能幫你做出有意義的判斷，而不是只丟一堆數字給你。
實際執行的效果
Skill 建好之後，在 Claude Code 裡打 /seo-audit，它就會自動跑完五個步驟，最後產出一份結構化的報告，長得像這樣：
# SEO 健康檢查報告
## 搜尋表現總覽
| 指標 | 數值 |
|-----------|-------|
| 週總點擊 | 45 |
| 週總曝光 | 1,200 |
| 平均 CTR | 3.7% |
## 問題清單
🔴 首頁 title 過短（8 字元，建議 30-60）
🔴 3 篇文章缺少 meta description
🟡 關於頁面純文字只有 42 字
🟢 所有頁面都有 canonical 標籤
🟢 Sitemap 正常提交
## 待修正項目
1. 修改首頁 title，加入核心服務關鍵字
2. 補上缺少的 meta description
3. 在電子書封面頁加入摘要段落紅色代表嚴重問題、黃色是建議改善、綠色是正常，一眼就能看出哪裡需要處理。
以前要花兩個小時手動做的事，現在一句話、三分鐘跑完，而且因為每次跑的檢查項目都一樣，不會因為你忘了某個步驟而漏掉問題。
你也可以做一個簡化版
我們的 SEO 健檢 Skill 整合了三個外部數據來源，設定上比較複雜，但你完全可以做一個簡化版，只做「站內檢查」——不需要任何外部工具，只靠 Claude Code 讀取你的專案檔案就能完成。
在你的部落格專案裡建一個檔案：
你的專案/.claude/skills/seo-check/skill.md內容這樣寫：
---
name: seo-check
description: |
檢查部落格文章的 SEO 基本設定。
當提到 SEO 檢查、文章檢查時觸發。
---
# SEO 基本檢查
檢查所有文章的 frontmatter，找出以下問題：
1. 沒有 description 欄位的文章
2. description 和 title 內容完全相同的文章
3. title 超過 60 字元或少於 10 字元的文章
4. description 超過 160 字元或少於 50 字元的文章
輸出格式：
- 先列出有問題的文章和具體問題
- 再列出通過檢查的文章數量
- 最後給一個總結：X 篇有問題 / Y 篇正常存檔之後，在 Claude Code 裡打 /seo-check，它就會自動去讀你的文章檔案，幫你找出哪些文章的 SEO 設定有問題。
這個簡化版不需要 Search Console 也不需要任何外部 API，但已經能抓到最常見的問題——尤其是「忘了寫 description」這種低級但致命的失誤。
進階：加上更多檢查
等你用習慣了，可以慢慢往 Skill 裡加入更多檢查項目，比如：
- 檢查有沒有圖片缺少 alt text
- 檢查文章字數是否低於 300 字（薄內容）
- 檢查內部連結有沒有指向不存在的頁面
- 檢查 frontmatter 的日期格式是否正確
每加一個檢查項目，就是多一道安全網。你不需要一次到位，先從最基本的開始，之後每次發現新問題就把它加進去。
回到整個系列
從第一篇的基礎概念開始，這五篇文章帶你走過了完整的流程：
- 搞懂 Astro、Git、Cloudflare — 認識工具
- 安裝 Astro 與 Git 存檔 — 建立專案
- 部署上線與自訂網域 — 讓全世界看到
- SEO 設定與流量追蹤 — 讓搜尋引擎找到你
- SEO 自動健檢（本篇）— 持續追蹤和改善
前四篇是「把東西蓋好」，這一篇是「定期回來巡一下」。
SEO 不是做完一次就結束的事。每寫一篇新文章，就多一個需要檢查的頁面。Google 的演算法會變，競爭對手也在持續產出內容，有了自動健檢的工具，至少你不用再靠記憶力來維護這些事情——打一句話，三分鐘後就知道哪裡需要處理。
剩下的，就是持續寫好每一篇文章。工具幫你顧好技術面，但真正決定排名的，還是你的內容有沒有價值。
延伸思考
這篇文章的建議建立在幾個前提上，值得進一步思考：
- 健檢只能抓到「技術設定層」的問題——domain authority 不夠、反向連結太少、內容缺乏差異化，這些不是跑一次
/seo-audit就能解決的。技術面全部綠燈，排名還是可能上不去 - 新站前幾個月，三維度交叉比對的價值有限——GSC 數據接近零、流量也很低，此時與其看報表，不如專注在頁面體質這一個維度就好
其他領域也有類似的模式：
- 軟體工程的 CI/CD linting——每次部署前自動跑一套程式碼品質檢查，跟 SEO 健檢本質上是同一件事：「內容上線前的自動化品管」
- 知識管理的外化過程——把「我知道 SEO 該查什麼」寫成 Skill 文件，就是把隱性知識轉化為顯性知識。一旦寫成文件，這份知識就不再依賴個人記憶，可以被任何人複用
常見問題
Claude Code 的 Skills 需要會寫程式才能做嗎？
不需要。Skill 檔案就是一個 Markdown 文字檔，你只要用日常語言描述「要做什麼」和「怎麼判斷結果」就好。Claude Code 會自己決定怎麼執行，你甚至可以請 Claude Code 幫你寫 Skill——跟它說你想自動化什麼流程，它會幫你產生 skill.md 的內容。
SEO 健檢多久做一次比較好？
建議每寫完一批文章（比如三到五篇）或每個月做一次。不需要每天檢查，重點是養成「定期回頭看」的習慣，而不是等到發現流量掉了才去找原因。如果你有在追蹤 Google Search Console 的數據，每週掃一眼曝光和點擊的趨勢就夠了。
文章的 meta description 怎麼寫比較好？
用 50 到 76 個中文字，清楚描述這篇文章能給讀者什麼。不要只是複製標題，而是回答「讀者為什麼要點進來看」這個問題，好的 description 像是電影預告——讓人知道大概在講什麼，但又好奇到想看完整版。記得包含你希望這篇文章被搜到的關鍵字。
Google 偏好來源
喜歡我們的內容嗎？一鍵將我們設為偏好來源，未來在 Google 焦點新聞與 AI 概覽中就能優先看到我們的文章。