# Open SEO Advisor：SEO 健檢與建站顧問：技能書與協作來源

用離線檢查與修復流程，練習搜尋友善的網站技術。

## 工坊收錄說明

內容與行銷

想做網站健檢、修正技術項目或整理搜尋友善內容的人。

一份健檢報告，加上一項經備份流程核對的修復。

在成長與行銷公會練習網站健檢、技術修復與搜尋友善內容。

先讀 QUICKSTART，對自己的原始碼或範例資料夾跑一次離線檢查。

## 封面與來源署名

作者：阿軒哥哥（阿軒割割）

封面插畫：/art/skills/open-seo-advisor.webp

原作者 GitHub：https://github.com/mars-tw/open-seo-advisor-skill

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/open-seo-advisor/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

SEO 健檢 CLI 與建站技能

- 想做網站健檢與搜尋友善內容的人

- 用 coding agent 練習建站的行銷夥伴

## 功能與使用範圍

Apache-2.0。CLI 提供離線網站骨架與技術檢查；完整網站仍需 agent 依品牌實作頁面、內容、功能與圖像。GPT 產圖與託管（Cloudflare、Firebase Hosting、GCP Cloud Run）使用會員自己的帳號，可能產生費用，免費額度須由會員自行查核。兩個線上示範是 noindex 的故事網站，不是搜尋成效。不保證排名、收錄、流量、AI 搜尋引用、銷售或詢問。

- 以 seo-advisor audit consultant 檢查網站技術項目並產出報告

- 以 seo-advisor fix 依計畫、套用與備份處理 sitemap、robots、canonical 或 hreflang

- 以 seo-advisor website init --out ./my-site 產生可預覽的離線骨架；CLI 不產圖、不部署

## 開始前準備

- Python 3.10 以上。Mac／Linux 在專案資料夾執行 ./install.sh，Windows 執行 .\install.ps1。

- 先讀 QUICKSTART.md。沒有自己的網站時，可先用 seo-advisor auto-demo 看範例報告。

- 預設只做分析，不呼叫付費 API，也不改動網站；付費或寫入會先列明細。

## 第一個練習

1. 先讀 QUICKSTART.md。Mac／Linux 執行 ./install.sh，Windows 執行 .\install.ps1，看到「安裝完成！」再繼續。

2. 對自己的網站原始碼執行 seo-advisor audit consultant --source ./my-site，或沒有網站時執行 seo-advisor auto-demo，再讀報告。

3. 依文件先產出修復計畫 seo-advisor fix engineer --source ./site --finding-id SEO-SITEMAP_MISSING-001 --site-url https://example.com，確認後才套用，並保留備份以便 seo-advisor fix rollback。

## 練習成果

一份健檢報告，以及經計畫、套用與備份流程核對過的一項技術修復。

## 原始專案的起步指令

在自己的專案資料夾執行；指令已對照收錄版本的 QUICKSTART.md、README.md 與 docs/modes.md，這次介紹核對沒有代為安裝或執行。

```sh
./install.sh
.\install.ps1
seo-advisor audit consultant --source ./my-site
seo-advisor auto-demo
seo-advisor fix engineer --source ./site --finding-id SEO-SITEMAP_MISSING-001 --site-url https://example.com
```

## 專案與授權

原作 Repo：https://github.com/mars-tw/open-seo-advisor-skill
從原作建立自己的版本：https://github.com/mars-tw/open-seo-advisor-skill/fork
工坊整合參考：https://github.com/mars-tw/open-seo-advisor-skill
記錄的授權：Apache-2.0

## 一起改這本技能書

把回饋、修復、connector、產業設定檔或語言在地化送回阿軒割割的原作，保留作者署名與 Apache-2.0。

原作 Repo：https://github.com/mars-tw/open-seo-advisor-skill
預設 PR 目標：mars-tw/open-seo-advisor-skill:main
從原作建立自己的版本：https://github.com/mars-tw/open-seo-advisor-skill/fork
原作 PR：https://github.com/mars-tw/open-seo-advisor-skill/pulls

工坊整合參考：https://github.com/mars-tw/open-seo-advisor-skill
工坊整合任務專用 Fork：https://github.com/mars-tw/open-seo-advisor-skill/fork
工坊任務：https://github.com/mars-tw/open-seo-advisor-skill/issues
工坊 PR：https://github.com/mars-tw/open-seo-advisor-skill/pulls
GitHub Milestones：https://github.com/mars-tw/open-seo-advisor-skill/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 改善SEO 健檢 CLI 與建站技能的第一個案例 · 建議任務

把回饋、修復、connector、產業設定檔或語言在地化送回阿軒割割的原作，保留作者署名與 Apache-2.0。

- 驗收：一份健檢報告，以及經計畫、套用與備份流程核對過的一項技術修復。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

Agent Skill：/development/skills/open-seo-advisor/SKILL.md
協作 JSON：/api/v1/skills/open-seo-advisor/collaboration

## 參與開發

把回饋、修復、connector、產業設定檔或語言在地化送回阿軒割割的原作，保留作者署名與 Apache-2.0。

工坊 Issue／PR 協調入口：https://github.com/mars-tw/open-seo-advisor-skill/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/mars-tw/open-seo-advisor-skill/blob/f6178d797b45705b5b77f83507366a72eac34bde/README.md
核對日期：2026-10-01
核對版本：f6178d797b45705b5b77f83507366a72eac34bde

- README.md：https://github.com/mars-tw/open-seo-advisor-skill/blob/f6178d797b45705b5b77f83507366a72eac34bde/README.md

- SKILL.md：https://github.com/mars-tw/open-seo-advisor-skill/blob/f6178d797b45705b5b77f83507366a72eac34bde/SKILL.md

- QUICKSTART.md：https://github.com/mars-tw/open-seo-advisor-skill/blob/f6178d797b45705b5b77f83507366a72eac34bde/QUICKSTART.md

- LICENSE：https://github.com/mars-tw/open-seo-advisor-skill/blob/f6178d797b45705b5b77f83507366a72eac34bde/LICENSE

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map