SuperAPI AI 工具集

linkfox-etsy-product-detail

通用与其它

查看项目

更新于 10-16 06:23

技能介绍

用途:根据一个 Etsy 商品直链获取该 Listing 的当前公开详情,面向商品调研与竞品页面核查,而非关键词搜索或批量筛选。

主要能力:返回分组的结构化公开页面数据,包括 productId/productUrl、标题与描述、主图与图片列表、price/lowPrice/highPrice/oldPrice、币种、maxQuantity 与变体、类目面包屑、发货国家、预计送达区间、店铺信息(shopId/shopName/shopUrl/shopSales/yearsOnEtsy 等)、评论数与星级、店铺评论数、买家反馈标签频率及动态评分细分。仅返回聚合评论信号,不含单条买家评价。

使用方式:输入必须是 Etsy 公开 HTTPS 商品链接,路径为 /listing/<数字ID> 或加一段 slug,可带末尾斜杠与查询串;搜索页、店铺页、非 Etsy 域名或无数字 ID 的链接无效。每次仅查一个 Listing。可通过 API 端点 POST /etsy/product/detail 调用,或运行 python scripts/etsy_product_detail.py '<JSON 参数>',加 --inline 可强制全量输出。响应默认落盘到 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件:≤8 KB 完整打印,>8 KB 仅输出摘要,建议先用摘要判断,再用 jq 或 ConvertFrom-Json 按需抽取字段。

限制:公开页面结构变化可能导致字段缺失、为空或偶尔误识别;star、价格、送达估计、店铺元数据与徽章并非每个 Listing 都有;不提供历史价格、Etsy 关键词排名或销量保证;不支持单条评论获取与情感分析,也不支持搜索、店铺操作或订单管理。认证或算力异常(未配置 LINKFOX_AGENT_API_KEY/LINKFOXAGENT_API_KEY、401/402、余额不足提示)需按 references/onboarding.md 处理。每次调用消耗 6 算力,同一会话同一参数默认只调用一次,脚本有 24h 本地缓存;重复查询其他 Listing 分别计费,继续调用前应告知用户额外消耗。