~/ecommerce/shopify-scraper
Shopify Scraper — あらゆるストアの商品データを取得
Shopifyを利用するあらゆるストアから、コレクション・検索・商品レコメンデーションを含む高精度な商品データを抽出するプロフェッショナル品質のツールです。
総合
TypeScriptCheerio
グローバル
カテゴリecommerce / 総合
言語TypeScript
スタックTypeScript, Cheerio
マーケットグローバル
出力クリーンでRAG対応のJSON
主な機能
汎用性 — Shopifyを利用するあらゆるストアで動作
ストア全体のカタログ抽出と検索に対応
商品レコメンデーション（商品ごとに最大20件）
コレクションおよび個別商品のスクレイピング
タグとカテゴリの抽出
精度確保のための通貨正規化（価格を100倍）
バリエーション単位の実在庫数（オプション）
販売プラン・定期購入・商品動画
バーコード/GTIN、重量、B2B のボリューム価格
活用例
- あらゆるニッチのShopifyストアを対象とした市場調査
- DTCブランド向けの競合分析
- 比較プラットフォーム向けの商品カタログ集約
- 独立系ECストア全体のトレンドモニタリング
- 商品レコメンデーションデータセットの構築
- リセラー向けの価格モニタリング
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
startUrls | array | 必須 | ShopifyストアのURL — 商品ページ、コレクション、またはストアのトップページ |
query | string | 任意 | ストア内で商品を検索するための検索クエリ |
maxRequestsPerCrawl | number | 任意 | リクエスト上限（既定：100、0 は無制限） |
maxResults | number | 任意 | この商品数に達したら停止（既定：0＝無制限） |
maxRecommendationsPerProduct | number | 任意 | 取得するレコメンデーション商品数（デフォルト：0、最大：20） |
grabRealInventory | boolean | 任意 | ストアが在庫を公開している場合、バリエーション単位の実在庫を取得 |
maxInventoryFetches | number | 任意 | 1 回の実行あたりの在庫取得上限（既定：200） |
grabStorefrontDetail | boolean | 任意 | 販売プラン・動画・B2B ボリューム価格を取得 |
maxStorefrontFetches | number | 任意 | 1 回の実行あたりのストアフロント詳細取得上限（既定：200） |
proxy | object | 任意 | 最良の結果を得るにはレジデンシャルプロキシを推奨 |
Output Example
1{
2 "source": {
3 "id": "8286776623232",
4 "canonicalUrl": "https://kith.com/products/khm034601-004",
5 "retailer": "Kith",
6 "language": "en",
7 "currency": "USD"
8 },
9 "brand": "Kith",
10 "title": "Kith Garment-Dyed Paneled Donovan Tee - Shadow",
11 "description": "<p>Moisture-wicking recycled polyester</p><p>Garment-dyed</p><p>Ribbed neckline</p>…",
12 "categories": ["Long Sleeve Tees"],
13 "tags": ["apparel", "k-tech", "…"],
14 "options": [
15 {
16 "type": "Size",
17 "values": [
18 { "id": "XS", "name": "XS" },
19 { "id": "S", "name": "S" }
20 ]
21 }
22 ],
23 "variants": [
24 {
25 "id": "45144565416064",
26 "title": "XS",
27 "sku": "2000292008",
28 "options": ["XS"],
29 "price": { "current": 13000, "previous": 0, "stockStatus": "InStock" },
30 "requiresShipping": true,
31 "taxable": true,
32 "weightGrams": 381
33 }
34 ],
35 "medias": [
36 { "id": "41607480410240", "type": "Image", "url": "https://cdn.shopify.com/s/files/1/0094/2252/files/KHM034601-004-Detail.jpg?v=1789500153", "variantIds": [], "alt": "" }
37 ]
38}
よくある質問
どのShopifyストアでも使えますか？
はい、Shopifyを利用しているストアであればどこでも動作します。全ストアで共通のShopify標準の商品データ構造を活用しています。
特定の商品を検索できますか？
はい、queryパラメータを使えば特定のストア内を検索できます。カタログ全体をスクレイピングせずに特定の商品タイプを探すのに便利です。
商品レコメンデーションはどのように抽出されますか？
maxRecommendationsPerProductを設定すると、関連商品を取得できます。商品ごとに最大20件のレコメンデーションが取得可能で、商品グラフの構築に役立ちます。