siluzan-tso-cli 1.1.18 → 1.1.19-beta.2

package/dist/skill/references/google-ads-rules/google-ads-landing-page-discovery-via-webfetch.md

@@ -0,0 +1,72 @@
+# 通过页面抓取推断产品详情页 / 列表页（内部指引）
+
+> **用途**：在制定 **Google 搜索广告**投放方案时，用户只提供官网根域名或泛首页，需要为广告组推荐**更合适的最终到达网址**（优先 **PDP 产品详情页**，其次 **PLP 产品列表/分类页**）。本流程说明助手侧如何用 **webfetch**（或等价的「抓取公开 HTML」能力）分析站点结构，**不向终端用户复述工具名称或技术细节**——对用户只输出业务结论与推荐 URL 列表。
+
+> **边界**：仅抓取**用户已授权、可公开访问**的页面；遵守站点 robots 与频率礼貌；若页面主体内容由前端 JS 动态渲染且抓取结果为空，须**停止猜测**，改为请用户提供站点地图、后台导出的商品链接或手动指定落地页。
+
+---
+
+## 何时启用
+
+- 已确认推广网站域名或首页 URL，但**尚未**拿到明确的产品详情链接。
+- `google-ads-launch-plan-template.md` 中「搜索广告方案生成」专项要求为各广告组对齐 **PDP / PLP**，需要补齐 URL。
+
+---
+
+## 推荐流程（按顺序）
+
+### 1. 固定起点 URL
+
+- 使用用户给出的**官网首页**或**主业务落地域名**（含 `https://`）。
+- 若用户给的是短链或跳转链，先解析到稳定的主域首页再抓取。
+
+### 2. 首次抓取（首页）
+
+- 对首页发起 **webfetch**，获取 HTML 正文（或可见文本 + 链接列表，视工具返回而定）。
+- 从结果中收集**站内**链接：`href` 指向同域或已声明的电商子域的路径。
+- 优先关注导航文案含以下语义的链接（多语言站点按实际文案匹配）：`产品`、`商品`、`目录`、`分类`、`商店`、`Shop`、`Products`、`Catalog`、`Collections` 等。
+
+### 3. 抓取候选「列表层」页面
+
+- 对步骤 2 中得到的 **1–3 个**最像「全站产品入口」的 URL 再各做一次 webfetch。
+- 在列表页 HTML 中查找**重复出现的商品卡片链接模式**（同一 DOM 结构下多条 `a[href]` 指向相似路径）。
+- 记录高频路径前缀，例如：`/product/`、`/products/`、`/p/`、`/item/`、`/shop/`、`/collections/.../products/` 等。
+
+### 4. 抽样详情页（PDP）
+
+- 从列表页抽取 **2–5 条**不同类目下的商品链接（避免只抽同一 SP 下的重复款）。
+- 对每条 PDP 再 webfetch 一次，确认：
+  - HTTP 状态为成功（非 404/重定向死链）；
+  - 页面标题或主标题与广告将要推广的产品线一致；
+  - 页面具备**可转化要素**（价格/询价/加购/规格参数/联系方式等至少一类），否则降级为「备选」并在方案中说明风险。
+
+### 5. 输出给投放方案的内容
+
+- **默认落地页**：优先写经确认的 **PDP**；若产品线多、需用一个入口承接，可写 **PLP** 并说明「按意图拆组后各组再换独立 PDP」。
+- **Sitelink / 附加链接**：可将步骤 3 中不同分类 PLP、步骤 4 中代表性 PDP 写入模板「附加链接」表。
+- **不要在用户可见方案中**出现「webfetch」「抓取」「爬虫」等字样；只写「根据贵站公开页面结构，建议使用以下落地页……」类业务表述。
+
+---
+
+## 失败与回退
+
+| 情况                     | 处理                                                                |
+| ------------------------ | ------------------------------------------------------------------- |
+| 首页抓取超时或内容过短   | 请用户提供 **产品列表页直链** 或 **XML/HTML 站点地图** URL。        |
+| 列表页无稳定商品链接模式 | 请客户提供后台导出的 **商品 Feed 链接列** 或任意 **3 条真实 PDP**。 |
+| 全站强依赖登录后可见     | 说明无法代推断；请客户发送**可匿名访问**的示例 PDP/PLP。            |
+| 多语言多域               | 与投放地域、广告语言对齐后，只对**目标域**重复步骤 2–4。            |
+
+---
+
+## 与合规、质量得分的关系
+
+- 最终 URL 必须与广告文案、关键词**主题一致**（参见 `google-ads-compliance.md` 落地页相关章节）。
+- 推断出的 URL 在写入计划前，应用户确认或标注「待客户确认链接有效性」；**勿**将明显测试环境（staging）、带 `noindex` 的占位页作为主推落地页。
+
+---
+
+## 关联文档
+
+- `google-ads-launch-plan-template.md` — 投放计划模板及「搜索广告方案生成」专项表。
+- `google-ads-keyword-strategy.md` — 关键词分层与长尾策略（与落地页意图对齐）。

