seo-ecommerce

Eコマース SEO 分析

包括的な商品ページ最適化、マーケットプレイスのインテリジェンス、競合価格分析を行います。単独（オンページ＋スキーマ）でも、DataForSEO Merchant API を利用した Google Shopping と Amazon のライブデータ分析でも動作します。

コマンド

コマンド	目的	DataForSEO？
/seo ecommerce <url>	商品ページまたはストアの包括的な Eコマース SEO 分析	任意
/seo ecommerce products <keyword>	Google Shopping の競合分析	必須
/seo ecommerce gaps <domain>	キーワードギャップ：オーガニック検索と Shopping の可視性を比較	必須
/seo ecommerce schema <url>	商品スキーマの検証と拡張	不要

---

1. 商品ページ分析（DataForSEO は不要）

任意の商品ページを取得して解析し、オンページ SEO の品質を確認します。

ワークフロー

1. python scripts/fetch_page.py <url>         → raw HTML
2. python scripts/parse_html.py --url <url>   → SEO elements
3. Analyze product-specific signals (below)

商品 SEO チェックリスト

タイトルタグ

• 主な商品キーワードが含まれている
• ブランド名が含まれている
• 60 文字未満（SERP で省略されない）
• 形式：[Product Name] - [Key Feature] | [Brand]

メタディスクリプション

• 商品キーワード＋メリットが含まれている
• 価格または「XX ドルから」が含まれている（リッチスニペットへの関心を促す）
• 行動喚起が含まれている（今すぐ購入、購入する、送料無料）
• 155 文字未満

見出し構造

• 商品の主な名前と一致する H1 が 1 つだけある
• 特徴、仕様、レビュー、関連商品に H2 を使用している
• 商品バリエーション間で H1 タグが重複していない

商品画像

• alt テキストに商品名と識別できる特徴が含まれている
• ファイル名が内容を適切に表している（IMG_001.jpg ではない）
• WebP 形式で配信されている（JPEG フォールバック付き）
• 商品ごとに画像が 3 枚以上ある（メイン、詳細、使用イメージ）
• Google Shopping の掲載要件を満たす画像サイズ（800px 以上）
• 遅延読み込みはスクロールしないと表示されない画像にのみ適用されている

内部リンク

• パンくずナビゲーション：ホーム > カテゴリ > サブカテゴリ > 商品
• 関連商品セクション（クロスセル／アップセル）
• キーワードを含むアンカーテキストでカテゴリページへ戻るリンクがある
• レビューセクションからレビュー全体のページへリンクしている（別ページがある場合）

コンテンツ品質

• 独自の商品説明がある（メーカーの説明文をそのままコピーしていない）
• 商品説明本文が 200 語以上ある
• 仕様表がある（文章だけではない）
• ページ上にユーザーレビューがある（UGC シグナル）

スコアリング

カテゴリ	重み	基準
スキーマの完全性	25%	必須および推奨される Product フィールド
タイトルとメタ情報	15%	キーワードの配置、長さ、形式
画像の最適化	20%	alt テキスト、形式、サイズ、枚数
コンテンツ品質	20%	独自の商品説明、仕様、レビュー
内部リンク	10%	パンくず、関連商品、カテゴリ
技術面	10%	ページ速度、モバイル表示、canonical

---

2. Google Shopping インテリジェンス（DataForSEO Merchant API）

Google Shopping の検索結果を基に、リアルタイムの競合分析を行います。

コストに関するガードレール（必須）

Merchant API を呼び出す前に、毎回必ず次を実行してください。

python scripts/dataforseo_costs.py check merchant_google_products_search

• "status": "approved" -- 続行します
• "status": "needs_approval" -- コストを提示し、ユーザーに確認します
• "status": "blocked" -- 停止し、ユーザーに通知します

各呼び出しの後：

python scripts/dataforseo_costs.py log merchant_google_products_search <cost>

ワークフロー

# Product search: who sells what at what price
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace google

