apify-ecommerce

Eコマースデータの抽出

ApifyのEコマーススクレイピングツールを使用して、あらゆるEコマースプラットフォームから商品データ、価格、レビュー、販売者情報を抽出します。

使用する場面

• Eコマースサイトの商品、価格、レビュー、在庫、販売者のデータが必要な場合。
• 価格モニタリング、競合商品の比較、MAPの遵守状況確認、レビュー分析を行う場合。
• マーケットプレイスのデータを抽出して、調査結果を要約するためのガイド付きワークフローが必要な場合。

前提条件

• APIFY_TOKEN を含む .env ファイル（~/.claude/.env に配置）
• Node.js 20.6+（ネイティブの --env-file サポートに必要）

ワークフローの選択

ユーザーのニーズ	ワークフロー	最適な用途
価格の追跡、商品の比較	ワークフロー 1：商品と価格	価格モニタリング、MAP遵守状況の確認、競合分析。インサイトを得るにはAIによる要約を追加します。
レビューの分析（感情または品質）	ワークフロー 2：レビュー	ブランド評価、顧客の感情、品質問題、不具合の傾向
複数のストアから販売者を見つける	ワークフロー 3：販売者	無許可の再販業者、Google Shopping経由の販売者発見

進捗状況の追跡

Task Progress:
- [ ] Step 1: Select workflow and determine data source
- [ ] Step 2: Configure Actor input
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the extraction script
- [ ] Step 5: Summarize results

---

ワークフロー 1：商品と価格

ユースケース： 商品データ、価格、在庫状況を抽出します。競合の価格を追跡し、MAP違反を検出し、商品をベンチマークし、市場を調査します。

最適な対象： 価格アナリスト、プロダクトマネージャー、市場調査担当者。

入力オプション

入力タイプ	フィールド	説明
商品URL	detailsUrls	商品ページの直接URL（オブジェクト形式を使用）
カテゴリURL	listingUrls	カテゴリまたは検索結果ページのURL
キーワード検索	keyword + marketplaces	選択したマーケットプレイスでの検索語句

例 - 商品URL

