Install
openclaw skills install @wang-jie-ss/shuaishou-mcp-clientBuilds and uses an MCP client (Streamable HTTP transport) to connect to the htyd MCP server and invoke all available tools (including login). Use when connecting to a Streamable HTTP MCP endpoint like https://dz.shuaishou.com/mcp. This is the production version.
openclaw skills install @wang-jie-ss/shuaishou-mcp-clientProvide 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/mcpMCP_APP_KEY=<your_app_key> (sent as Authorization: Bearer ...)确保 MCP 服务可访问(生产环境:https://dz.shuaishou.com/mcp)。
安装依赖(如需要):
cd "%USERPROFILE%\.agents\skills\htyd-mcp-client-streamable-0.1.0\scripts"
npm install
node htyd-mcp.mjs tools
node htyd-mcp.mjs call list_shops "{}"
node htyd-mcp.mjs call list_collected_goods "{\"claimStatus\":0,\"pageNo\":1,\"pageSize\":50}"
node htyd-mcp.mjs login_shuashou --username "YOUR_USER" --password "YOUR_PASS" --loginType "pd"
node htyd-mcp.mjs collect_goods --originList "https://detail.1688.com/offer/xxx.html"
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
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
仅完成商品采集并认领到指定店铺,停留在草稿箱状态,不自动发布。
# 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
用户提供一个链接,完成采集、认领、发布的完整闭环,默认会跟踪发布结果。
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 秒[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 → 轮询查询发布结果
status=UNPUBLISH)--track false当前发布功能(publish_temu)仅支持 Temu(拼多多)店铺,不支持其他平台!
| 工具/命令 | 支持的平台 |
|---|---|
collect_goods | 1688、淘宝、天猫等(采集) |
claim_goods | 所有支持的目标店铺(认领到草稿箱) |
list_temu_drafts | 仅 Temu |
publish_temu | 仅 Temu |
collect_and_publish | 仅 Temu(一键发布) |
publish_and_track | 仅 Temu |
如果用户要求发布到天猫、京东、抖音等其他平台:
publish_temu / collect_and_publish / publish_and_trackclaim_goods 步骤(认领到目标店铺的草稿箱)platId 参考:
68 = Temu(目前唯一支持自动发布的平台)默认发布设置(用户未指定时自动生效):
isTitleCut=true - 自动截取标题(避免超长导致失败)titleCutType=0 - 取标题最前面的部分(含核心关键词)isFilterPsoriasisImg=true - 自动过滤牛皮癣图片uploadDetail=true - 上传详情信息bindWordRule=IGNORE - 忽略敏感词直接发布randomImage=false - 不打乱图片顺序videoUpload=false - 不上传视频scheduledPublish=false - 立即发布(非定时)/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顺序排列id, itemId, title, status, productIdstatus 可能值: SUCCESS/FAIL/PUBLISHINGuser-htyd-mcp)This wrapper is expected to expose all current tools:
login_shuashou (required)list_shopscollect_goodslist_collected_goodsclaim_goodslist_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 workflowIf new tools are added server-side later, use tools to discover them and call them via call.
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/mcpMCP_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 工具时:
tools 验证连接login_shuashoulist_shops、collect_goods、list_collected_goods、claim_goods)