技能介绍

要解决什么问题

在 Etsy 上选品或改 listing 时，你往往需要同时看价格区间、变体结构、标题/描述长度、关键词分布以及几家店铺的定价差异。手工打开多个 etsy.com/listing/ 页面抄数据，既慢又难做横向对比；若已有爬虫或导出工具产生的 CSV，也缺少统一的统计口径和可分享的报告格式。

技能如何工作

本技能提供两条路径，由输入自动分流：

实时爬取：用户提供一个或多个 listing URL。单链接走单品脚本；2 个及以上链接走批量脚本。流程上从 URL 提取 listing ID，用有界面 Chrome + CDP（默认端口 9222）打开页面，等待 JS 与反爬校验完成后再抓取 HTML，优先解析 JSON-LD（@type: Product），辅以 meta 与页面文本补销量、收藏等非结构化字段，生成 HTML 报告（单品 etsy_report_*.html，批量对比 etsy_compare_*.html），可用 file:/// 预览。
CSV 分析：用户提供符合 Etsy 抓取格式的 CSV。技能读取文件后统计标价、标题/描述字数、店铺、定制选项与 SKU 组合数、定制类型等，并按表格驱动型模板生成批量竞品报告（与 template_report.html 同构），输出保存在 CSV 同目录。

批量 HTML 报告通常包含：核心摘要、竞品对比表、定制选项与定价策略表、关键词词频/分层、描述维度归纳、2～3 个典型竞品深度对比，以及机会与注意事项类模块。

适用边界与注意点

仅针对公开可访问的商品页；不用于绕过付费墙或未授权登录场景。
实时模式依赖本机 Chrome 路径、用户数据目录（Cookie）与 CDP；若被 DataDome 拦截，需非 headless、足够等待时间（文档建议不少于约 18 秒，必要时加长）。
技能文档中的脚本路径、输出目录等为作者环境示例，落地时需按你的机器调整；分析间隔建议 30 秒以上，降低频率限制风险。