~/business/shopify-store-leads
Shopify 店铺线索——目录规模、应用与联系方式
带有可用于判断成色的数字的 Shopify 店铺线索：商品数、价格区间、主题、已安装应用、上新节奏与商务联系方式。既可按筛选条件发现新店铺，也可为你已有的域名做富集。
线索数据
TypeScriptCheerio
全球
分类business / 线索数据
语言TypeScript
技术栈TypeScript, Cheerio
市场全球
输出干净、RAG 就绪的 JSON
核心特性
目录规模、价格区间与商品类型——不只是一个域名加邮箱
逐店检测已安装应用与所用主题
上新节奏——每月上新数与距上次上新的天数
既可通过 Shop app 搜索按所售商品找店，也可富集你已有的域名
被筛选条件淘汰的店铺一律不计费
已公开的商务邮箱、电话与社媒账号
在 Shop app 上架的店铺，附带其 Shop app 评分与营业地址
应用场景
- 面向 Shopify 商家的应用、代运营与仓配服务商的 B2B 拓客
- 找出尚未安装竞品应用的店铺
- 按国家、类目与目录规模绘制市场版图
- 为已有域名清单补齐目录与技术栈数据
- 按经营活跃度与价格区间筛选收购标的
- 为电商 AI 构建 DTC 品牌数据集
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
storeUrls | array | 可选 | 要分析的域名——填写后将跳过发现环节 |
query | string | 可选 | 按所售商品找店——在 Shop app 上搜索，此时店铺全部来自该搜索；关闭 useShopApp 或针对你自己的 storeUrls 时，改为匹配店铺名称、简介与域名 |
category | string | 可选 | 商品类目——未填关键词时在 Shop app 上搜索；否则与店铺自有的商品类型匹配 |
countries | array | 可选 | 两位国家代码，例如 US、GB |
minProducts | number | 可选 | 跳过商品数少于该值的店铺 |
activeWithinDays | number | 可选 | 仅保留在此天数内上新过的店铺 |
hasApps | array | 可选 | 仅保留运行这些应用的店铺，按应用 handle 填写 |
excludeApps | array | 可选 | 排除已经在用这些应用的店铺 |
requireEmail | boolean | 可选 | 仅保留公开了商务邮箱的店铺 |
maxItems | number | 可选 | 返回店铺数上限——本次运行的花费硬上限 |
useShopApp | boolean | 可选 | 默认开启：关键词或类目在 Shop app 上搜索，每家店铺附带其 Shop app 评分与营业地址 |
输出示例
1{
2 "url": "https://www.gorjana.com/",
3 "domain": "www.gorjana.com",
4 "myshopifyDomain": "gorjana.myshopify.com",
5 "name": "gorjana",
6 "country": "US",
7 "province": "California",
8 "city": "Laguna Beach",
9 "address": ["3275 Laguna Canyon Rd Ste R1", "Laguna Beach, California 92651", "United States"],
10 "currency": "USD",
11 "catalog": {
12 "productCount": 983,
13 "collectionCount": 575,
14 "priceMin": 3000,
15 "priceMax": 599000,
16 "priceAvg": 17884,
17 "productTypes": ["Anklets", "Bracelets", "Charms", "Earrings", "Gift Cards", "Hand Chains", "Necklaces", "Rings"],
18 "sizeBand": "medium"
19 },
20 "activity": {
21 "daysSinceLastProduct": 1,
22 "isActive": true,
23 "productsPerMonth": 28.9
24 },
25 "theme": { "name": "[RELEASE] 5.2.0", "id": 166571606147 },
26 "apps": [{ "handle": "klaviyo", "name": "Klaviyo" }, { "handle": "okendo", "name": "Okendo" }],
27 "contacts": {
28 "emails": ["customercare@gorjana.com"],
29 "phones": ["8668290030"],
30 "socials": { "instagram": "https://www.instagram.com/gorjana", "tiktok": "https://www.tiktok.com/@gorjana" }
31 },
32 "rating": { "average": 4.81, "ratingCount": 18510, "reviewCount": 4610 },
33 "discoveredVia": "input",
34 "scrapedUTC": 1790214009
35}
有两个约定值得留意：价格是以最小货币单位表示的整数，因此 17884 表示 $178.84；时间戳为 Unix 秒。
使用建议
- productsPerMonth 才是真正的活跃度信号。 它能区分“每月上新 30 款”和“四年里总共上新 30 款”这两种店铺——而 isActive 会把两者都算作活跃。
- maxItems 就是你的花费上限。 它是本次运行可返回、因而可计费的行数硬上限；先确认返回的数据符合预期，再往上调。
- 被淘汰的店铺不花钱。 筛选发生在计费之前，因此严格的筛选组合在被丢弃的店铺上不产生任何费用。
- 把 excludeApps 和 minProducts 组合使用， 即可得到一份“已具规模、但还没买过你这类产品”的潜客名单。
常见问题
可以用在我已经知道的店铺上吗？
可以。把域名填入 storeUrls，发现环节会被完全跳过——你会拿到这些店铺的完整画像。留空则由 Actor 去发现店铺——填了关键词或类目时，店铺来自 Shop app 的搜索。无论哪种方式，你的筛选条件都会生效。
如何找出没有安装竞品应用的店铺？
使用 excludeApps 并填入竞品的应用 handle。再配合 minProducts 与 activeWithinDays，就能得到规模足够、且仍在正常经营、值得接触的店铺。
为什么 policies 有时是空的？
空列表意味着该店铺没有把政策页放在 Shopify 的规范 URL 上，而不是说它没有退款政策。大约八成普通店铺使用规范形式，但多数大型 DTC 品牌并不如此。