~/ecommerce/shopify-scraper
Shopify Scraper——任意商店的商品数据
专业级工具，可从任意 Shopify 商店提取高保真商品数据，包括系列（collections）、搜索与商品推荐。
通用
TypeScriptCheerio
全球
分类ecommerce / 通用
语言TypeScript
技术栈TypeScript, Cheerio
市场全球
输出干净、RAG 就绪的 JSON
核心特性
通用性强——适用于任意基于 Shopify 搭建的商店
支持全店目录提取与搜索
商品推荐（每件商品最多 20 个）
支持系列（collection）与单品抓取
提取标签与分类
货币规范化（价格 ×100）以保证精度
真实的单规格库存数量（可选开启）
订阅计划（selling plans）、订阅制商品与商品视频
条码/GTIN、重量与 B2B 阶梯价
应用场景
- 覆盖任意细分领域 Shopify 商店的市场调研
- DTC 品牌的竞品分析
- 为比价平台聚合商品目录
- 独立电商网站的趋势监控
- 构建商品推荐数据集
- 面向转售商的价格监控
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
startUrls | array | 必填 | Shopify 商店 URL——商品页、系列页或商店首页 |
query | string | 可选 | 用于在商店内查找商品的搜索关键词 |
maxRequestsPerCrawl | number | 可选 | 请求数量上限（默认：100，0 表示不限） |
maxResults | number | 可选 | 达到该商品数后停止（默认：0，即不限） |
maxRecommendationsPerProduct | number | 可选 | 要获取的推荐商品数（默认：0，最大：20） |
grabRealInventory | boolean | 可选 | 在商店公开库存时读取真实的单规格库存数 |
maxInventoryFetches | number | 可选 | 每次运行的库存查询次数上限（默认：200） |
grabStorefrontDetail | boolean | 可选 | 抓取订阅计划、商品视频与 B2B 阶梯价 |
maxStorefrontFetches | number | 可选 | 每次运行的店面详情查询次数上限（默认：200） |
proxy | object | 可选 | 推荐使用住宅代理以获得最佳效果 |
输出示例
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 个推荐，适合用于构建商品关系图谱。