{
  "detailsUrls": [
    {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
    {"url": "https://www.walmart.com/ip/123456789"}
  ],
  "additionalProperties": true
}

例 - キーワード検索

{
  "keyword": "Samsung Galaxy S24",
  "marketplaces": ["www.amazon.com", "www.walmart.com"],
  "additionalProperties": true,
  "maxProductResults": 50
}

オプション：AIによる要約

AIが生成するインサイトを得るには、以下のフィールドを追加します。

フィールド	説明
fieldsToAnalyze	分析するデータポイント：["name", "offers", "brand", "description"]
customPrompt	カスタム分析指示

AIによる要約の例：

{
  "keyword": "robot vacuum",
  "marketplaces": ["www.amazon.com"],
  "maxProductResults": 50,
  "additionalProperties": true,
  "fieldsToAnalyze": ["name", "offers", "brand"],
  "customPrompt": "Summarize price range and identify top brands"
}

出力フィールド

• name - 商品名
• url - 商品URL
• offers.price - 現在の価格
• offers.priceCurrency - 通貨コード（販売者の地域によって異なる場合があります）
• brand.slogan - ブランド名（オブジェクト内にネストされています）
• image - 商品画像のURL
• additionalProperties: true の場合は、追加の販売者／在庫情報

注： 価格は販売者の地域を反映するため、米国で検索した場合でも、結果の通貨が異なることがあります。

---

ワークフロー 2：カスタマーレビュー

ユースケース： 感情分析、ブランド評価のモニタリング、品質問題の検出のためにレビューを抽出します。

最適な対象： ブランドマネージャー、カスタマーエクスペリエンスチーム、QAチーム、プロダクトマネージャー。

入力オプション

入力タイプ	フィールド	説明
商品URL	reviewListingUrls	レビューを抽出する商品ページ
キーワード検索	keywordReviews + marketplacesReviews	キーワードで商品レビューを検索

例 - 商品からレビューを抽出

{
  "reviewListingUrls": [
    {"url": "https://www.amazon.com/dp/B09V3KXJPB"}
  ],
  "sortReview": "Most recent",
  "additionalReviewProperties": true,
  "maxReviewResults": 500
}

例 - キーワード検索

{
  "keywordReviews": "wireless earbuds",
  "marketplacesReviews": ["www.amazon.com"],
  "sortReview": "Most recent",
  "additionalReviewProperties": true,
  "maxReviewResults": 200
}

並べ替えオプション

• Most recent - 新しいレビューから表示（推奨）
• Most relevant - プラットフォームのデフォルトの関連性順
• Most helpful - 投票数の多いレビュー
• Highest rated - 5つ星のレビューから表示
• Lowest rated - 1つ星のレビューから表示

注： sortReview: "Lowest rated" オプションは、すべてのマーケットプレイスで一貫して機能するとは限りません。品質分析では、大規模なサンプルを収集し、後処理で評価によるフィルタリングを行ってください。

品質分析のヒント

• サンプル数を増やすだけでは統計的有意性や代表的な感情は確立されないため、範囲を定めたサンプリング計画を選びます
• 「壊れた」「不具合」「品質」「返品」など、繰り返し現れるキーワードを探します
• 並べ替えが期待どおりに機能しない場合は、評価で結果をフィルタリングします
• ベンチマークのために競合商品と相互参照します

---

ワークフロー 3：セラーインテリジェンス

ユースケース： 複数のストアからセラーを見つけ、無許可の再販業者を発見し、ベンダーの選択肢を評価します。

最適な対象： ブランド保護チーム、調達担当者、サプライチェーンマネージャー。

注： このワークフローでは、Google Shopping を使用して複数のストアからセラーを見つけます。セラーのプロフィール URL は安定してサポートされていません。

入力設定

{
  "googleShoppingSearchKeyword": "Nike Air Max 90",
  "scrapeSellersFromGoogleShopping": true,
  "countryCode": "us",
  "maxGoogleShoppingSellersPerProduct": 20,
  "maxGoogleShoppingResults": 100
}

オプション

フィールド	説明
googleShoppingSearchKeyword	検索する商品名
scrapeSellersFromGoogleShopping	セラーを抽出するには true に設定します
scrapeProductsFromGoogleShopping	商品の詳細も抽出するには true に設定します
countryCode	対象国（例：us、uk、de）
maxGoogleShoppingSellersPerProduct	商品ごとのセラーの最大数
maxGoogleShoppingResults	結果の合計上限

---

対応マーケットプレイス

Amazon（20以上の地域）

www.amazon.com、www.amazon.co.uk、www.amazon.de、www.amazon.fr、www.amazon.it、www.amazon.es、www.amazon.ca、www.amazon.com.au、www.amazon.co.jp、www.amazon.in、www.amazon.com.br、www.amazon.com.mx、www.amazon.nl、www.amazon.pl、www.amazon.se、www.amazon.ae、www.amazon.sa、www.amazon.sg、www.amazon.com.tr、www.amazon.eg

米国の主要小売業者

www.walmart.com、www.costco.com、www.costco.ca、www.homedepot.com

欧州の小売業者

allegro.pl、allegro.cz、allegro.sk、www.alza.cz、www.alza.sk、www.alza.de、www.alza.at、www.alza.hu、www.kaufland.de、www.kaufland.pl、www.kaufland.cz、www.kaufland.sk、www.kaufland.at、www.kaufland.fr、www.kaufland.it、www.cdiscount.com

IKEA（40以上の国／言語の組み合わせ）

複数の言語オプションがある、主要な IKEA の各地域サイトに対応しています。

Google Shopping

複数のストアを対象にセラーを探す場合に使用します。

---

抽出の実行

ステップ 1：スキルのパスを設定する

SKILL_PATH=~/.claude/skills/apify-ecommerce

ステップ 2：スクリプトを実行する

すぐに回答を表示（チャットに表示）：

node --env-file="$HOME/.claude/.env" "$SKILL_PATH/reference/scripts/run_actor.js" \
  --actor "apify/e-commerce-scraping-tool" \
  --input 'JSON_INPUT'

CSV にエクスポート：

node --env-file="$HOME/.claude/.env" "$SKILL_PATH/reference/scripts/run_actor.js" \
  --actor "apify/e-commerce-scraping-tool" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_filename.csv \
  --format csv

JSON にエクスポート：

node --env-file="$HOME/.claude/.env" "$SKILL_PATH/reference/scripts/run_actor.js" \
  --actor "apify/e-commerce-scraping-tool" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_filename.json \
  --format json

ステップ 3：結果を要約する

以下を報告します：

• 抽出した項目数
• ファイルの保存場所（エクスポートした場合）
• ワークフローに基づく主な知見：
  • 商品： 価格帯、外れ値、MAP 違反
  • レビュー： 平均評価、センチメントの傾向、品質上の問題
  • セラー： セラー数、見つかったセラー候補。正規販売店かどうかの確認には、別途ブランド／契約に関する証拠が必要です

---

エラー処理

エラー	解決策
APIFY_TOKEN not found	~/.claude/.env に APIFY_TOKEN=your_token が含まれていることを確認してください
Actor not found	Actor ID が apify/e-commerce-scraping-tool であることを確認してください
Run FAILED	エラー出力に記載された Apify コンソールのリンクを確認してください
Timeout	maxProductResults を減らすか、--timeout を増やしてください
No results	URL が有効で、アクセス可能であることを確認してください
Invalid marketplace	マーケットプレイスの値が、対応リストと完全に一致することを確認してください

制限事項

• タスクが上記の説明の範囲に明確に当てはまる場合に限り、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、成功条件が不足している場合は、停止して確認を求めてください。

Actor の実行時には入力がアップロードされ、プロバイダーへの料金が発生します。事前に、確認済みの正確な Actor／ビルド、許可されたサイト／データ、結果／料金の上限、保持期間を確認してください。現在の入力／出力スキーマを調べ、一覧にあるすべてのマーケットプレイスに対応していると思い込まないでください。このランナーが1回の応答で取得するレコードは最大10,000件です。完全なページネーション付きエクスポートには対応しておらず、表示される5件はプレビューにすぎません。エクスポートでは取得したフィールド値が保持され、上書きは拒否されます。新しい非公開のパスを選択してください。機密性の高い Actor 入力をコマンド引数や公開ログに含めないでください。ローカルでの待機タイムアウトは、リモート実行をキャンセルするものでも、失敗を証明するものでもありません。実行 ID を控え、ステータスを確認して整合性を取り、重複して実行しないでください。POST 後に予期しない HTTP エラーが発生した場合でも、すでに課金対象の実行が存在している可能性があります。Apify authenticationを参照してください。