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

   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 分发包不包含此路径。

环境变量

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

触发词

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

Examples

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

Agent：

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/）：

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 打包后）：

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/ 注入

合规声明

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

版本记录