SuperAPI AI 工具集

etsy-shop-catalog

通用与其它

查看项目

更新于 10-15 20:08

技能介绍

用途:抓取 Etsy 店铺自身店面的商品列表,按页采集,每件商品返回核心字段。输入为 Etsy 店铺 URL(如 https://www.etsy.com/shop/{shop-name})和可选页码,输出分页商品列表。

主要能力:从店铺页面 DOM 提取商品卡片,字段包括 listingId、shopId、title、url、image、salePrice、originalPrice、currency、rating、reviewCount、shopName、isAd、freeShipping、badge、positionIndex,并返回 currentPage、count、nextPageUrl。

使用方式:目标页面需已在浏览器打开,店铺页公开无需登录。若 browser-act 未确认可用,先通过 Skill 工具加载用法。新会话建议先访问 https://www.etsy.com/ 等待稳定,再访问店铺 URL。提取命令:eval "$(python scripts/extract-listings.py)"。分页按返回的 nextPageUrl 逐页跟进,URL 形如 https://www.etsy.com/shop/{shop-name}?ref=items-pagination&page={N}&sort_order=custom,{N} 从 1 开始;count 为 0 或 nextPageUrl 为 null 时终止。

适用场景:批量采集店铺商品目录、价格与评分等公开信息。

限制:可能触发 DataDome 反爬验证,需预热或切换隐身浏览器与代理重试;店铺分区导航可能将目录拆分到多个分区页;首屏渲染商品数可能少于分页页;休假中的店铺可能返回 0 条。批量执行建议单会话串行翻页,页间休眠 3-8 秒,先小规模测试,逐页保存结果以便断点续跑。具体收费、价格与平台支持情况暂未提供。