HTYD MCP Client (Streamable HTTP) - Production

Goal

Provide an MCP client-first wrapper for MCP servers exposed via Streamable HTTP transport (/mcp). This is intended for hosts (e.g. OpenClaw) that do not support MCP connections natively: install a tiny Node client and use it to list/call all MCP tools, including login.

这是正式生产环境版本，连接 https://dz.shuaishou.com/mcp。

Default endpoint:

• MCP_URL=https://dz.shuaishou.com/mcp
• MCP_APP_KEY= (sent as Authorization: Bearer ...)

Quick start (OpenClaw / any shell)

1) 确保 MCP 服务可访问（生产环境：https://dz.shuaishou.com/mcp）。

2) 安装依赖（如需要）:

cd "%USERPROFILE%\.agents\skills\htyd-mcp-client-streamable-0.1.0\scripts"
npm install

3) 列出工具：

node htyd-mcp.mjs tools

4) 调用工具：

node htyd-mcp.mjs call list_shops "{}"
node htyd-mcp.mjs call list_collected_goods "{\"claimStatus\":0,\"pageNo\":1,\"pageSize\":50}"

5) 登录（部分流程需要）:

node htyd-mcp.mjs login_shuashou --username "YOUR_USER" --password "YOUR_PASS" --loginType "pd"

6) 采集商品：

node htyd-mcp.mjs collect_goods --originList "https://detail.1688.com/offer/xxx.html"

7) 认领商品到店铺：

node htyd-mcp.mjs claim_goods --itemIds 35476703,35476704 --platId 68 --merchantIds 2025050918

推荐使用 --originList 替代 --itemIds，客户端会自动从已采集商品中筛选可认领的（采集成功、非重复采集、非采集中）。

示例（推荐）：

node htyd-mcp.mjs claim_goods --originList "https://detail.1688.com/offer/xxx.html" --platId 68 --merchantIds 2025050918

8) 一键采集+认领+发布：

node htyd-mcp.mjs collect_and_publish --originList "https://detail.1688.com/offer/xxx.html" --platId 68 --merchantIds 2025050918 --pubShops 2025050918

此命令执行：采集 → 认领 → 查询草稿 → 发布。

默认会跟踪发布结果，通过 list_publish_records 轮询直到 SUCCESS/FAIL：

node htyd-mcp.mjs collect_and_publish --originList "https://detail.1688.com/offer/xxx.html" --platId 68 --merchantIds 2025050918 --pubShops 2025050918 --timeoutSec 180 --intervalSec 3

跳过结果跟踪（仅发送发布请求）：

node htyd-mcp.mjs collect_and_publish --originList "https://detail.1688.com/offer/xxx.html" --platId 68 --merchantIds 2025050918 --pubShops 2025050918 --track false

如果发布失败，客户端会打印错误信息，并建议到甩手店长后台修正商品信息后重新发布。

8.1) 仅发布并跟踪（适用于已有草稿 itemIds）：

node htyd-mcp.mjs publish_and_track --itemIds 1306795 --pubShops 2025050918 --timeoutSec 180 --intervalSec 3

业务流程说明

闭环1：采集 → 认领（到草稿箱）

仅完成商品采集并认领到指定店铺，停留在草稿箱状态，不自动发布。

# Step 1: 采集
node htyd-mcp.mjs collect_goods --originList "https://detail.1688.com/offer/xxx.html"

# Step 2: 认领（认领到草稿箱）
node htyd-mcp.mjs claim_goods --originList "https://detail.1688.com/offer/xxx.html" --platId 68 --merchantIds 2025050918

闭环2：采集 → 认领 → 发布（一站式）

用户提供一个链接，完成采集、认领、发布的完整闭环，默认会跟踪发布结果。

node htyd-mcp.mjs collect_and_publish \
  --originList "https://detail.1688.com/offer/730708656407.html" \
  --platId 68 \
  --merchantIds 2025050918 \
  --pubShops 2025050918

参数说明

• --originList (必填) - 商品链接，支持多个
• --platId (必填) - 平台ID，如 68 代表 Temu
• --merchantIds (必填) - 认领目标店铺ID列表
• --pubShops (可选) - 发布店铺ID列表，不传则默认使用 merchantIds 第一个
• --track (可选) - 是否跟踪发布结果，默认 true
• --timeoutSec (可选) - 跟踪超时时间（秒），默认 180 秒
• --intervalSec (可选) - 轮询间隔（秒），默认 3 秒

