Yufluent 电商 Listing 生成器#

跨境电商多平台 Listing 生成技能。 ClawHub / OpenClaw 用户使用云端模式：Harness 在 Yufluent 服务端执行，本机只需 TOKENAPI_KEY（ tk-*）与 requests。

快速开始（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-*（配置 yufluent 模型提供商 + TOKENAPI_* 环境变量）。接入见 https://claw.changzhiai.com/app/openclaw 。

层走哪里干什么OpenClaw 对话Yufluent /v1/chat/completions（同一 tk-*）理解意图、读本 SKILL、决定调 run.py、整理回复Listing 正式输出POST /v1/skills/listing/run（同一 tk-*）Harness + 平台规则 → 标题/五点/描述text

用户 → OpenClaw（yufluent provider）→ python scripts/run.py → Yufluent API → Harness → Listing 正文

Agent 硬性规则（违反则视为未正确使用本技能）：

1. 禁止 用对话模型自行撰写 Listing 正文（标题、五点、描述、关键词等）。
2. 必须 通过 python scripts/run.py ...（或 POST /v1/skills/listing/run）获取输出，并将 stdout / -o 文件作为交付物。
3. 对话模型仅用于：收集字段、确认平台/语言、解释结果、提醒人工审核。
4. 只需 TOKENAPI_KEY， 不要 要求用户另配 DeepSeek / OpenAI 等厂商 Key。

Instructions（Agent 工作流）#

1. 确认平台与语言： amazon / shopify / tiktok，语言 zh|en|es|de|fr|ja。

2. 收集必填字段：产品名、核心关键词（逗号分隔）；可选卖点、受众、品牌调性。

3. 调用生成（必须 — 云端）： bash

   python scripts/run.py \
     --product "..." \
     --keywords "..." \
     --platform amazon \
     --lang zh \
     --format amazon \
     -o listing.txt
   
   

   • API： POST {TOKENAPI_BASE_URL}/skills/listing/run
   • 默认 TOKENAPI_BASE_URL=http://localhost:8080/v1；生产环境为控制台同域 /api/v1

4. 输出： --format amazon|shopify|tiktok|json；提醒用户 人工审核后再上架。

5. 计费：余额不足返回 402；无效密钥返回 401。

仓库内开发（可选）#

在完整 TokenApi 仓库中可用 scripts/listing_generator.py（本地 Harness + yufluentcn-harness），需 pip install -r requirements-dev.txt。ClawHub 分发包 不包含 此路径。

环境变量#

变量必填说明TOKENAPI_KEY是tk-*， Yufluent 控制台 获取TOKENAPI_BASE_URL否默认 http://localhost:8080/v1

模型档位由平台 Harness 自动选择，无需卖家配置。

触发词#

• "生成亚马逊 Listing"
• "写个 Shopify 产品描述"
• "TikTok 商品文案"
• "优化产品标题"
• "做多语言 Listing"

Examples#

用户：帮我写一个英文亚马逊 Listing，产品是便携式咖啡机，关键词 espresso, camping, mini。

Agent：

bash

export TOKENAPI_KEY="tk-..."
export TOKENAPI_BASE_URL="http://localhost:8080/v1"
python scripts/run.py \
  --product "Portable Espresso Coffee Maker" \
  --keywords "espresso,camping,mini" \
  --platform amazon --lang en \
  --format amazon -o listing.txt

文件结构#

Monorepo 源码（ skills/yufluentcn-ecommerce-listing/）：

text

yufluentcn-ecommerce-listing/
  SKILL.md
  scripts/
    run.py                  # 主入口（云端）
    listing_generator.py    # 仅仓库内本地 Harness（不进 ClawHub 包）
    format_listing.py         # 仅 listing_generator 使用（不进 ClawHub 包）
  requirements.txt
  requirements-dev.txt      # 本地 Harness 可选依赖

云端客户端 yufluent_api.py、 cloud_cli.py、 bootstrap.py 的 SoT 在 skills/_shared/； run.py 启动时经 sys.path 引用， 不要 在技能目录 scripts/ 下找这些文件的源码副本。

ClawHub 安装包（ package-skill.ps1 打包后）：

text

yufluentcn-ecommerce-listing/
  SKILL.md
  README.md
  .env.example
  requirements.txt          # 仅 requests
  scripts/
    run.py                  # 主入口（云端）
    yufluent_api.py         # 由 _shared/ 注入
    cloud_cli.py            # 由 _shared/ 注入
    bootstrap.py            # 由 _shared/ 注入

合规声明#

• 生成内容需人工审核后上架
• 遵守各平台卖家条款，不生成虚假宣传内容

版本记录#

版本日期变更v1.3.02026-06-14SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register linksv1.1.12026-05-24OpenClaw 双模型说明；禁止 Agent 自行生成 Listingv1.1.02026-05-24Yufluent 品牌；ClawHub 云端薄客户端 run.pyv1.0.02026-05-21初始 Listing 技能