seo-ecommerce

電子商務 SEO 分析

全面的產品頁面優化、市集情報與競爭定價分析。可獨立運作（頁面 + 結構化資料），也可搭配 DataForSEO Merchant API 取得即時 Google Shopping 與 Amazon 資料。

指令

指令	用途	需要 DataForSEO？
/seo ecommerce <url>	產品頁面或商店的完整電子商務 SEO 分析	選用
/seo ecommerce products <keyword>	Google Shopping 競爭分析	必要
/seo ecommerce gaps <domain>	關鍵字缺口：自然搜尋 vs Shopping 能見度	必要
/seo ecommerce schema <url>	產品結構化資料驗證與強化	否

---

1. 產品頁面分析（無需 DataForSEO）

擷取並解析任何產品頁面的頁面 SEO 品質。

工作流程

1. claude-seo run render_page.py <url> --mode auto → 原始/渲染後的 HTML
2. claude-seo run parse_html.py --url <url>   → SEO 元素
3. 分析產品專屬訊號（如下）

產品 SEO 檢查清單

標題標籤

• [ ] 包含主要產品關鍵字
• [ ] 包含品牌名稱
• [ ] 少於 60 個字元（避免在搜尋結果中被截斷）
• [ ] 格式：[Product Name] - [Key Feature] | [Brand]

Meta 描述

• [ ] 包含產品關鍵字 + 利益點
• [ ] 包含價格或「起價 $XX」（觸發豐富摘要興趣）
• [ ] 有行動呼籲（立即購買、買、免運）
• [ ] 少於 155 個字元

標題結構

• [ ] 單一 H1 對應主要產品名稱
• [ ] H2 用於：特色、規格、評論、相關產品
• [ ] 不同產品變體間無重複 H1 標籤

產品圖片

• [ ] Alt 文字包含產品名稱 + 區別特徵
• [ ] 檔案名稱具描述性（非 IMG_001.jpg）
• [ ] 提供 WebP 格式（附 JPEG 備援）
• [ ] 每個產品至少 3 張圖片（主圖、細節、情境）
• [ ] 圖片尺寸 >= 800px（符合 Google Shopping 資格）
• [ ] 僅對摺頁以下圖片使用延遲載入

內部連結

• [ ] 麵包屑導覽：首頁 > 分類 > 子分類 > 產品
• [ ] 相關產品區塊（交叉銷售 / 向上銷售）
• [ ] 使用關鍵字豐富的錨點文字連結回分類頁面
• [ ] 評論區塊連結至完整評論頁面（若分開）

內容品質

• [ ] 獨特的產品描述（非複製貼上製造商內容）
• [ ] 產品描述主體字數 >= 200
• [ ] 有規格表（不僅是文字）
• [ ] 頁面上有使用者評論（UGC 訊號）

評分

類別	權重	標準
結構化資料完整性	25%	必要 + 建議的 Product 欄位
標題與 Meta	15%	關鍵字位置、長度、格式
圖片優化	20%	Alt 文字、格式、尺寸、數量
內容品質	20%	獨特描述、規格、評論
內部連結	10%	麵包屑、相關產品、分類
技術	10%	頁面速度、行動裝置渲染、Canonical

---

2. Google Shopping 情報（DataForSEO Merchant API）

來自 Google Shopping 結果的即時競爭分析。

成本防護機制（強制）

每次 Merchant API 呼叫前：

claude-seo run dataforseo_costs.py check merchant_google_products_search

• "status": "approved" -- 繼續
• "status": "needs_approval" -- 顯示成本，詢問使用者
• "status": "blocked" -- 停止，通知使用者

每次呼叫後：

claude-seo run dataforseo_costs.py log merchant_google_products_search <cost>

工作流程

# 產品搜尋：誰以什麼價格賣什麼
claude-seo run dataforseo_merchant.py search "<keyword>" --marketplace google

# 賣家分析：商家評分與主導度
claude-seo run dataforseo_merchant.py sellers "<keyword>"

# 正規化結果以供分析
claude-seo run dataforseo_normalize.py results.json --module merchant

分析輸出

定價情報

• 價格分佈：最小值、最大值、中位數、P25、P75
• 價格離群值（與中位數相差 > 2 個標準差）
• 價格與評分相關性
• 貨幣正規化為美元（或使用者指定）

賣家格局

• 前 10 大賣家（依刊登數）
• 商家評分分佈
• 免運費普及率
• 新賣家 vs 既有賣家