package/dist/skill/references/google-ads-rules/google-ads-launch-plan-template.md

@@ -41,6 +41,15 @@
 | 潜在客户表单（Lead Form）        | 0     | **线索类 B2B 可 1 套**                   | 在 Google Ads 后台配置；CLI 当前无对应命令时由助手说明后台步骤 |
 | 合规提示下的限制条目（Tier 2/3） | —     | **每条实质限制 2–4 条**                  | 过少易漏项，过多影响可读性                                     |
 
+### 搜索广告方案生成（Google · 搜索广告）
+
+**适用**：媒体为 **Google**、广告类型为 **搜索广告**、场景为 **搜索广告投放方案 / 计划生成**（含 AI 填表与向用户确认前的草案）。除上表与模板正文外，须满足下表；**落地页 URL 仅靠域名无法对齐时**，助手侧可按 `references/google-ads-rules/google-ads-landing-page-discovery-via-webfetch.md` 用 **webfetch** 分析公开页面结构以推断 **PDP / PLP**（对用户说明只用业务语言，不暴露工具名）。
+
+| 需求         | 优化方案                                                                                                                                                                                                                                                                                                                                                                  | 原因                                                                                        |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| 广告的落地页 | **优先推荐**产品**详情页（PDP）**；若无独立 PDP 或需承接多 SKU，可推荐**产品列表/分类页（PLP）**。不做「必须用 PDP」的硬性一刀切，但须在计划正文（尤其 3.2 默认落地页、3.3 各广告组、RSA 最终到达网址）中**写明每个 URL 的角色**（PDP / PLP）及与产品线、关键词意图的对应关系。仅首页/公司介绍页不足以作为高意图组主落地页时，须尝试按上文独立文档流程补全 PDP/PLP 候选。 | 搜索流量购买意图强；**详情页**内容与广告/关键词一致度高，通常更利于**质量得分**与**转化**。 |
+| 广告关键词   | 在核心词、词组与完全匹配之外，**显式增加长尾词**：含**型号、规格、材质、场景、用途、地域、行业细分、问题型**等修饰；建议每组正向词中 **长尾意图词占比约 30–50%**（可与泛词分属不同广告组以保持组内意图一致）。数量仍须满足上表「每广告组 20–30 条推荐」区间，**避免**仅用少量头部词占位。                                                                                 | 方案生成阶段易出现**词量少、偏泛词**；长尾可覆盖细分意图、改善匹配质量并便于否定词迭代。    |
+
 ---
 
 ## 模板正文
@@ -122,19 +131,19 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 | 出价策略（次月） | {{如：近 30 天满 30 个目标转化后，切换为目标每次转化费用 tCPA = $X}}                             | {{同逻辑或单独写 tCPA}}                                                                      | {{…}}              |
 | 广告轮换         | 优先展示效果最佳的广告                                                                           | 同左                                                                                         | 同左               |
 
-> **落地页**：各系列默认 URL 在下方广告组/创意节中按组填写；若全账户统一落地页，可在本表下增加一行「默认落地页 | {{URL}}」。
+> **落地页（搜索方案）**：**优先**各广告组使用 **产品详情页（PDP）** URL；若无 PDP 则使用 **产品列表/分类页（PLP）**，并在表中标注与关键词意图的对应关系。若用户仅提供首页，助手侧推断 PDP/PLP 的流程见 `references/google-ads-rules/google-ads-landing-page-discovery-via-webfetch.md`。各系列默认 URL 仍在下方广告组/创意节中按组填写；若全账户统一落地页，可在本表下增加一行「默认落地页 | {{URL}}（PDP/PLP）」。
 
 ---
 
 ### 3.3 广告组（Ad Group）与关键词矩阵
 
-**原则**：每一个广告组内的关键词**意图必须高度一致**，广告文案与落地页与意图对齐，**质量得分（Quality Score）**才容易拉高。匹配符号：`[完全]`、`"词组"`、广泛无括号。
+**原则**：每一个广告组内的关键词**意图必须高度一致**，广告文案与落地页与意图对齐，**质量得分（Quality Score）**才容易拉高。匹配符号：`[完全]`、`"词组"`、广泛无括号。**搜索广告方案生成**时须在每组中补足**长尾词**（参见文首「搜索广告方案生成」专项表），与头词、词组、完全匹配分层搭配，避免整组仅为短泛词。
 
 #### 系列 1：{{系列名称}}
 
 | 广告组名称    | 核心关键词（带匹配符号）                                      | 对应搜索意图   | 建议基准出价 (CPC) |
 | ------------- | ------------------------------------------------------------- | -------------- | ------------------ |
-| {{AG 1 名称}} | {{`"词1"` / `[词2]` / 广泛词 …，补足 10–20 条时在组下列全表}} | {{意图一句话}} | {{币种区间或定额}} |
+| {{AG 1 名称}} | {{`"词1"` / `[词2]` / 广泛词 …，补足 20–30 条时在组下列全表（须含长尾，见文首专项）}} | {{意图一句话}} | {{币种区间或定额}} |
 | {{AG 2 名称}} | {{…}}                                                         | {{…}}          | {{…}}              |
 
 （每个广告组下可再拆「关键词」子表：| 关键词 | 匹配类型 | 格式 |，列满推荐条数，勿停留在 3 条示例。）
