# 故意做壞小店網頁：免費檢查工具 claude-seo 抓得出幾個錯

- 網址：https://blog.valenvan.uk/posts/agricidaniel-claude-seo.html
- 發布日期：2026-11-03
- 測試設備：Mac mini M4 Pro（12 核、64GB）
- 專案：AgriciDaniel/claude-seo（https://github.com/AgriciDaniel/claude-seo），MIT 授權
- 測試版本：claude-seo（2026-11-03 取得的最新版）
- 實測影片：https://www.youtube.com/watch?v=AjB64XucJbI

## 重點摘要

- claude-seo 的 fetch_page.py 不讓直接檢查本機網址（127.0.0.1），還沒上線的草稿要先存成 HTML 檔，改用 parse_html.py 讀檔。
- 對自製、故意做壞的網頁，parse_html.py 列出標題只有「首頁」、沒有說明與 canonical、2 個 H1、2 張圖沒有 alt。
- content_quality.py 對只有兩三句的頁面給 70/100，同時旗標 low-density、thin-content（內容單薄）。
- schema_generate.py 的預約資料在實測中 reservationStatus 為 ReservationConfirmed，參數沒有狀態選項。
- **結論：** 自己做小店網頁的人可以先用它的腳本掃基本毛病，但分數要連警告一起看。
- **適合：** 自己做小店或個人網站、想先掃基本毛病的人
- **不適合：** 想一鍵得到完整 SEO 報告的人

| 實測項目 | 結果 |
|---|---|
| 測試頁 | 自製故意做壞的店家首頁 |
| fetch_page 對 127.0.0.1 | Blocked hostname |
| H1 數量（壞→補完） | 2→1 |
| 圖片無 alt（壞→補完） | 2/2→0/1 |
| content_quality | 70/100，low-density、thin-content |
| 未測 | README 宣稱的完整審核流程、需金鑰的腳本、真實網站 |

你開了一間烘焙店，自己做了個網頁，Google 卻怎麼搜都搜不到，也不知道毛病出在哪。最近有個叫 claude-seo 的免費專案很熱，一週多了四千多顆星，說它能幫網頁找毛病。但它找得準不準？我的做法很像出考卷：先自己做一個「已知有錯」的網頁，再看工具能不能把錯找出來。如果連我故意放的錯都找不到，就不必信它。

測試設備：Mac mini M4 Pro（12 核、64GB）。專案：AgriciDaniel/claude-seo，MIT 授權。

## 它是什麼、我測了哪一塊

claude-seo 本身是 Claude Code 的外掛，README 說給它任何網站，10 到 15 分鐘就能跑完整審核。那個完整流程要在 Claude Code 裡用模型跑，**我沒測**。我測的是它 `scripts/` 資料夾裡可以單獨執行的 Python 腳本：`parse_html.py`（讀網頁，列出標題、說明等基本欄位）、`content_quality.py`（替內容打分）、`fetch_page.py`（上網抓頁面）、`schema_generate.py`（產生給搜尋引擎看的結構化資料）。

## 出一張有錯的考卷

影片裡的網頁畫面，是依我當時實測記下的欄位值（標題、說明、大標題數、圖片說明數）重建的同款頁面，並另外用獨立程式核對過欄位與實測紀錄一致；工具的輸出與判斷都來自當時的實測，不是重跑。

```html
<!doctype html><html><head><meta charset="utf-8"><title>首頁</title></head>
<body><h1>小春烘焙</h1><h1>今日現烤</h1>
<img src="a.jpg"><img src="b.jpg" alt="">
<p>我們賣手工餅乾與吐司。</p><a href="/menu.html">菜單</a></body></html>
```

我故意放的錯：標題只寫「首頁」（搜尋結果會只顯示這兩個字）、沒有說明文字、沒有 canonical（告訴 Google 哪個才是正式網址的標記）、有兩個 H1（頁面上的大標題，一頁通常只放一個）、兩張圖沒有 alt（圖片說明，看不到圖的人與搜尋引擎靠它理解圖）、內容只有兩三句。

## 實測一：還沒上線的網址不讓直接檢查

我先在自己電腦開了個 `python3 -m http.server`，想用 `fetch_page.py` 直接抓：

```bash
python scripts/fetch_page.py http://127.0.0.1:8000/
# Error: url_safety: Blocked hostname: 127.0.0.1
```

`localhost` 和 `127.0.0.1` 都被擋。這是它的網址安全檢查，用意是避免被拿去打內部網路。所以草稿頁要先存成 HTML 檔，再改用 `parse_html.py` 讀檔。

![被標出毛病的小店網頁：兩個大標題、圖片沒有說明](https://blog.valenvan.uk/img/agricidaniel-claude-seo-article_1.png)

## 實測二：故意放的錯被逐項列出

```bash
python scripts/parse_html.py --json -u https://shop.example.com/ index.html
```

`-u` 是補上網站網址，不給的話站內連結不會被歸類。結果如下，每次執行都在 0.1 秒內完成：

| 項目 | 做壞的網頁 | 補完後 |
|---|---|---|
| 標題 | 首頁 | 小春烘焙｜台南手工餅乾與吐司，每日現烤 |
| 說明文字（meta 描述） | 沒有 | 有 |
| canonical | 沒有 | https://shop.example.com/ |
| 大標題（H1）數量 | 2 | 1 |
| 圖片沒有說明（alt） | 2／2 | 0／1 |

補完的版本我另外存成 `fixed.html` 再跑一次，上表的欄位都到位。

![修好前後的網頁並排，四項毛病都補齊](https://blog.valenvan.uk/img/agricidaniel-claude-seo-article_2.png)

## 實測三：70 分，卻說內容太少

```bash
python scripts/content_quality.py index.html
```

輸出是 Overall quality 70/100，同時旗標寫著 `low-density, thin-content`（資訊密度低、內容單薄）。這頁只有兩三句話。所以看這個工具要連警告一起看，**分數好看不代表內容夠用**。

## 實測四：預約資料的狀態

```bash
python scripts/schema_generate.py reservation --provider 小春烘焙 \
  --start 2026-11-05T15:00 --party-size 2
```

輸出裡 `reservationStatus` 直接是 `https://schema.org/ReservationConfirmed`（已確認）。我查了 `--help`，參數裡沒有狀態可以選。如果你的預約還在等店家確認，要自己改這個欄位。

## 常見問題

- **為什麼 fetch_page 不能抓我自己的電腦？** 它擋掉本機與內部網路位址，草稿請存成檔案給 parse_html。
- **需要裝什麼？** 我在乾淨的 Python 環境裝了 requests、beautifulsoup4、lxml 就能跑這幾支腳本；其他腳本（Google 搜尋、PageSpeed 等）可能要金鑰，我沒測。

## 結論

適合：自己做小店或個人網站、想先掃一遍標題、說明、標準網址、大標題、圖片說明這些基本毛病的人。
不適合：想一鍵得到完整報告的人（完整審核要在 Claude Code 跑，這篇沒測），也別把 content_quality 的分數當成內容夠好的證明。

專案連結：https://github.com/AgriciDaniel/claude-seo（MIT）