SEO 关键词研究与投放建议

跨境电商 Amazon / Shopify / TikTok Shop 关键词扩展与字段投放建议。ClawHub / OpenClaw 云端模式 — Harness 在 Yufluent 服务端执行，输出结构化 JSON 报告；本机只需 TOKENAPI_KEY（tk-*）与 requests。

本技能 不连接 Seller Central、不拉取实时搜索量/排名 API；报告基于 Harness 平台规则 + 你提供的种子词/竞品词，由云端业务模型生成，须人工对照后台数据复核后再上架。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw 。

Agent 硬性规则：

1. 禁止用对话模型自行编造完整关键词矩阵（含 priority / placement / reason 的 JSON）。
2. 必须通过 python scripts/run.py ...（或 POST /v1/skills/seo-pro/run）获取输出。
3. 对话模型负责：按下方「关键词策略」补全输入、解释报告、建议下一步（如转 yufluentcn-ecommerce-listing）。
4. 只需 TOKENAPI_KEY，不要要求用户另配厂商 LLM Key。

方法论总览（TokenApi SEO 框架）

跨境 Listing SEO 的目标不是「堆词」，而是 让买家搜索意图与产品事实在平台允许的位置对齐。

买家意图 → 词库分层（核心/长尾/防御）→ 平台投放位 → Listing 正文 → 人工审核上架

1. 搜索意图分层

在收集种子词前，先判断用户处于哪类意图（可混合）：

原则：标题与首屏 bullet 优先 交易型 + 高相关核心词；长尾与场景词进 bullets / 描述 / Backend（Amazon）或集合标签（Shopify）。

2. 词库三层结构（输出应对齐）

Harness 报告将词分为（命名因平台略有差异）：

Amazon 另输出 backend_keywords（仅 Search Terms 字段，不重复标题已用词）。

3. 相关性三角（扩词前自检）

每个候选词需同时满足：

1. 产品事实：材质、功能、尺寸、适用场景与实物一致。
2. 搜索意图：买家搜这个词时，你的详情页能回答他的问题。
3. 平台规则：不侵权、不夸大、不用未授权品牌/医疗宣称（见各平台 policy）。

任一不满足 → 进入 avoid_keywords 或降优先级。

4. 平台差异（方法论，非实时数据）

同一产品在三平台 词可翻译/本地化，但不可机械照搬（例如 Amazon Backend 字节限制与 TikTok 话题习惯不同）。

5. 推荐工作流（与 Listing 协同）

1) yufluentcn-seo-pro  →  JSON 关键词报告（本技能）
2) 人工删改 / 对照广告&搜索词报告（可选）
3) yufluentcn-ecommerce-listing  →  将高优先级词写入标题/五点/描述
4) 上架后 2–4 周  →  用搜索词/业务报告迭代第二轮 seo-pro

先 SEO 后 Listing 可避免正文写完后反复改标题；若用户只要 Listing，仍建议至少提供 3–5 个种子词。

关键词策略说明（Agent 收集输入用）

种子关键词 (--keywords / seed_keywords) 怎么写

种子词 = 扩词 锚点；过宽则报告发散，过窄则长尾不足。

竞品/类目参考词 (--competitor-keywords)

用于模拟「类目头部 Listing 在覆盖什么意图」，不是让你抄袭竞品品牌名。

未提供时 Harness 填「（未提供）」—— 报告仍可用，但长尾与差异化会偏弱。有竞品词时务必传入。

目标市场 (--market / target_market)

影响 语言、拼写、场景与合规（如美国/英国拼写、电压、认证表述）：

• 示例：美国、UK、东南亚-越南、德语区
• 与 --lang 配合：lang=de + market=德国 优于仅设 lang。

优先级（报告内 高/中/低）判定逻辑

Harness 按下列 启发式 标注（非实时搜索量）：

Agent 向用户解释报告时，应说明：「高」= 建议优先人工验证后写入标题，仍需结合卖家后台搜索词报告做最终取舍。

字段投放策略（Amazon A9）

字段投放策略（Shopify）

字段投放策略（TikTok Shop）

avoid_keywords 常见类别

• 竞品注册商标、未授权品牌词
• 平台禁售/受限宣称（疗效、绝对化「第一/best」需有依据）
• 与 SKU 无关的泛流量词（易拉低转化）
• 已在标题重复多次的词（Amazon Backend 不必再填）

Instructions（Agent 工作流）

1. 确认平台：amazon | shopify | tiktok。
2. 按「关键词策略」收集：
   • product（必填）
   • keywords / 种子词（必填，逗号分隔）
   • competitor_keywords（强烈建议）
   • market（跨境时建议）
   • lang：zh|en|es|de|fr|ja
3. 调用（必须 — 云端）：

   python scripts/run.py \
     --product "主动降噪蓝牙耳机" \
     --keywords "无线耳机,降噪,蓝牙5.3,运动,通勤" \
     --competitor-keywords "anc earbuds, wireless earphones sports" \
     --platform amazon \
     --market "美国" \
     --lang zh \
     -o seo-report.json
   

4. 交付：将 JSON 保存或格式化展示；提醒用户对照 Brand Analytics / 广告搜索词 / Shopify Search 做二次筛选。
5. 下一步：_offer yufluentcn-ecommerce-listing，把 primary_keywords 中高优先级词写入 --keywords。
6. 计费：402 余额不足；401 密钥无效。

输出结构（JSON）

平台不同，字段略有差异；均为 合法 JSON（无 markdown 代码块包裹）。

Amazon

• primary_keywords[]：keyword, priority, placement, reason
• long_tail_keywords[]
• backend_keywords[]
• avoid_keywords[]
• summary

Shopify

• primary_keywords[]
• collection_tags[]
• meta_title_suggestion, meta_description_suggestion
• blog_content_ideas[]
• summary

TikTok Shop

• search_keywords[]
• hashtag_suggestions[]
• video_hook_keywords[]
• summary

环境变量

与其他技能联动

触发词

• "关键词研究" / "SEO 优化"
• "Amazon A9" / "Backend Search Terms"
• "Shopify meta title"
• "TikTok 话题标签"
• "长尾词扩展"
• "标题埋词怎么布局"

Examples

Amazon — 3C 配件

python scripts/run.py \
  --product "USB-C 多口充电坞 65W" \
  --keywords "充电坞,USB-C,氮化镓,多设备,旅行" \
  --competitor-keywords "gan charger, usb c charging station" \
  --platform amazon \
  --market "美国" \
  --lang en \
  -o amazon-seo.json

Shopify — 家居

python scripts/run.py \
  --product "北欧实木餐椅" \
  --keywords "餐椅,实木,北欧,餐厅家具" \
  --platform shopify \
  --market "德国" \
  --lang de

TikTok Shop — 美妆

python scripts/run.py \
  --product "维生素C精华液" \
  --keywords "精华,维C,提亮,护肤" \
  --competitor-keywords "vitamin c serum, brightening" \
  --platform tiktok \
  --lang zh

合规声明

• 报告仅供参考，不构成平台排名或流量承诺。
• 禁止建议侵权、虚假宣传或未授权品牌词。
• 上架前须符合目标市场广告与品类合规要求。

更完整的卖家操作说明见 docs/技能-SEO关键词客户指南.md。

版本记录