產品刊登品質

• 頂級刊登的標題關鍵字模式
• 平均評分與評論數量基準
• 每則刊登的圖片數量
• 庫存狀態分佈

載入 references/marketplace-endpoints.md 以取得完整 API 參數細節。

---

3. Amazon 市集（DataForSEO）

跨市集情報，比較 Google Shopping 與 Amazon。

成本防護機制（強制）

claude-seo run dataforseo_costs.py check merchant_amazon_products_search

Amazon 端點位於 warn_endpoints 集合中——一律需要使用者核准。

工作流程

# Amazon 產品搜尋
claude-seo run dataforseo_merchant.py search "<keyword>" --marketplace amazon

# 跨市集比較
claude-seo run dataforseo_merchant.py compare "<keyword>"

跨市集報告

指標	Google Shopping	Amazon
平均價格	$	$
中位數評分	X.X	X.X
平均評論數	N	N
頂級賣家佔比	%	%
免運費比例	%	%

---

4. 市集關鍵字缺口

找出自然搜尋與 Shopping 能見度之間的落差。

工作流程

1. 透過 seo-dataforseo 取得自然排名：
   dataforseo_labs_google_ranked_keywords 用於網域
2. 透過 Merchant API 取得 Google Shopping 曝光：
   merchant_google_products_search 用於頂級自然關鍵字
3. 交叉比對結果

缺口類型

缺口類型	意義	行動
僅自然搜尋	有自然排名但無 Shopping 廣告	建立 Google Merchant Center 產品饋送，對這些關鍵字出價
僅 Shopping	有 Shopping 曝光但自然搜尋弱或無	為這些關鍵字建立內容（購買指南、比較頁面）
兩者皆有	兩個管道都有曝光	優化：確保價格一致、強化結構化資料
兩者皆無	兩個管道都無曝光	除非搜尋量高，否則低優先順序

輸出格式

## 關鍵字缺口分析：example.com

### 機會：自然搜尋 → Shopping（12 個關鍵字）
| 關鍵字 | 自然排名 | 搜尋量 | 每次點擊成本 | 建議行動 |
|--------|----------|--------|-------------|---------|

### 機會：Shopping → 自然搜尋（8 個關鍵字）
| 關鍵字 | Shopping 排名 | 搜尋量 | 每次點擊成本 | 所需內容類型 |
|--------|-------------|--------|-------------|-------------|

---

5. 產品結構化資料強化

依據 Google 最新要求驗證並產生 Product 結構化資料。

確認的必要屬性（Google Merchant）

確認的必要欄位為 name、image 和 offers；商家刊登請使用 Offer，而非 AggregateOffer。

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "",
  "image": [""],
  "offers": {
    "@type": "Offer",
    "url": "",
    "priceCurrency": "USD",
    "price": "0.00",
    "availability": "https://schema.org/InStock"
  }
}

建議屬性（強化豐富結果）

• sku -- 產品識別碼
• description、brand、offers.seller -- 建議的上下文欄位
• gtin13 / gtin14 / mpn -- 全球貿易識別碼
• aggregateRating -- 星級評分 + 評論數量
• review -- 個別評論（至少 1 則）
• color、material、size -- 變體屬性
• shippingDetails -- 包含運費與配送時間的 ShippingDetails（也支援透過 ShippingService 設定商家層級運送；運送/退貨可在 Search Console 中設定，無需 Merchant Center 帳戶）
• hasMerchantReturnPolicy -- 包含類型與天數的 MerchantReturnPolicy
• hasAdultConsideration -- 成人導向產品必填（2026-05-20 新增至 Product 變體 / 商家刊登）；Google 搜尋僅支援值 https://schema.org/SexualContentConsideration

驗證規則

1. price 必須是數字字串，而非 "$29.99"（不含貨幣符號）
2. availability 必須使用完整的 Schema.org URL 列舉
3. image 應為陣列，且包含至少 1 張高解析度圖片 URL
4. priceCurrency 必須符合 ISO 4217（USD、EUR、GBP）
5. 若包含 brand，則 brand.name 不得為空或 "N/A"
6. priceValidUntil 中的日期必須符合 ISO 8601
7. 若包含 aggregateRating：ratingValue 和 reviewCount 為必填

結構化資料評分

