本地化 App Store 商品页

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install metarun-localize-listing
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 metarun-localize-listing。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

此 skill 可帮助 AI 智能代理通过 MetaRun 跨语言本地化或编辑 App Store 商品页内容。智能代理负责撰写和翻译文案；MetaRun 会按地区暂存更改并提供预览，确认后再应用。支持 app 名称、副标题、描述、关键词、“What's New”、推广文本和 URL。
Openclaw Skills 用户可以使用它管理本地化，并清晰检查可编辑的商品页区域、Apple 字符数限制、关键词质量以及缺失的地区覆盖情况。翻译不会在服务器端执行：智能代理负责保留语气、含义和品牌术语。每项更改都会在应用前预览，随后根据商品页覆盖情况进行验证。

应用场景

将 App Store 商品页翻译成新支持的语言。
在现有地区更新描述、副标题、关键词或推广文本。
开始本地化任务前，通过商品页覆盖情况找出空白或不完整字段。
为 app 更新准备本地化的“What's New”文案。
使用 ASO lint 检查和跨地区索引信息，改进特定地区的关键词组。
应用更改前检查暂存内容，尤其是可能在正式上线的 app 上立即发布的推广文本。

工作原理

检查现有商品页元数据和版本本地化内容，然后检查覆盖情况，找出缺失的字段和地区。
检查商品页是否可编辑，以确定哪些本地化区域开放、哪些区域已锁定。
添加语言时选择有效的地区代码，并在保留品牌术语和字符数限制的前提下撰写或翻译所需文案。
使用 ASO lint 检查验证关键词，并参考跨地区索引信息，避免重复并有效利用 storefront 索引。
在相应区域预览各地区的更改：app 信息或版本本地化。
向用户展示暂存的更改，然后使用各自的确认令牌应用每项更改。
再次读取商品页覆盖情况，处理仍未满足的请求，并报告已更新的语言。

配置指南

此 skill 需要 npx，并通过 MCP 服务器或 CLI 访问 MetaRun 工具。使用 MetaRun login 进行身份验证，或提供 METARUN_TOKEN 个人访问令牌。登录后，凭据会保存在 ~/.metarun/config.json 中。
npx metarun login
需要时，使用 CLI 检查可用工具架构并调用工具：
npx metarun tools --json
npx metarun run ''
如果登录已保存凭据，则无需提供令牌。尝试写入前请检查商品页是否可编辑，并在应用每项更改前进行预览。

数据架构

商品页内容按地区组织，分布在两个不同的 App Store 区域：

工作原理

App 信息本地化 商店名称、副标题、隐私 URL 使用 apple_preview_set_app_info_localization 预览，然后使用 apple_apply_set_app_info_localization 应用
版本本地化 描述、关键词、What's New、推广文本、支持和营销 URL 使用 apple_preview_set_version_localization 预览，然后使用 apple_apply_set_version_localization 应用
apple_list_app_metadata 读取当前各地区的元数据；apple_list_version_localizations 读取可编辑版本的文案。
apple_get_listing_coverage 按语言报告已填写和空白字段，并指出缺失项。
apple_list_supported_locales 提供有效的地区代码。创建 app 信息本地化时，载荷中必须包含商店名称；创建版本本地化时，必须包含地区。
Apple 字符数限制：名称 30、副标题 30、关键词 100、推广文本 170、描述 4,000 个字符。
“What's New”仅适用于更新，不适用于首次发布。推广文本可能会在正式上线的 app 上立即发布。
此 skill 不会描述生成本地文件。MetaRun 会在登录后存储身份验证配置，更改会记录在更改历史中，并且可以逐项撤销。

高级特性

写入前使用可编辑性检查，区分开放和锁定的本地化区域。
支持地区覆盖报告，以查找不完整字段并验证请求的语言是否确实已更新。
通过预览并确认的工作流程应用更改，并分别使用 app 信息和版本本地化工具。
aso_lint_metadata
，检测关键词违规和重复内容。
aso_cross_locale_plan
了解各 storefront 会索引哪些其他地区，并据此规划关键词组。
将正式上线 app 的推广文本视为立即发布的内容，并避免为首次发布填写“What's New”。
支持基于更改历史撤销已应用的更改。

name: localize-listing description: >- Localize or edit an App Store listing across languages through MetaRun:
name, subtitle, description, keywords, What's New, promotional text, and
URLs, per locale. YOU do the translating; MetaRun stages and applies.
Trigger phrases: "translate my listing", "localize the app store page",
"add German", "update the description in every language", "write What's
New and translate it".