logo

Shopify 独立站商品

输入 Shopify 店铺、分类或商品链接,返回商品的价格、原价、有货状态、规格、SKU、图片和上架时间

发布者
价格
¥0.003 / 个商品
最近更新
2026-11-08

概览

给出一个或多个 Shopify 独立站的链接,就能拿到店里在售商品的完整清单:每个商品的标题、品牌、类型、标签、描述、售价区间、划线原价、是否有货、全部规格和 SKU、图片,以及创建、上架和最近更新的时间。

大量出海品牌和 DTC 独立站都搭建在 Shopify 上。做选品的团队可以一次拉下竞品店铺的全部商品,看它卖什么、定价多少、哪些在打折;做运营的团队可以定期采集同一家店,跟踪对手的上新、调价和缺货,不用一页页手动翻看。

数据说明

商品来自店铺对外公开的商品目录,内容保持店铺原文,不做翻译。填店铺链接时按店铺目录的默认顺序采集,填分类链接时只采集该分类下的商品;同一次运行中,重复出现的商品只返回一次。

价格是店铺标价,单位见「币种」,不含税费、运费和结账时的优惠券。「原价」只在商品有规格打折时出现,取打折规格里最高的划线价。「是否有货」和「有货规格」是采集那一刻的状态,只能看出有没有货,看不到具体库存数量。

每个商品一条结果,各规格的售价、原价、SKU 和有货情况放在「规格明细」里;「全部规格」「SKU」「有货规格」把同样的信息拼成一行文字,方便在表格里直接查看。

店铺公开商品列表里只有正常上架的商品。店铺隐藏的商品(商品页能打开,但不在列表里)按店铺或分类采集拿不到,需要把商品页链接单独填进来。

不是用 Shopify 搭建的网站、只把 Shopify 用作后台而前台另行开发的店铺,以及关闭了公开商品数据的店铺,都取不到商品。有些品牌的带 www 域名是另行开发的前台,不带 www 的域名才是 Shopify 店铺,遇到这种情况会自动换另一种写法再试,结果里的「店铺域名」是实际取到数据的那个。

每个填写的链接都有交代。取不到商品的链接会返回一行状态,商品字段为空,不计费。「状态」有这几种:ok(商品)、empty(店铺或分类里没有公开商品)、duplicate(与前面的链接重复,或商品已在其他链接的结果里)、invalid_url(链接格式认不出)、not_found(分类或商品不存在)、not_shopify(不是 Shopify 店铺)、blocked(店铺拒绝访问,分不清是关闭了公开数据还是有访问防护)、error(暂时访问不了,可稍后重试)。「状态说明」用一句话写明原因和能不能重试。

结果长什么样

每条结果是一个商品;取不到商品的链接是一行状态,商品字段为空。

所填链接状态商品标题品牌币种最低价原价是否有货有货规格
www.allbirds.comokWomen's Wool Runner - Natural Grey (Light Grey Sole)AllbirdsUSD49110是5
www.allbirds.comokWomen's Cruiser Jersey - True Navy (Blizzard Sole)AllbirdsUSD120是5 / 5.5 / 6 / 6.5 / 7 / 7.5 / 8
www.wikipedia.orgnot_shopify

此外还有状态说明、店铺域名、商品链接、商品类型、标签、商品描述、全部规格、SKU、规格明细、主图、上架时间等字段。

应用场景

  • 竞品定价分析:按「商品类型」分组,比较竞品店铺「最低价」「最高价」的分布,找到主力价格带,作为自己定价的参考。
  • 促销监控:筛出带「原价」的商品,用「原价」和「最低价」算出折扣力度,了解竞品正在主推哪些清仓或促销商品。
  • 上新与缺货跟踪:定期采集同一家店,按「上架时间」找出新品,对比前后两次的「是否有货」和「有货规格」,看哪些款式、尺码卖断了。
  • 选品调研:按「标签」和「商品类型」统计竞品店铺的品类结构,看它在哪些品类上铺货最多。

适用边界