# Seller analysis: merchant ratings and dominance
python scripts/dataforseo_merchant.py sellers "<keyword>"

# Normalize results for analysis
python scripts/dataforseo_normalize.py results.json --module merchant

分析結果

価格インテリジェンス

• 価格分布：最小、最大、中央値、P25、P75
• 価格の外れ値（中央値から標準偏差 2 つ分を超えるもの）
• 価格と評価の相関
• 米ドル（またはユーザー指定の通貨）への通貨換算

販売者の状況

• 掲載数上位 10 販売者
• 販売者評価の分布
• 送料無料の割合
• 新規販売者と実績のある販売者

商品リスティングの品質

• 上位リスティングにおけるタイトルのキーワードパターン
• 平均評価とレビュー数の基準値
• リスティングごとの画像枚数
• 在庫状況の分布

API パラメーターの詳細については、references/marketplace-endpoints.md を読み込んでください。

---

3. Amazon マーケットプレイス（DataForSEO）

Google Shopping と Amazon を比較し、マーケットプレイスを横断したインテリジェンスを提供します。

コストガードレール（必須）

python scripts/dataforseo_costs.py check merchant_amazon_products_search

Amazon のエンドポイントは warn_endpoints セットに含まれており、常にユーザーの承認が必要です。

ワークフロー

# Amazon product search
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace amazon

# Cross-marketplace comparison
python scripts/dataforseo_merchant.py compare "<keyword>"

マーケットプレイス横断レポート

指標	Google Shopping	Amazon
平均価格	$	$
評価の中央値	X.X	X.X
平均レビュー件数	N	N
上位販売者のシェア	%	%
送料無料の割合	%	%

---

4. マーケットプレイスのキーワードギャップ

オーガニック検索とショッピングでの表示状況の不一致を特定します。

ワークフロー

1. seo-dataforseo を使用してオーガニック検索順位を取得します。 dataforseo_labs_google_ranked_keywords をドメインに対して実行します
2. Merchant API を使用して Google Shopping での掲載状況を取得します。 オーガニック検索上位キーワードに対して merchant_google_products_search を実行します
3. 結果を照合します

ギャップの種類

ギャップの種類	意味	対応
オーガニックのみ	オーガニック検索では順位が付いているが、ショッピング広告がない	Google Merchant Center のフィードを作成し、これらのキーワードに入札します
ショッピングのみ	ショッピングで表示されるが、オーガニック検索では順位が低い、または表示されない	これらのキーワード向けのコンテンツ（購入ガイド、比較ページ）を作成します
両方で表示	両方のチャネルで表示される	最適化します。価格の一貫性を確保し、スキーマを強化します
どちらにも表示されない	どちらにも表示されない	検索ボリュームが多い場合を除き、優先度は低くします

出力形式

## Keyword Gap Analysis: example.com

### Opportunities: Organic → Shopping (12 keywords)
| Keyword | Organic Pos | Volume | CPC | Recommended Action |
|---------|------------|--------|-----|-------------------|

### Opportunities: Shopping → Organic (8 keywords)
| Keyword | Shopping Rank | Volume | CPC | Content Type Needed |
|---------|-------------|--------|-----|-------------------|

---

5. 商品スキーマの強化

Google の最新要件に従って、Product スキーマを検証し、生成します。

必須プロパティ（Google Merchant）

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

推奨プロパティ（リッチリザルトの強化）

• sku -- 商品識別子
• gtin13 / gtin14 / mpn -- グローバル取引商品番号
• aggregateRating -- 星評価とレビュー件数
• review -- 個別レビュー（最低1件）
• color、material、size -- バリエーション属性
• shippingDetails -- 送料と配送時間を含む ShippingDetails
• hasMerchantReturnPolicy -- 種類と日数を含む MerchantReturnPolicy

検証ルール

