E-commerce SEO 分析

商品ページの最適化、マーケットプレイス情報、競争価格分析の包括的なソリューション。オンページ + スキーマ検証で単独で機能し、DataForSEO Merchant API でライブの Google Shopping と Amazon データに対応します。

コマンド

コマンド	目的	DataForSEO
/seo ecommerce <url>	商品ページまたはストアの完全な e-commerce SEO 分析	オプション
/seo ecommerce products <keyword>	Google Shopping 競争分析	必須
/seo ecommerce gaps <domain>	キーワードギャップ: オーガニック vs 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 での切り取りなし)
• 形式: [商品名] - [主な特徴] | [ブランド]

メタディスクリプション

• 商品キーワードとメリットを含む
• 価格または「$XX から」を含む (リッチスニペット興味を促進)
• CTA が存在 (購入、今すぐ買う、送料無料など)
• 155 文字以内

見出し構造

• 単一の H1 が主要商品名と一致
• H2: 特徴、仕様、レビュー、関連商品
• 商品バリエーション全体で H1 タグの重複なし

商品画像

• alt テキストに商品名 + 特徴を含む
• ファイル名が説明的 (IMG_001.jpg ではない)
• WebP 形式で提供 (JPEG フォールバック付き)
• 商品あたり最低 3 枚の画像 (ヒーロー、詳細、ライフスタイル)
• 画像サイズ >= 800px (Google Shopping 対象)
• 遅延読み込みは下部折り線の画像のみ

内部リンク

• パンくずナビゲーション: ホーム > カテゴリ > サブカテゴリ > 商品
• 関連商品セクション (クロスセル / アップセル)
• キーワード含有アンカーでカテゴリページへのリンク
• レビューセクションはフルレビューページへのリンク (別ページの場合)

コンテンツ品質

• ユニークな商品説明 (製造元コピペ不可)
• 商品説明本文のワード数 >= 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>

ワークフロー

# 商品検索: 誰が何を何の価格で売るか
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace google

# 販売者分析: 加盟店の評価と支配力
python scripts/dataforseo_merchant.py sellers "<keyword>"

# 分析用に結果を正規化
python scripts/dataforseo_normalize.py results.json --module merchant

分析出力

価格情報

• 価格分布: 最小、最大、中央値、P25、P75
• 価格外れ値 (中央値から > 2 標準偏差)
• 価格と評価の相関
• USD への通貨正規化 (またはユーザー指定)

販売者ランドスケープ

• 上位 10 販売者 (リスト数)
• 加盟店の評価分布
• 送料無料の普及率
• 新規 vs 既設販売者

商品リスト品質

• トップリストのタイトルキーワードパターン
• 平均評価およびレビュー数のベンチマーク
• リストあたりの画像数
• 在庫状況の分布

references/marketplace-endpoints.md を読み込んで、完全な API パラメータを確認してください。

---

3. Amazon マーケットプレイス (DataForSEO)

Google Shopping と Amazon を比較するクロスマーケットプレイス情報。

コスト監視 (必須)

python scripts/dataforseo_costs.py check merchant_amazon_products_search

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

ワークフロー

# Amazon 商品検索
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace amazon

# クロスマーケットプレイス比較
python scripts/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 キーワード)
| キーワード | オーガニック順位 | ボリューム | CPC | 推奨アクション |
|-----------|-----------------|-----------|-----|--------------|

### 機会: Shopping → オーガニック (8 キーワード)
| キーワード | Shopping 順位 | ボリューム | CPC | 必要なコンテンツタイプ |
|-----------|---------------|-----------|-----|-------------------|

---

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 は >= 1 の高解像度画像 URL を持つ配列であるべき
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
+ reviews (3+)	100/100

---

クロススキル統合

スキル	統合ポイント
seo-schema	Product スキーマ生成を委任; 検証ロジックを再利用
seo-images	商品画像監査 (alt テキスト、形式、寸法)
seo-content	商品説明の E-E-A-T とユニーク性分析
seo-dataforseo	ギャップ分析用オーガニックキーワードランキング
seo-technical	商品ページの Core Web Vitals (ヒーロー画像の LCP)
seo-google	GSC 経由 Google Merchant Center フィード検証

---

エラーハンドリング

エラー	原因	対応
Product スキーマが見つからない	ページに JSON-LD がない	ページコンテンツを分析、推奨スキーマを生成
DataForSEO 認証情報がない	環境変数が設定されていない	マーケットプレイスデータなしで分析を実行、制限を記載
コストチェックがブロック	日次予算超過	ユーザーに通知、無料のみの分析を提供
Shopping 結果が空	キーワードに商品がない	より広いキーワードを提案、位置設定を確認
Amazon API タイムアウト	ネットワーク/レート制限	バックオフで再試行、Google のみにフォールバック
無効な URL	形式が不正	google_auth.validate_url() で検証、エラー表示
非商品ページ	URL はカテゴリ/ホームページ	ページタイプを検出、/seo ecommerce schema を提案

---

出力テンプレート

## E-commerce SEO レポート: [URL またはキーワード]

### 総合スコア: XX/100

### 商品ページ SEO
- スキーマ完全性: XX/100
- タイトルとメタ: XX/100
- 画像最適化: XX/100
- コンテンツ品質: XX/100
- 内部リンク: XX/100

### マーケットプレイス情報 (DataForSEO が利用可能な場合)
- Google Shopping リスト: N 件の商品が見つかりました
- 価格範囲: $XX - $XX (中央値: $XX)
- トップ販売者: [名前] (XX% 市場シェア)
- Amazon 比較: [利用可能/未確認]

### トップ推奨事項
1. [重大] ...
2. [高] ...
3. [中] ...

PDF レポートを生成しますか? `/seo google report` を使用