完整性	分數
所有必要欄位	50/100
+ aggregateRating	65/100
+ sku/gtin/mpn	75/100
+ shippingDetails	85/100
+ merchantReturnPolicy	90/100
+ reviews（3 則以上）	100/100

---

跨技能整合

技能	整合點
seo-schema	委派 Product 結構化資料產生；重複使用驗證邏輯
seo-images	產品圖片稽核（Alt 文字、格式、尺寸），以及 AI 生成產品圖片的 DigitalSourceType: TrainedAlgorithmicMedia IPTC 標籤（Merchant Center 要求）
seo-content	產品描述的 E-E-A-T 與獨特性分析
seo-dataforseo	用於缺口分析的自然關鍵字排名
seo-technical	產品頁面的 Core Web Vitals（主圖 LCP）
seo-google	GSC 索引狀態 + 產品網址的成效資料（非 Merchant Center 產品饋送驗證，該驗證在 Merchant Center / Merchant API 中進行；舊版 Content API for Shopping 將於 2026-08-18 停用）

UCP：通用商務協定（已上線）

Google 發起的開放標準（與 Shopify、Etsy、Wayfair、Target、Walmart 共同開發；支付合作夥伴 Visa/Mastercard/Stripe/Adyen/Amex），讓 AI 代理程式無需一次性整合即可發現、協商並與商家交易。Google 確認第一個參考實作已在搜尋的 AI 模式中用於對話式購物。更廣泛的 Universal Cart 推出細節來自 Google I/O 2026 主題演講報導；未在 Google 自有來源上確認。ucp.dev 列出 2026-04-08 為其基於日期的版本控制方案的最新版本，而非 1.0；兩種整合路徑：Native（預設）和 Embedded（核准商家）。搭配 AP2（據報導正朝向 FIDO 治理發展）。官方來源：developers.google.com/merchant/ucp 和 ucp.dev。

已在 Google Merchant Center 上且有乾淨 Product 結構化資料的商家，可以在 /.well-known/ucp 宣告 UCP 設定檔，列出能力（dev.ucp.shopping.checkout、.fulfillment、.discount）。請參閱 references/ucp-universal-commerce-protocol.md 了解稽核標準、能力範例以及與 AP2（代理付款協定）的關係。

稽核指令

# 探索並驗證 UCP 設定檔
claude-seo run ucp_check.py https://store.example.com --json

# 含端點可達性探測（對每個宣告的能力發送 HEAD 請求）
claude-seo run ucp_check.py https://store.example.com --probe-endpoints --json

腳本回傳：設定檔是否存在、版本、宣告的能力、結構問題（缺少欄位、未知能力 ID），以及（使用 --probe-endpoints 時）每個端點的可達性。SSRF 封鎖的端點會明確回報。缺少設定檔回報為機會，而非失敗。UCP 本身已上線；尚在早期的是廣泛的商家採用。將字面上的 "version": "1.0" 標記為無效（UCP 版本是基於日期的，例如 2026-04-08）。

---

錯誤處理

錯誤	原因	回應
找不到 Product 結構化資料	頁面缺少 JSON-LD	分析頁面內容，產生建議的結構化資料
DataForSEO 憑證缺失	未設定環境變數	在沒有市集資料的情況下執行分析，並註明限制
成本檢查被封鎖	每日預算超標	通知使用者，提供僅限免費的分析
Shopping 結果為空	關鍵字無產品	建議更廣泛的關鍵字，檢查地區設定
Amazon API 逾時	網路/速率限制	使用退避重試，退回僅 Google 分析
無效網址	格式錯誤的輸入	透過 google_auth.validate_url() 驗證，顯示錯誤
非產品頁面	網址為分類/首頁	偵測頁面類型，建議改用 /seo ecommerce schema

---

輸出範本

## 電子商務 SEO 報告：[網址或關鍵字]

### 整體分數：XX/100

### 產品頁面 SEO
- 結構化資料完整性：XX/100
- 標題與 Meta：XX/100
- 圖片優化：XX/100
- 內容品質：XX/100
- 內部連結：XX/100

### 市集情報（若 DataForSEO 可用）
- Google Shopping 刊登數：找到 N 個產品
- 價格範圍：$XX - $XX（中位數：$XX）
- 頂級賣家：[名稱]（XX% 市佔率）
- Amazon 比較：[可用/未檢查]

### 首要建議
1. [關鍵] ...
2. [高] ...
3. [中] ...

要產生 PDF 報告嗎？請使用 `/seo google report`