PTJourney Marketplace Listing Assistant

安装指南

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

什么是

PTJourney Marketplace Listing Assistant 可帮助 AI 编码代理整理 1688 商品信息、准备平台专属刊登数据，并管理 Ozon、Wildberries (WB) 和 TEMU 的已授权批量刊登任务。它通过连接到已登录 PTJourney Windows 客户端的官方 MCP 工具运行；此技能提供操作指导，而客户端和单独安装的 MCP 套件提供工具。
作为面向跨境电商的 Openclaw Skills 工作流程，它强调经平台验证的参考数据、预检验证、明确的用户授权和任务状态检查。它不会将创建任务视为刊登成功的证明，也不会要求在 IDE 中提供商城 API 密钥或令牌。
PTJourney Marketplace Listing Assistant 应用场景
将 1688 商品信息、俄语或英语翻译以及商品图片整理为一致的刊登数据包。
使用适当的平台、店铺和模板，为 Ozon 标准商品、Ozon POD、Wildberries 或 TEMU 准备并预检批次。
查看逐行验证错误，并在提交前修正缺失或无效的刊登数据。
向用户展示账户、店铺、商品数量、价格范围和预检错误后，创建已获授权的刊登批次。
检查批次和任务进度，查看任务详情或日志，并在考虑重试之前诊断失败或状态不确定的商品。
说明操作内容并获得确认后，暂停或恢复受支持的任务、重试符合条件的 WB 失败子队列，或控制 TEMU runner。
PTJourney Marketplace Listing Assistant 工作原理
将 IDE 连接到官方 PTJourney MCP 套件，并使用 ptj_listing_capabilities 验证连接。
使用 ptj_listing_reference 读取当前账户专属的店铺、模板、仓库、类目和动态类目属性。以平台响应作为事实来源，不要根据 1688 页面猜测 ID 或取值。
将商品信息、翻译和图片整理为统一数据包。为每一行提供稳定的 offer_id，将图片存放在每个 SKU 对应的文件夹中，并在需要时提供完整的平台专属 JSON。
按平台、店铺和模板拆分商品，然后调用 ptj_listing_preflight。检查逐行错误和返回的 planId；该 ID 有效期为 15 分钟。必要时修正问题并重新运行预检。
向用户展示预检摘要，包括账户、店铺、商品数量、价格范围和错误。只有在获得明确授权后，才使用稳定的 idempotencyKey 和 confirm=true 调用 ptj_listing_create_batch。
使用 ptj_listing_start_batch 启动 TEMU 和 Ozon POD 批次。Ozon 标准商品和 WB 任务在创建后通过客户端队列执行。
使用 ptj_listing_batch_status 跟踪批次状态，然后根据支持情况，通过 ptj_task_list、ptj_task_detail 或 ptj_task_logs 检查实际任务进度。确认结果后再报告成功或重试。
PTJourney Marketplace Listing Assistant 配置指南
安装并运行 PTJourney Windows 客户端，然后登录将用于刊登操作的账户。
安装独立的官方 PTJourney MCP 套件；此技能仓库包含操作说明，不包含 MCP 实现。
按照 references/mcp-setup.md 在 ZCode、WorkBuddy 或 Codex 中配置 MCP 连接。此技能未指定 CLI 安装命令。
通过 tools/list 确认 MCP 工具可用，然后调用 ptj_listing_capabilities 验证连接和客户端状态。
如果缺少 PTJourney 工具，或客户端报告未运行，请检查 MCP 配置和客户端版本。仅安装此技能并不会使 MCP 接口可用。
使用客户端当前已登录的账户。不要向 IDE 提供 PTJourney、Ozon、WB 或 TEMU 令牌或 API 密钥，也不要使用 window.api 或旧版 127.0.0.1:13080 插件路由。
PTJourney Marketplace Listing Assistant 数据架构与分类体系
此技能引用了 references/data-contract.md 中描述的统一数据包；详细字段定义见该契约和 references/mcp-contract.md。
数据元素 组织方式与要求
商品行 每行都有稳定的 offer_id，以便在准备和任务跟踪过程中识别商品。
商品图片 将图片存放在每个 SKU 对应的文件夹中。Ozon 标准和 WB 工作流程通过 MCP 上传本地图片；TEMU 要求每个 SKU 至少有五张图片。
共用商品信息 将 1688 商品信息以及俄语或英语翻译整理到统一数据包中。品牌、包装和认证信息缺失时，在确认前保持空白。
Ozon 标准快照 为每一行提供完整的 ozon_item_json。商品按店铺刊登，MCP 会运行现有的 Ozon 客户端预检。
Wildberries 请求 提供完整的 wb_request_json，包括创建商品卡和后处理请求。先读取平台类目数据，以获取必填属性和有效取值。
批次和任务元数据 预检会返回逐行错误和有效期为 15 分钟的 planId。批次创建使用稳定的 idempotencyKey；应独立于批次创建检查实际任务状态。
平台专属输入 TEMU 使用标题、英文标题、商品模板和每个 SKU 的图片。Ozon POD 使用已确认的模板、俄语标题、价格和图片；一个批次中的所有商品必须使用相同模板。
类目 ID、字典值、店铺 ID 和动态属性应使用平台当前响应。其他平台要求见 references/platforms.md。
PTJourney Marketplace Listing Assistant 高级特性
支持 TEMU、Ozon POD、Ozon 标准刊登和 WB 的平台专属工作流程，各自具有不同的数据和执行要求。
预检验证会返回逐行错误和有时效限制的
planId
，以便在提交前修正批次。
明确授权、
confirm=true
和稳定的幂等键有助于控制批次创建并避免盲目重复重试。
批次状态和任务检查彼此独立：使用
ptj_listing_batch_status
检查批次，并使用任务列表、详情或日志工具验证执行情况。
任务操作包括受支持的暂停、恢复和重试操作；在确认前读取目标任务并说明计划执行的操作。
可查看 TEMU runner 状态，并使用全局启动或暂停控制。由于全局控制会影响当前客户端中的待处理任务，必须说明其影响范围并取得用户确认。
Ozon POD 配额警告要求先向用户展示警告并获得批准，才能使用相同的
planId
和幂等键重新提交；不要自动确认此类警告。
此工作流程围绕已登录的桌面客户端和官方 MCP 接口设计，而非直接处理凭据或使用旧版插件路由。

