ClawHub

Yufluentcn Seo Pro

API key required
Other

Conducts cross-border ecommerce keyword research and provides structured SEO placement reports for Amazon A9/backend, Shopify meta and tags, and TikTok Shop...

Install

openclaw skills install yufluentcn-seo-pro

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 。

层走哪里干什么
OpenClaw 对话Yufluent /v1/chat/completions（同一 tk-*）理解意图、收集种子词/竞品词、调 run.py、解读 JSON
SEO 正式输出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 的目标不是「堆词」，而是 让买家搜索意图与产品事实在平台允许的位置对齐。

买家意图 → 词库分层（核心/长尾/防御）→ 平台投放位 → 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 分栏 + avoid
Shopify谷歌自然搜索 + 站内结构；Meta 影响 CTRmeta_title / meta_description + 集合标签 + 博客选题
TikTok Shop站内搜索 + 内容场域；标签与短视频 Hooksearch_keywords + hashtag + video_hook_keywords

同一产品在三平台 词可翻译/本地化，但不可机械照搬（例如 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) 怎么写

做法说明
最少 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. 调用（必须 — 云端）： 
    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 配件

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。

版本记录

版本日期变更
v0.3.02026-05-28补充方法论、关键词策略、平台投放与工作流
v0.2.0—Harness seo_keywords 三平台 JSON 报告
v0.1.0—初始云端薄客户端