执行流程（6步闭环）

[1/6] collect_goods                    → 调用采集接口
[2/6] list_collected_goods             → 查询采集结果，获取 itemId
[3/6] claim_goods                      → 认领到指定店铺
[4/6] list_temu_drafts                 → 查询草稿箱定位商品
[5/6] publish_temu                     → 调用发布接口
[6/6] list_publish_records_by_item_id  → 轮询查询发布结果

草稿箱商品定位策略

1. 店铺限定：只查询目标店铺
2. 状态限定：只查未发布状态（status=UNPUBLISH）
3. 时间排序：按认领时间倒序
4. 链接匹配：匹配原始 URL

重要说明

• 一个商品可多次发布：同一 itemId 可能有多条发布记录，系统自动取最新的那条判断状态
• 如需跳过结果查询，添加 --track false

⚠️ 平台限制说明

当前发布功能（publish_temu）仅支持 Temu（拼多多）店铺，不支持其他平台！

如果用户要求发布到天猫、京东、抖音等其他平台：

• ❌ 不要使用 publish_temu / collect_and_publish / publish_and_track
• ✅ 只执行到 claim_goods 步骤（认领到目标店铺的草稿箱）
• ✅ 告知用户：目前自动发布功能仅支持 Temu 店铺，其他平台需要手动在甩手店长后台发布

platId 参考：

• 68 = Temu（目前唯一支持自动发布的平台）

默认发布设置（用户未指定时自动生效）：

• isTitleCut=true - 自动截取标题（避免超长导致失败）
• titleCutType=0 - 取标题最前面的部分（含核心关键词）
• isFilterPsoriasisImg=true - 自动过滤牛皮癣图片
• uploadDetail=true - 上传详情信息
• bindWordRule=IGNORE - 忽略敏感词直接发布
• randomImage=false - 不打乱图片顺序
• videoUpload=false - 不上传视频
• scheduledPublish=false - 立即发布（非定时）

9) Query publish records by itemId (根据商品itemId查询发布记录，对应接口 /api/pdd/record/list_by_item_id):

node htyd-mcp.mjs call list_publish_records_by_item_id "{\"ids\":[1306795,1306796]}"

• ids (required): 商品ID列表，支持多个itemId，返回结果按itemId顺序排列
• 一个商品可多次发布：同一 itemId 可能对应多条发布记录（例如重复发布），系统会自动取发布时间最新的那条记录
• 返回字段: id, itemId, title, status, productId
• status 可能值: SUCCESS/FAIL/PUBLISHING

Tool coverage (current user-htyd-mcp)

This wrapper is expected to expose all current tools:

• login_shuashou (required)
• list_shops
• collect_goods
• list_collected_goods
• claim_goods
• list_temu_drafts (new)
• publish_temu (new)
• list_publish_records_by_item_id (根据itemId查询发布记录，对应接口 POST /api/pdd/record/list_by_item_id。一个商品可多次发布，取最新记录)

Convenience command:

• collect_and_publish - One-step collect → claim → publish workflow

If new tools are added server-side later, use tools to discover them and call them via call.

Configuration

Environment variables:

• MCP_URL (optional): MCP endpoint URL. Default https://dz.shuaishou.com/mcp.
• MCP_APP_KEY (optional): AppKey (sent as Authorization: Bearer ...).
• MCP_AUTHORIZATION (optional): Full Authorization header value; overrides MCP_APP_KEY.

首次运行 / 缺少 API Key：

• 如果未设置 MCP_APP_KEY/MCP_AUTHORIZATION（或加载失败返回 401/403），客户端会交互式提示输入
• 配置值会保存到 ~/.htyd-mcp-client-streamable.json，下次自动复用

环境配置

环境变量：

• MCP_URL（可选）：MCP 端点 URL。默认 https://dz.shuaishou.com/mcp
• MCP_APP_KEY（可选）：AppKey（作为 Authorization: Bearer ... 发送）
• MCP_AUTHORIZATION（可选）：完整的 Authorization header 值；优先级高于 MCP_APP_KEY

临时覆盖 endpoint：

# 连接其他环境
MCP_URL=https://other-server.com/mcp node htyd-mcp.mjs tools

操作流程

使用 MCP 工具时：

1. 运行 tools 验证连接
2. 如需认证，先调用 login_shuashou
3. 然后调用业务工具（list_shops、collect_goods、list_collected_goods、claim_goods）