SEO 关键词研究与投放建议#

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

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

---

快速开始（3 步，60 秒）#

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）#

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

层走哪里干什么OpenClaw 对话Yufluent /v1/chat/completions（同一 tk-*）理解意图、收集种子词/竞品词、调 run.py、解读 JSONSEO 正式输出POST /v1/skills/seo-pro/run（同一 tk-*）Harness seo_keywords → 关键词 JSON 报告

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 的目标不是「堆词」，而是 让买家搜索意图与产品事实在平台允许的位置对齐。

text

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

1. 搜索意图分层#

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

意图类型买家状态词的特征典型用途交易型准备购买品类+属性+规格（如 wireless earbuds noise cancelling）标题、核心 bullet商业型对比选购best / for running / vs / 场景词五点、描述前段信息型了解品类how to / what is描述、A+、博客（Shopify）

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

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

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

层级定义数量预期优先级倾向**核心词 (primary)与 SKU 直接对应、搜索量概念上的「大类词」5–10高 → 标题长尾词 (long_tail)属性/场景/人群/痛点组合10–20中 → bullets / 描述防御/规避 (avoid)**低相关、违规、易误导、竞品品牌若干标注勿用

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

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

每个候选词需同时满足：

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

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

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

平台排序/曝光逻辑（简化）本技能报告侧重AmazonA9：相关性 + 转化 + 文案完整度；标题权重高标题 / 五点 / Backend 分栏 + avoidShopify谷歌自然搜索 + 站内结构；Meta 影响 CTRmeta_title / meta_description + 集合标签 + 博客选题TikTok Shop站内搜索 + 内容场域；标签与短视频 Hooksearch_keywords + hashtag + video_hook_keywords

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

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

text

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

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

---

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

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

做法说明最少 3 个、建议 5–12 个逗号分隔；中英文混排时注明目标 lang结构1 个品类词 + 2–3 个核心属性 + 1–2 个场景/人群词示例（耳机）无线耳机, 降噪, 蓝牙5.3, 运动, 长续航避免仅品牌名、仅形容词（ 好用的）、与 SKU 无关的大词

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

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

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

来源示例写法竞品标题拆词running shoes women cushioned, marathon类目畅销榜前 10 标题高频词粘贴逗号分隔广告搜索词报告（手动）高转化 query 摘录

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

目标市场 ( --market / target_market)#

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

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

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

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

优先级条件（同时参考）建议 placement高核心品类/主属性；交易意图强；适合标题前 80 字符title中长尾、场景、兼容词；可进 bullet 或描述bullets / description低边缘场景、复现词、仅 Backend 有价值的变体backend（Amazon）或集合标签

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

字段投放策略（Amazon A9）#

字段策略要点标题核心高优先级词靠前；不堆砌重复词；遵守类目字数五点每点 1–2 个长尾；覆盖场景/人群/差异化描述补充同义词与场景叙事；避免与五点完全重复Backend Search Terms标题/五点 未出现 的拼写变体、外语、适用型号； 不 重复、不加标点堆砌

字段投放策略（Shopify）#

字段策略要点Title / H1与 meta_title 语义一致，控制约 60 字符内可读Meta description含 1–2 个核心词 + 明确 CTA；约 150–160 字符Collection tags用于集合页与筛选，偏类目与场景Blog ideas承接信息型意图，导流产品集合页

字段投放策略（TikTok Shop）#

字段策略要点Search keywords商品卡与搜索场景；偏口语、短词组Hashtags3–8 个：品类 + 场景 + 活动（无空格）Video hook keywords短视频前 3 秒口播/字幕用词，与主图一致

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. 调用（必须 — 云端）： bash

   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

---

环境变量#

变量必填说明TOKENAPI_KEY是tk-*``TOKENAPI_BASE_URL否默认 http://localhost:8080/v1

---

与其他技能联动#

需求技能将关键词写入完整 Listingyufluentcn-ecommerce-listing评论中的痛点转长尾词yufluentcn-review-intel → 再 seo-pro竞品标题拆词yufluentcn-comp-track → 提取词再 seo-pro落地页广告用语一致yufluentcn-ad-optimize（与 SEO 词分开迭代）

---

触发词#

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

---

Examples#

Amazon — 3C 配件

bash

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 — 家居

bash

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

TikTok Shop — 美妆

bash

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

---

合规声明#

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

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

---

版本记录#

版本日期变更v1.1.02026-06-14SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register linksv0.3.02026-05-28补充方法论、关键词策略、平台投放与工作流v0.2.0—Harness seo_keywords 三平台 JSON 报告v0.1.0—初始云端薄客户端