每次最多 20 个链接;每个链接最多返回 10000 个商品,单个店铺或分类公开的商品超过 25000 个时只能取到前 25000 个;按返回的商品数计费,取不到商品的链接只返回一行状态、不计费

  • 适合用于
  • 需要某个 Shopify 独立站的商品清单、价格和有货情况,用于竞品调研或选品
  • 需要定期监控竞品店铺的上新、调价和缺货
  • 不要用于
  • 不知道店铺地址、想按关键词在所有 Shopify 店铺里搜商品:本应用必须提供店铺链接
  • 需要商品的真实库存数量或销量:本应用只能拿到是否有货
  • 店铺不是用 Shopify 搭建的,或只把 Shopify 用作后台、前台另行开发且两种域名写法都不开放商品数据
  • 要采集店铺隐藏的商品(商品页能打开,但不在店铺公开商品列表里):按店铺或分类采集拿不到,需要把这些商品页链接单独填进来

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1每个输入链接都有交代:取到商品的返回商品行(status=ok);取不到的返回一行状态(商品字段为空、计费数量为 0),看 status 和 status_text 决定下一步
  2. 2status=error 是暂时无法访问,可稍后原样重试;blocked(店铺拒绝访问,HTTP 401/403 或设了访问密码)、not_shopify、not_found、empty 重试无效,应核对链接或换别的数据来源;invalid_url 请改成店铺域名或店铺、分类、商品页链接
  3. 3所填域名被拒或不是 Shopify 时,会自动换成带 www 或不带 www 的另一种写法再试,两种都不行才判定取不到;实际取到数据的域名见 store_domain
  4. 4只有所有链接格式都无法识别,或所有链接都暂时无法访问(可重试)时,整次运行才失败;其他情况运行成功,失败原因在状态行里
  5. 5商品数量少于上限属正常情况,说明店铺或分类公开的商品本身较少;同一次运行中重复的商品只返回一次,因重复而没有新商品的链接记为 duplicate

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • Shopify 链接(店铺、分类或商品)store_urls必填array<string>
    要采集的 Shopify 链接,1–20 个。填店铺域名或首页(如 kith.com)采集全店公开商品;填分类页(含 /collections/)只采集该分类;填商品页(含 /products/)只采集这一个商品。店铺隐藏、不在公开商品列表里的商品,需要单独填商品页链接。每个链接都会有交代:取不到商品的链接返回一行状态,不计费。
    数量最多 20 项示例["www.allbirds.com"]
  • 每个链接最多商品数max_products选填integer
    每个店铺或分类链接最多采集多少个商品,范围 1–10000,不填默认 100。商品页链接固定返回 1 个商品。
    范围1–10000默认值100

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 记录编号record_idstring
    每行结果的唯一编号:商品行为商品 ID;未取到商品的状态行为「input:」加所填链接
    示例7366895894608
  • 所填链接input_urlstring
    这一行来自输入里的哪个链接,原样返回,便于与输入逐条对照
    示例www.allbirds.com
  • 状态statusstring
    ok=商品行;以下为未取到商品的状态行(每个链接一行,商品字段为空,不计费):empty=店铺或分类里没有公开商品;duplicate=与前面的输入指向同一处,或商品都已在其他链接的结果中返回;invalid_url=链接格式无法识别;not_found=是 Shopify 店铺,但分类或商品不存在、已下架;not_shopify=带 www 和不带 www 都取不到 Shopify 店铺信息(不是 Shopify,或前台另行开发);blocked=店铺拒绝访问(HTTP 401/403 或设了访问密码),分不清是关闭了公开数据还是有访问防护,重试大概率无效;error=暂时无法访问(超时、HTTP 429/5xx 等),可稍后重试
    示例ok
  • 状态说明status_textstring
    状态的中文说明,写明原因和能否重试
    示例已取到商品

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "record_id": "7366895894608",
  "input_url": "www.allbirds.com",
  "status": "ok",
  "status_text": "已取到商品",
  "billed_products": 1,
  "product_id": "7366895894608",
  "store_domain": "www.allbirds.com",
  "currency": "USD",
  "title": "Women's Wool Runner - Natural Grey (Light Grey Sole)",
  "product_url": "https://www.allbirds.com/products/womens-wool-runners-natural-grey",
  "vendor": "Allbirds",
  "product_type": "Shoes",
  "tags": "<tags>",
  "description": "The Allbirds Wool Runner is the original wool sneaker that started it all.",
  "price_min": 49,
  "price_max": 49,
  "compare_at_price_max": 110,
  "available": true,
  "variant_count": 7,
  "variant_titles": "5 / 6 / 7 / 8 / 9 / 10 / 11",
  "skus": "WR3WNCW050 / WR3WNCW060 / WR3WNCW070 / WR3WNCW080 / WR3WNCW090 / WR3WNCW100 / WR3WNCW110",
  "in_stock_variants": "5",
  "variants": "<variants>",
  "main_image": "https://cdn.shopify.com/s/files/1/1104/4168/files/WR3WNCW_SHOE_LEFT_GLOBAL_WOMENS_WOOL_RUNNER_GREY_LIGHT_GREY_bc7cc3a6-43a0-4dde-8f9e-48a8d80499df.png?v=1779819025",
  "image_urls": "<image_urls>",
  "created_at": "2026-05-26T11:10:21-07:00",
  "published_at": "2026-09-25T16:24:03-07:00",
  "updated_at": "2026-11-03T15:07:59-08:00"
}

调用方式

本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=data_hunter/shopify-products",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

个商品

按输出字段 billed_products 求和计量,任务失败不计费。

¥0.003/ 个商品

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.003 / 个商品