Yufluentcn Seo Pro

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

metahuan@metahuan

Install

openclaw skills install @metahuan/yufluentcn-seo-pro

SEO 关键词研究与投放建议

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

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

快速开始（3 步，60 秒）

注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
运行：参照下方 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`、解读 JSON
SEO 正式输出	`POST /v1/skills/seo-pro/run`（同一 tk-*）	Harness `seo_keywords` → 关键词 JSON 报告

Agent 硬性规则：

禁止用对话模型自行编造完整关键词矩阵（含 priority / placement / reason 的 JSON）。
必须通过 python scripts/run.py ...（或 POST /v1/skills/seo-pro/run）获取输出。
对话模型负责：按下方「关键词策略」补全输入、解释报告、建议下一步（如转 yufluentcn-ecommerce-listing）。
只需 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. 相关性三角（扩词前自检）

每个候选词需同时满足：

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

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

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

平台	排序/曝光逻辑（简化）	本技能报告侧重
Amazon	关键词排名（A9/A10 式信号）+ COSMO 语义 + Rufus 发现；标题权重高	标题 / 五点 / Backend + 场景意图自然语言
Shopify	谷歌自然搜索 + 站内结构；Meta 影响 CTR	`meta_title` / `meta_description` + 集合标签 + 博客选题
TikTok Shop	站内搜索 + 内容场域；标签与短视频 Hook	`search_keywords` + `hashtag` + `video_hook_keywords`

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

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

text

1) yufluentcn-seo-pro  →  JSON 关键词报告（含 semantic_intents / buyer_questions）
2) 人工删改 / 对照广告&搜索词报告（可选）
3) yufluentcn-ecommerce-listing  →  将高优先级词 + suggested_copy / answer_hint 写入标题/五点/描述
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：关键词 + 语义意图）

字段	策略要点
标题	核心高优先级词靠前；不堆砌重复词；遵守类目字数；含 1 个清晰场景或人群
五点	每点 1–2 个长尾；覆盖场景/人群/差异化；完整句子便于 COSMO/Rufus 理解
描述	补充同义词与场景叙事；回答买家可能追问的参数/兼容问题
Backend Search Terms	标题/五点未出现的拼写变体、外语、适用型号；不重复、不加标点堆砌

字段投放策略（Shopify）

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

字段投放策略（TikTok Shop）

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

`avoid_keywords` 常见类别

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

Instructions（Agent 工作流）

确认平台：amazon | shopify | tiktok。
按「关键词策略」收集：
- product（必填）
- keywords / 种子词（必填，逗号分隔）
- competitor_keywords（强烈建议）
- market（跨境时建议）
- use_case / 目标人群或场景（Amazon 强烈建议，如 通勤降噪, 运动跑步）
- lang：zh|en|es|de|fr|ja

调用（必须 — 云端）：

bash

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

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

输出结构（JSON）

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

Amazon

primary_keywords[]：keyword, priority, placement, reason
long_tail_keywords[]
semantic_intents[]：intent, suggested_copy, placement, priority（COSMO 场景句）
buyer_questions[]：question, answer_hint, placement（Rufus 问答覆盖）
backend_keywords[]
avoid_keywords[]
summary

Amazon 默认走 Harness 模板 amazon-seo-v2（含语义字段）；显式 template_version: v1 可回退旧版词表模板。

Harness 会对 SEO JSON 输出 质量分（0–10） 并写入 run 记录，维度含词库深度、种子词覆盖、Backend 去重、COSMO/Rufus 语义覆盖等。

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`

与其他技能联动

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

触发词

"关键词研究" / "SEO 优化"
"Amazon 搜索" / "COSMO" / "Rufus" / "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.0	2026-06-14	SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register links
v0.3.0	2026-05-28	补充方法论、关键词策略、平台投放与工作流
v0.2.0	—	Harness `seo_keywords` 三平台 JSON 报告
v0.1.0	—	初始云端薄客户端

Yufluentcn Seo Pro

Install

SEO 关键词研究与投放建议

快速开始（3 步，60 秒）

OpenClaw 与 Yufluent（必读）

方法论总览（TokenApi SEO 框架）

1. 搜索意图分层

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

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

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

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

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

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

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

目标市场 (--market / target_market)

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

字段投放策略（Amazon：关键词 + 语义意图）

字段投放策略（Shopify）

字段投放策略（TikTok Shop）

avoid_keywords 常见类别

Instructions（Agent 工作流）

输出结构（JSON）

Amazon

Shopify

TikTok Shop

环境变量

与其他技能联动

触发词

Examples

合规声明

版本记录

Related skills

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

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

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

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

`avoid_keywords` 常见类别