1. price は数値文字列である必要があります。「$29.99」のように通貨記号を付けてはいけません
2. availability には Schema.org の完全な URL 列挙値を使用する必要があります
3. image は高解像度画像 URL を1件以上含む配列にする必要があります
4. priceCurrency は ISO 4217（USD、EUR、GBP）である必要があります
5. 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
+ レビュー（3件以上）	100/100

---

スキル間連携

スキル	連携ポイント
seo-schema	Product スキーマの生成を委任し、検証ロジックを再利用します
seo-images	商品画像を監査します（代替テキスト、形式、寸法）。さらに、AI 生成の商品画像には IPTC ラベル DigitalSourceType: TrainedAlgorithmicMedia を付与します（Merchant Center の要件）
seo-content	商品説明の E-E-A-T と独自性を分析します
seo-dataforseo	ギャップ分析用にオーガニック検索のキーワード順位を取得します
seo-technical	商品ページの Core Web Vitals（メイン画像の LCP）を確認します
seo-google	GSC を通じて Google Merchant Center のフィードを検証します

UCP — Universal Commerce Protocol（今後に向けて）

Google 主導の標準規格です（Shopify、Etsy、Walmart、Wayfair、Visa、 Mastercard などと共同開発）。個別の連携を構築せずに、AI エージェントが販売者の商品を見つけ、交渉し、取引できるようにします。すでに AI Mode と Gemini からの直接購入を支えています。

Google Merchant Center をすでに利用しており、適切な Product スキーマを設定している販売者は、 /.well-known/ucp に UCP プロファイルを宣言し、機能 （dev.ucp.shopping.checkout、.fulfillment、.discount）を列挙できます。監査基準、 機能の例、AP2（Agent Payments Protocol）との関係については、 references/ucp-universal-commerce-protocol.md を参照してください。

監査コマンド

# Discover and validate the UCP profile
python scripts/ucp_check.py https://store.example.com --json

# With endpoint reachability probes (HEAD each declared capability)
python scripts/ucp_check.py https://store.example.com --probe-endpoints --json

スクリプトは、プロファイルの有無、バージョン、宣言された機能、構造上の問題（フィールドの欠落、不明な機能 ID）を返します。また、--probe-endpoints を指定すると、エンドポイントごとの到達可能性も返します。SSRF によってブロックされたエンドポイントは明示的に報告されます。プロファイルがない場合は、失敗ではなく機会として報告されます。UCP の導入はまだ初期段階です。

---

エラー処理

エラー	原因	対応
Product スキーマが見つからない	ページに JSON-LD がない	ページのコンテンツを分析し、推奨スキーマを生成する
DataForSEO の認証情報がない	環境変数が設定されていない	マーケットプレイスのデータなしで分析を実行し、制約を明記する
コストチェックでブロックされた	1 日の予算を超過した	ユーザーに伝え、無料の分析のみを提案する
Shopping の検索結果が空	キーワードに該当する商品がない	より広いキーワードを提案し、場所の設定を確認する
Amazon API がタイムアウトした	ネットワーク／レート制限	バックオフして再試行し、Google のみを使う方法に切り替える
URL が無効	入力形式が正しくない	google_auth.validate_url() で検証し、エラーを表示する
商品ページではない	URL がカテゴリーページまたはホームページ	ページの種類を検出し、代わりに /seo ecommerce schema を提案する

---

出力テンプレート

## E-commerce SEO Report: [URL or Keyword]

### Overall Score: XX/100

### Product Page SEO
- Schema Completeness: XX/100
- Title & Meta: XX/100
- Image Optimization: XX/100
- Content Quality: XX/100
- Internal Linking: XX/100

### Marketplace Intelligence (if DataForSEO available)
- Google Shopping Listings: N products found
- Price Range: $XX - $XX (median: $XX)
- Top Seller: [name] (XX% market share)
- Amazon Comparison: [available/not checked]

### Top Recommendations
1. [Critical] ...
2. [High] ...
3. [Medium] ...

Generate a PDF report? Use `/seo google report`