name: ptjourney-listing description: "PTJourney 跨境电商 AI 批量上架助手，支持 Ozon ERP、Wildberries（WB）ERP、TEMU ERP 工作流。整理 1688 商品、预检上架数据、管理已授权任务，通过已登录 Windows 客户端的本机 MCP 操作。Use for marketplace product listing and task management." license: MIT-0

PTJourney 跨境电商上架助手 · Ozon / Wildberries / TEMU

本 skill 指导 IDE 中的 AI 整理 1688 商品数据，并通过当前登录的 PTJourney 客户端执行 MCP 批量上架。本仓库仅提供操作说明；实际工具由已安装客户端和另行下载的官方 MCP 包提供。先按 MCP 安装与连接 配置 ZCode、WorkBuddy 或 Codex，并调用 ptj_listing_capabilities 确认连接。

工作流
用 ptj_listing_reference 读取账号下的店铺、模板、仓库和动态类目属性。类目 ID、字典值和店铺 ID 以当前平台响应为准，不根据 1688 页面猜测。
将 1688 事实、俄文/英文翻译和图片整理到 统一数据包。每行有稳定 offer_id，每个货号对应图片文件夹。Ozon 标品写完整 ozon_item_json，WB 写完整 wb_request_json；缺失的品牌、包装数据和认证资料留空待确认。
按平台、店铺和模板拆批，调用 ptj_listing_preflight。预检返回逐行错误和 15 分钟有效的 planId。修正后重新预检。
向用户展示预检摘要中的账号、店铺、商品数、价格范围及错误。得到该批次的明确授权后，用稳定 idempotencyKey 和 confirm=true 调用 ptj_listing_create_batch。
TEMU 和 Ozon POD 调用 ptj_listing_start_batch；Ozon 标品和 WB 创建后由客户端队列自动执行。用 ptj_listing_batch_status 查询批次，再用 ptj_task_list、ptj_task_detail 或 ptj_task_logs 查看真实任务进度。任务已创建不代表商品已上架成功。
日常任务运营
ptj_task_list 查询 Ozon 标品/POD、WB 或 TEMU 上架任务；WB 和 TEMU 指定当前账号店铺 ID。
ptj_task_detail 查询 Ozon、WB 明细；ptj_task_logs 查询 Ozon 任务日志。TEMU 按店铺在任务列表中查询。
ptj_task_action 暂停或继续 Ozon/TEMU 任务，继续 WB 任务或重试 WB 失败子队列。先读取目标任务并向用户说明具体动作，再传 confirm=true。
ptj_runner_state 查询 TEMU 上架执行器；ptj_runner_control 启动或暂停全部 TEMU 上架执行器。全局动作会影响当前客户端待执行任务，须向用户说明范围并传 confirm=true。
平台边界
TEMU：使用标题、英文标题、产品模板及每货号至少五图；每店单独建任务。
Ozon POD：使用已确认的模板、俄文标题、价格及每货号图片；同批商品需适用同一模板。
Ozon 标品：每行需要完整 Ozon 商品快照，逐商品按店铺上架，MCP 会上传本地图片并运行现有 Ozon 客户端预检。
WB：每行需要完整 WB 建卡与后处理请求，MCP 会上传本地图片并逐商品创建任务。类目必填属性和合法值须先读取平台数据。

具体字段和工具参数见 MCP 工具契约 与 平台数据要求。

操作约束
使用客户端当前登录账号；不要向 IDE 提供 PTJourney、Ozon、WB 或 TEMU 的 Token/API Key。
只调用 MCP 工具，不调用 window.api 或旧的 127.0.0.1:13080 插件路由。
若 tools/list 没有 PTJourney 工具，或 ptj_listing_capabilities 提示客户端未运行，先检查 MCP 配置和客户端版本；Skill 安装成功不代表接口可用。
failed 或 uncertain 的商品先核对平台任务与货号。修正数据后重新预检并使用新的幂等键；不要对提交结果未知的货号盲目重试。
Ozon POD 额度警告是唯一的同批重提分支：先展示具体警告，用户同意后按 MCP 工具契约 用同一 planId 和幂等键确认。不要自动确认额度警告。
Qique 员工 AI 助手
社交周