返回顶部
l

listing-i18nListing 本地化

在 OpenClaw 中把中文产品 Excel 或 CSV 本地化为 Amazon 和 Shopify 的多语言 Listing。适用于翻译产品、跨境电商 Listing 本地化、Amazon listing、Shopify listing、localize products 等场景。

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 0.2.0
安全检测
已通过
129
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

listing-i18n

Listing I18n

这个 skill 运行在 OpenClaw 上:

  • - 翻译和本地化改写由 OpenClaw 当前会话中的 LLM 完成
  • 模板生成、输入检查、Excel 输出、结果校验由本地 Python 脚本完成

不要把这个 skill 当成独立翻译程序。它是LLM 工作流 + 本地辅助脚本的组合。

可用脚本

  • - python3 generate_template.py [output.xlsx]
生成输入模板
  • - python3 inspect_input.py [--sheet SheetName]
检查输入文件结构,列出字段和样例数据
  • - python3 build_output.py [output.xlsx]
按约定 JSON 结构生成最终 Excel
  • - python3 validate.py
校验输出文件是否满足平台限制

工作流

1. 用户没有产品文件

运行:

bash
python3 generate_template.py

告诉用户填写 Products sheet 第 3 行起的数据,再继续。

2. 用户提供了产品文件

先运行:

bash
python3 inspectinput.py file>

基于脚本输出完成三件事:

  1. 1. 告诉用户检测到的列名和前 3 行样例
  2. 确认以下字段映射
  3. 如果缺少必填字段,要求用户补齐

必填字段:

  • - productid
  • brand
  • productname
  • category
  • specs
  • sellingpoints
  • keywordscn
  • package_includes

可选字段:

  • - customattributes
  • imagesnote

3. 确认平台和目标市场

如果用户没有特别说明:

  • - 平台默认 Both
  • 目标市场默认 en_US

支持的目标市场:

  • - enUS
  • enUK
  • deDE
  • jaJP
  • esES
  • frFR
  • it_IT

4. 由 LLM 执行逐产品翻译

对每个产品、每个目标市场、每个平台分别生成内容。

Amazon

  • - title
最长 200 chars,建议不超过 150
  • - bulletpoint1 到 bulletpoint5
共 5 条,每条建议 150-250 chars
  • - description
建议 150-300 词
  • - backend_keywords
最长 249 bytes,小写、空格分隔、不含品牌名

Shopify

  • - title
最长 100 chars
  • - description_html
建议 100-400 词,只用基础 HTML 标签
  • - seo_title
最长 70 chars
  • - seo_description
最长 320 chars
  • - tags
8-15 个,逗号分隔,小写
  • - product_type
英文品类路径,用 > 分隔

翻译要求:

  • - 不是直译,要做目标市场本地化
  • Amazon 偏搜索导向,Shopify 偏品牌叙事
  • 避免绝对化营销词,如 best、#1、guaranteed
  • custom_attributes 的 key 保持英文,value 翻译成目标语言
  • 美国站优先使用美式计量单位;英国、德国、日本按本地习惯表达

5. 生成输出文件

先把翻译结果组织成 JSON,再运行:

bash
python3 build_output.py [output.xlsx]

输出 workbook 需包含:

  • - Amazon sheet
  • Shopify sheet
  • Source_CN sheet

Amazon sheet 列顺序必须是:

text
product_id
brand
title
bulletpoint1
bulletpoint2
bulletpoint3
bulletpoint4
bulletpoint5
description
backend_keywords
custom_attributes
sourceproductname

Shopify sheet 列顺序必须是:

text
product_id
brand
title
description_html
seo_title
seo_description
tags
product_type
custom_attributes
sourceproductname

6. 校验并汇报

生成 Excel 后运行:

bash
python3 validate.py

向用户汇报:

  • - 处理了多少个产品
  • 生成了哪些平台和语言版本
  • 输出文件路径
  • 校验结果中有哪些 error 和 warning

translations.json 结构

buildoutput.py 读取如下结构。仓库里还提供了可直接参考的 translations.example.json

json
{
sheets: [
{
name: AmazonenUS,
headers: [
product_id,
brand,
title,
bulletpoint1,
bulletpoint2,
bulletpoint3,
bulletpoint4,
bulletpoint5,
description,
backend_keywords,
custom_attributes,
sourceproductname
],
rows: [
[
SP-001,
SoundPulse,
SoundPulse Noise Cancelling Earbuds,
【NOISE CANCELLATION】...,
【HI-RES AUDIO】...,
【ALL-DAY COMFORT】...,
【SWEAT RESISTANCE】...,
【IN THE BOX】...,
Long description...,
wireless earbuds bluetooth earbuds sports earbuds,
color:black | connectivity:bluetooth 5.3,
SP-Pro 主动降噪真无线蓝牙耳机
]
]
},
{
name: Source_CN,
headers: [productid, brand, productname],
rows: [[SP-001, SoundPulse, SP-Pro 主动降噪真无线蓝牙耳机]]
}
]
}

注意

  • - 依赖:python3 和 openpyxl
  • 建议每批不超过 20 个产品
  • 日语和德语输出建议母语者最终复核

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 listing-i18n-1775934672 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 listing-i18n-1775934672 技能

通过命令行安装

skillhub install listing-i18n-1775934672

下载

⬇ 下载 listing-i18n v0.2.0(免费)

文件大小: 17.46 KB | 发布时间: 2026-4-12 10:26

v0.2.0 最新 2026-4-12 10:26
Repair OpenClaw workflow, add input inspection/output builder, tighten validation, and add OpenClaw-oriented JSON example.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large