概览
想快速拿到一件 Etsy 商品的完整档案吗?给它一条商品链接,它会把这件商品的标题、售价、原价、店铺与店铺评分、买家评分、评论数量、加购人数、图片、描述和视频一次性取回来,可以直接导出成表格,接进你的选品表或竞品库。
做跨境选品和竞品分析时,最费时的往往是"一件件打开商品页、把价格、评分、销量和图片一张张抄下来"。这份数据按商品链接把详情成倍补齐,图片按顺序一次性给全,适合当作选品评估、竞品上架信息和素材整理的原始底表。
数据说明
商品详情取自 Etsy 的公开商品详情页,一条链接对应一条记录。售价为商品当前售价,含美元符号,多规格商品带「+」表示起售价。原价为商品的划线价,未打折的商品没有这一项。店铺评分是店铺的综合评分,商品评分是这件商品的买家评分,均为 5 分制。评论数量为累计评价条数,加购人数是当前把商品放进购物车的人数,可作近期热度的参考。图片按商品页的顺序最多取 10 张,不足 10 张时后面的图片为空;描述为商品详情页的完整正文。部分商品没有原价或视频。数据为取数当时页面展示的快照,价格与热度会随时间变化。
结果长什么样
每条记录是一件商品:
| 商品标题 | 售价 | 店铺名称 | 商品评分 | 评论数量 |
|---|---|---|---|---|
| Most Peculiar Tee | Beauty and the Beast | Disney World Shirt | Trendy Oversized Disney Shirt | Belle Shirt | Disney Princess | Disneyland | $32.00+ | TheShopBetweenWorlds | 5 | 131 |
| Personalized Heart Initial Necklace, Asymmetrical Heart Pendant, Heart Choker Necklace | 14k Gold Fill, Sterling Silver | LN230_L | $66.00+ | GLDNxLayeredAndLong | 5 | 116 |
另有「原价」「店铺评分」「加购人数」「商品描述」「图片 1–10」「商品视频」等字段。
应用场景
- 做选品评估时,用「商品评分」和「评论数量」先筛出口碑稳的款,再用「加购人数」看它近期是否还在走量。
- 做竞品上架分析时,从「商品描述」拆出卖点和规格,对照自己的 listing 找差距。
- 做素材整理时,把「图片 1–10」批量下载,一次拿到整组商品图,省去逐张保存。
- 做店铺对标时,按「店铺名称」和「店铺评分」归类,看同类商品都出自哪些高评分店铺。
适用边界
单次任务处理 1 个 Etsy 商品详情页链接,每个商品返回一条详情记录;采集条数上限默认 3 条、可上调(越大耗时与费用越高);仅覆盖公开可见的商品详情,部分商品没有原价或视频。
- 适合用于
- 需要按商品链接批量获取 Etsy 商品的标题、价格、店铺、评分与图片等详情时
- 需要给一份竞品商品清单补充详情字段、做选品或竞品分析时
- 不要用于
- 需要按关键词搜索商品列表时——用商品列表类应用
- 需要秒级返回结果时——本应用在后台逐个商品抓取详情,完成时间取决于商品数量
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1部分数据获取是异步返回的:商品较多时,逐个抓取详情会耗时较长、无法立即返回;请耐心等待抓取完成,任务状态显示「运行中」表示仍在采集,并非异常
- 2任务失败属可重试错误,可原样重新提交
- 3返回空结果通常是链接不是 Etsy 商品详情页,或该商品已下架,请核对链接后重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 商品详情页链接
product_url必填string要采集的 Etsy 商品详情页完整链接,例如 https://www.etsy.com/listing/1749972449/ ;请填写真实可访问的商品链接示例https://www.etsy.com/listing/1749972449/ - 采集条数上限
max_collected_rows选填integer本次任务最多采集多少条商品详情,不填默认 3 条,数值越大耗时和费用越高范围1–默认值3
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 商品链接
urlstring该商品详情页链接示例https://www.etsy.com/listing/1749972449/ - 商品标题
product_titlestring商品在详情页展示的完整标题示例Most Peculiar Tee | Beauty and the Beast | Disney World Shirt | Trendy Oversized Disney Shirt | Belle Shirt | Disney Princess | Disneyland - 售价
pricestring商品当前售价,含美元符号;多规格商品可能带「+」表示起售价示例$32.00+ - 原价
original_pricestring商品划线原价,含美元符号,未打折的商品没有示例$38.00
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"url": "https://www.etsy.com/listing/1749972449/",
"product_title": "Most Peculiar Tee | Beauty and the Beast | Disney World Shirt | Trendy Oversized Disney Shirt | Belle Shirt | Disney Princess | Disneyland",
"price": "$32.00+",
"original_price": "$38.00",
"seller": "TheShopBetweenWorlds",
"seller_rating": "4.8",
"rating": "5",
"review_count": "131",
"in_cart_count": "62",
"quantity": "13015",
"description": "Most Peculiar Tee | Beauty and the Beast | Disney World Shirt | Trendy Oversized Disney Shirt | Belle Shirt | Disney Princess | Disneyland Shirt\n\nA part of our I Want Song collection, this tee celebrates the iconic song Belle (Reprise)! Inspired by the ultra trendy, minimalist designs of all the Disney Parks cool girls, this design takes that vibe and infuses it with some princess magic. This collection is inspired by the iconic \"I Want\" songs in Disney music. A must have for any Belle or Beauty and the Beast fan!!\n\nThe soft-washed, garment-dyed fabric brings extra coziness to your wardrobe while the relaxed fit makes it an excellent daily choice.",
"video": "https://v.etsystatic.com/video/upload/v1/listing/1749972449/video.mp4",
"image_1": "https://i.etsystatic.com/6178568/r/il/3fc30f/6632679049/il_fullxfull.6632679049_cduu.jpg",
"image_2": "https://i.etsystatic.com/6178568/r/il/43d71a/6584561106/il_fullxfull.6584561106_oaku.jpg",
"image_3": "https://i.etsystatic.com/6178568/r/il/cb3fb3/6584561108/il_fullxfull.6584561108_doxf.jpg",
"image_4": "https://i.etsystatic.com/6178568/r/il/4b0713/6632678155/il_fullxfull.6632678155_4mib.jpg",
"image_5": "https://i.etsystatic.com/6178568/r/il/4f8bd7/6632678159/il_fullxfull.6632678159_gvzp.jpg",
"image_6": "https://i.etsystatic.com/6178568/r/il/090d26/6584561104/il_fullxfull.6584561104_y4ua.jpg",
"image_7": "https://i.etsystatic.com/6178568/r/il/f5cdd7/6584561110/il_fullxfull.6584561110_gmqd.jpg",
"image_8": "https://i.etsystatic.com/6178568/r/il/b907b3/6077509130/il_fullxfull.6077509130_lr2i.jpg",
"image_9": "https://i.etsystatic.com/6178568/r/il/2c8f1a/6632678161/il_fullxfull.6632678161_9k3m.jpg",
"image_10": "https://i.etsystatic.com/6178568/r/il/7e4b90/6584561112/il_fullxfull.6584561112_p2nw.jpg"
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=WW_Yang/etsy-product-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。