@@ -383,18 +392,18 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
 
 在生成计划前，至少确认以下信息（缺失则向用户询问）：
 
-| 必须 | 信息                             | 用途                                                  |
-| ---- | -------------------------------- | ----------------------------------------------------- |
-| ✅   | 广告账户 ID                      | 关联投放账户（执行时由助手使用，勿向用户解释命令行）  |
-| ✅   | 推广的产品/服务                  | 决定关键词和文案方向                                  |
-| ✅   | 目标（线索/销售/曝光）           | 决定系列类型和出价策略                                |
-| ✅   | 月度预算                         | 计算日预算、系列数量与 3.2 表各列预算                 |
-| ✅   | 投放地域                         | 地域定向与地域 ID                                     |
-| ✅   | 落地页 URL                       | 落地页与最终到达网址                                  |
-| 建议 | 客服电话、邮箱或联系页 URL       | **CALL** 与「邮件/联系」**Sitelink**                  |
-| 建议 | 目标 CPA、首月最高 CPC、转化门槛 | **Manual CPC / Max Clicks / tCPA** 切换条件（见下表） |
-| 建议 | 竞品/行业背景                    | 关键词矩阵与否定词包                                  |
-| 建议 | 已有投放数据                     | 优化起点                                              |
+| 必须 | 信息                             | 用途                                                                                                                            |
+| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| ✅   | 广告账户 ID                      | 关联投放账户（执行时由助手使用，勿向用户解释命令行）                                                                            |
+| ✅   | 推广的产品/服务                  | 决定关键词和文案方向                                                                                                            |
+| ✅   | 目标（线索/销售/曝光）           | 决定系列类型和出价策略                                                                                                          |
+| ✅   | 月度预算                         | 计算日预算、系列数量与 3.2 表各列预算                                                                                           |
+| ✅   | 投放地域                         | 地域定向与地域 ID                                                                                                               |
+| ✅   | 落地页 URL                       | 最终到达网址；**搜索方案优先 PDP，其次 PLP**（参见文首专项表；可配合 `google-ads-landing-page-discovery-via-webfetch.md` 推断） |
+| 建议 | 客服电话、邮箱或联系页 URL       | **CALL** 与「邮件/联系」**Sitelink**                                                                                            |
+| 建议 | 目标 CPA、首月最高 CPC、转化门槛 | **Manual CPC / Max Clicks / tCPA** 切换条件（见下表）                                                                           |
+| 建议 | 竞品/行业背景                    | 关键词矩阵与否定词包                                                                                                            |
+| 建议 | 已有投放数据                     | 优化起点                                                                                                                        |
 
 ### 字段填充规则
 
@@ -404,7 +413,7 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
 | 系列命名           | 遵循 `[类型]_[目标]_[定向]_[地域]_[匹配]` 规范（参考 `google-ads-campaign-optimization.md` 2.1 节）；可与业务名并用（如「B2B 源头寻源」）                                                                                                          |
 | 出价策略（首月）   | **产品默认**：核心系列用 **Manual CPC**，且**关闭 eCPC**，写明建议 CPC 上限区间；测流/爆款系列可用 **Maximize Clicks + 最高 CPC**；与 `TARGET_SPEND` 等等价映射以实际 CLI/API 可选值为准时在助手侧转换，**用户可见正文始终用 Google Ads 界面用语** |
 | 出价策略（次月）   | **产品默认**：近 **30 天满 30 个**约定转化（如表单）后切换 **tCPA**；无足够数据则延续人工或 Max Clicks 并写明条件                                                                                                                                  |
-| 关键词（每广告组） | **组内意图高度一致**；**最少 5、推荐 10–20**；`[完全]` / `"词组"` / 广泛分层（`google-ads-keyword-strategy.md`）                                                                                                                                   |
+| 关键词（每广告组） | **组内意图高度一致**；**最少 5、推荐 10–20**（与文首一览表 20–30 条推荐对齐时以一览表为准）；`[完全]` / `"词组"` / 广泛分层（`google-ads-keyword-strategy.md`）；**搜索方案生成须含足量长尾词**（文首「搜索广告方案生成」专项）                    |
 | 否定词             | **账户级 5 类词包**填满模板表；系列级补充 5–10 条；上线后搜索词**每日**迭代                                                                                                                                                                        |
 | RSA                | **12–15** 标题、**4** 描述；**至少 H1、H2 与 D1** 在表中标注【固定📌】及目标位置与理由；字符合规见第十一章字数≤30                                                                                                                                  |
 | 附加信息           | Sitelink **6–8**（可含 OEM/验厂/报价/目录/联系）；Callout **6–8**；Snippet **≥1 组、每组 ≥4 值**；**Lead Form** 线索业务建议填标题与必填字段                                                                                                       |