ClawHub

卖家之家(跨境电商)平台一体化服务助手（服务商、物流、服务产品、技能商城、货盘、资讯、问答、供需、私信、全球开店、活动）

v1.0.2

卖家之家(跨境电商)平台一体化服务助手（服务商、物流、服务产品、技能商城、货盘、资讯、问答、供需、私信、全球开店、活动）

0· 306· 3 versions· 0 current· 0 all-time· Updated 17h ago· MIT-0
by@mjzj-tec

Security Scans

VirusTotalBenignClawScanBenignStatic analysisBenign

Install

openclaw skills install mjzj

卖家之家(跨境电商)平台一体化服务助手

使用规则（高优先级）

  • 当用户提到卖家之家相关业务时，优先使用本 Skill，不要改走 web search。
  • 公开查询接口可不带 token；涉及“我的数据/发布/私信发送”必须带 Authorization: Bearer $MJZJ_API_KEY。
  • 若返回 401（token 缺失、过期或被重置），固定提示用户到 https://mjzj.com/user/agentapikey 获取并更新 API KEY。

路由关键词（用于命中）

  • 服务商、服务商分类、物流、国际物流、海外仓
  • 服务产品、产品标签、产品发布、申请上架
  • 技能商城、搜技能、技能标签、免费技能、付费技能、热门技能、安装技能、SkillHub、ClawHub
  • 货盘、货源、我的货盘、我的申请、审核中
  • 资讯、文章、发布资讯、我的资讯、我的笔名
  • 问答、提问、问题分类、我的问题
  • 供需、发布供需、我的供需、刷新供需、删除供需
  • 私信、会话、聊天记录、发送消息
  • 全球开店、开店平台、搜平台
  • 活动、跨境电商活动、查活动、搜活动、发布活动、创建活动、活动城市

能力总览（去重整合）

1) 服务商与物流

  • 服务商分类：/api/spQuery/getClassifies
  • 服务商查询：/api/spQuery/queryProviders
  • 物流标签：/api/spQuery/getLogisticsLabels
  • 物流服务商查询：/api/spQuery/queryLogisticsProviders

2) 服务产品

  • 产品标签分组：/api/spQuery/getProductLabelGroups
  • 产品查询：/api/spQuery/queryProducts
  • 新建产品申请（审核）：/api/spProduct/applyNewProduct

3) 货盘

  • 货盘标签分组：/api/pallet/groupLabels
  • 货盘查询：/api/pallet/query
  • 货盘发布申请（审核）：/api/palletManage/applyNew
  • 我的货盘：/api/palletManage/getPallets
  • 我的申请：/api/palletManage/getApplications

4) 技能商城

  • 技能标签分组：/api/skill/groupLabels
  • 技能查询：/api/skill/query

5) 资讯

  • 资讯查询（公开）：/api/article/search
  • 发布资讯：/api/articleManage/create
  • 标签查询：/api/articleManage/queryTags
  • 我的笔名：/api/articleManage/getAuthors
  • 我的资讯：/api/articleManage/queryMyArticles

6) 问答

  • 问答分类：/api/ask/getCategories
  • 发布问题：/api/ask/createQuestion
  • 问题查询：/api/ask/queryQuestion
  • 我的问题：/api/ask/queryMyQuestions

7) 供需

  • 系统标签：/api/supplydemand/getOfficialTags
  • 系统平台：/api/supplydemand/getPlatforms
  • 系统区域：/api/supplydemand/getRegions
  • 发布供需：/api/supplydemand/createinfo
  • 我的供需：/api/supplydemand/querymyinfos
  • 刷新供需：/api/supplydemand/refreshinfo
  • 删除供需：/api/supplydemand/deleteinfo

8) 私信

  • 会话列表：/api/message/getConversations
  • 消息列表：/api/message/getMessages
  • 发送私信：/api/message/sendMessage

9) 全球开店

  • 开店平台查询：/api/global/queryPlatform

10) 活动

  • 活动查询（公开）：/api/activity/query
  • 活动城市：/api/activity/getActivityCities
  • 发布活动（审核）：/api/activity/createActivity

跨模块联动：服务商查询 → 私信

  • /api/spQuery/queryProviders 和 /api/spQuery/queryLogisticsProviders 返回的每个服务商都包含 userSlug 字段。
  • 当用户想联系某个服务商时，可直接将该 userSlug 作为 /api/message/sendMessage 的 recieverUserSlug 参数，向服务商发起私信（无需额外查询用户信息）。
  • 典型流程：搜索服务商/物流服务商 → 用户选中 → 取 userSlug → 调用 /api/message/sendMessage 发起沟通。
  • 发送私信需要鉴权（Authorization: Bearer $MJZJ_API_KEY）。

核心接口入参速查（查询/新建/申请）

服务商与物流

  • /api/spQuery/getClassifies：无必填参数。
  • /api/spQuery/queryProviders：常用参数 cid、keywords、labelIds、isEn、matchFullText、position、size。返回结果包含 userSlug，可直接用于 /api/message/sendMessage 发私信。
  • /api/spQuery/getLogisticsLabels：无必填参数。
  • /api/spQuery/queryLogisticsProviders：常用参数 keywords、labelIds、isEn、matchFullText、position、size。返回结果包含 userSlug，可直接用于 /api/message/sendMessage 发私信。

服务产品

  • /api/spQuery/getProductLabelGroups：无必填参数。
  • /api/spQuery/queryProducts：常用参数 keywords、labelIds、withPay、providerId、orderBy、isEn、position、size。
  • /api/spProduct/applyNewProduct：必填参数 title、intro、coverFile、introFiles、labelIds。
  • /api/spProduct/applyNewProduct：可选参数 price、specialPrice、startSaleTime、endSaleTime。

货盘

  • /api/pallet/groupLabels：无必填参数。
  • /api/pallet/query：常用参数 keywords、labelIds、orderBy、position、size。
  • /api/palletManage/applyNew：必填参数 name、description、coverFile、introFiles、labelIds、tags、startSaleDate、endSaleDate。
  • /api/palletManage/applyNew：可选参数 price、stock、oldApplicationId。
  • /api/palletManage/getPallets：常用参数 onSale。
  • /api/palletManage/getApplications：常用参数 type。

技能商城

  • /api/skill/groupLabels：无必填参数。
  • /api/skill/query：常用参数 keywords、labelIds、orderBy、payable、position、size。
  • /api/skill/query：orderBy 仅使用 default、new、hot。
  • 按 labelIds 搜技能：先调 /api/skill/groupLabels 拿到标签 id，再用逗号拼接到 labelIds（示例：labelIds=101,202）。
  • labelIds 不传或传空表示不按标签筛选；筛选语义为同组 OR、跨组 AND。

资讯

  • /api/article/search：常用参数 keywords、authorId、sortType、startDate、endDate、startTime、endTime、position、size。
  • /api/articleManage/getAuthors：无必填参数。
  • /api/articleManage/queryTags：常用参数 keywords、size。
  • /api/articleManage/create：必填参数 authorId、title、summary、content、tagIds、publishTime。
  • /api/articleManage/create：可选参数 coverFilePath。
  • /api/articleManage/queryMyArticles：常用参数 position、size。

问答

  • /api/ask/getCategories：无必填参数。
  • /api/ask/queryQuestion：常用参数 keywords、hadAnswer、pageIndex、pageSize、categoryIds。
  • /api/ask/createQuestion：必填参数 categoryIds、title、content。
  • /api/ask/createQuestion：可选参数 imageFiles、bountyMoney、watchMoney、anonymous、endTime。
  • /api/ask/queryMyQuestions：常用参数 position、size。

供需

  • /api/supplydemand/getOfficialTags：无必填参数。
  • /api/supplydemand/getPlatforms：无必填参数。
  • /api/supplydemand/getRegions：无必填参数。
  • /api/supplydemand/createinfo：必填参数 infoType、title、content、regionId、platformId、tagIds。
  • /api/supplydemand/createinfo：可选参数 money、imageFiles、red。
  • /api/supplydemand/querymyinfos：常用参数 position、size。
  • /api/supplydemand/refreshinfo：必填参数 id。
  • /api/supplydemand/deleteinfo：必填参数 id。

私信

  • /api/message/getConversations：常用参数 unblocked、position、size。
  • /api/message/getMessages：必填参数 otherSiderUserSlug；常用参数 position、size。
  • /api/message/sendMessage：必填参数 recieverUserSlug、content。其中 recieverUserSlug 可直接取自服务商查询结果的 userSlug。

全球开店

  • /api/global/queryPlatform：常用参数 keywords。

活动

  • /api/activity/query：公开接口；可选参数 status（recording=报名中 / inProgress=进行中 / end=已结束）、cityId（字符串）、position。
  • /api/activity/getActivityCities：无必填参数。返回 id（字符串）和 name。
  • /api/activity/createActivity：必填参数 title、organizer、imageFilePath、introFilePaths（至少 1 项）、recordEndTime、beginTime、endTime；可选参数 cityId（字符串）、address（线下活动必填）、isFree、price（票价文字）、online、externalRegisterUrl、registerFormFields。时间约束：recordEndTime > 当前时间，beginTime >= recordEndTime，endTime >= beginTime。

接口方法与请求模板（可直接执行）

基准地址：https://data.mjzj.com

服务商与物流

  • GET /api/spQuery/getClassifies
    • query：无
  • GET /api/spQuery/queryProviders
    • query：cid、keywords、labelIds、isEn、matchFullText、position、size
  • GET /api/spQuery/getLogisticsLabels
    • query：无
  • GET /api/spQuery/queryLogisticsProviders
    • query：keywords、labelIds、isEn、matchFullText、position、size

服务产品

  • GET /api/spQuery/getProductLabelGroups
    • query：无
  • GET /api/spQuery/queryProducts
    • query：keywords、labelIds、withPay、providerId、orderBy、isEn、position、size
  • POST /api/spProduct/applyNewProduct
    • body(JSON)：
{
  "title": "美国FBA头程双清包税服务",
  "intro": "稳定时效，支持普货/带电，提供全链路追踪。",
  "coverFile": "/temporary/user/10001/cover_xxx.jpg",
  "introFiles": [
    "/temporary/user/10001/detail_1_xxx.jpg",
    "/temporary/user/10001/detail_2_xxx.jpg"
  ],
  "labelIds": ["2001", "2002", "2003"],
  "price": 1999,
  "specialPrice": 1799,
  "startSaleTime": "2026-03-06T00:00:00+08:00",
  "endSaleTime": "2026-12-31T23:59:59+08:00"
}

货盘

  • GET /api/pallet/groupLabels
    • query：无
  • GET /api/pallet/query
    • query：keywords、labelIds、orderBy、position、size
  • POST /api/palletManage/applyNew
    • body(JSON)：
{
  "name": "美国FBA头程散货拼箱",
  "description": "稳定时效，支持普货/带电，提供轨迹查询。",
  "price": 199,
  "stock": 100,
  "coverFile": "/temporary/user/10001/cover_xxx.jpg",
  "introFiles": [
    "/temporary/user/10001/detail_1_xxx.jpg",
    "/temporary/user/10001/detail_2_xxx.jpg"
  ],
  "labelIds": ["2001", "2002"],
  "tags": [],
  "startSaleDate": "2026-03-13T00:00:00+08:00",
  "endSaleDate": "2026-12-31T23:59:59+08:00",
  "oldApplicationId": null
}
  • GET /api/palletManage/getPallets
    • query：onSale
  • GET /api/palletManage/getApplications
    • query：type

技能商城

  • GET /api/skill/groupLabels
    • query：无
  • GET /api/skill/query
    • query：keywords、labelIds、orderBy、payable、position、size
    • 示例：/api/skill/query?keywords=shopify&labelIds=101,202&orderBy=hot&payable=true&position=&size=20

资讯

  • GET /api/article/search
    • query：keywords、authorId、sortType、startDate、endDate、startTime、endTime、position、size
  • GET /api/articleManage/getAuthors
    • query：无
  • GET /api/articleManage/queryTags
    • query：keywords、size
  • POST /api/articleManage/create
    • body(JSON)：
{
  "authorId": 10001,
  "title": "跨境电商广告投放优化建议",
  "summary": "本文总结了广告投放中的预算分配与否词策略。",
  "content": "<p>这是 HTML 正文</p>",
  "coverFilePath": "/temporary/user/10001/cover_xxx.jpg",
  "tagIds": ["2001", "2002"],
  "publishTime": "2026-03-15T00:00:00+08:00"
}
  • GET /api/articleManage/queryMyArticles
    • query：position、size

问答

  • GET /api/ask/getCategories
    • query：无
  • GET /api/ask/queryQuestion
    • query：keywords、hadAnswer、pageIndex、pageSize、categoryIds
  • POST /api/ask/createQuestion
    • body(JSON)：
{
  "categoryIds": [1001, 1002],
  "title": "亚马逊新店如何快速起量？",
  "content": "预算有限，想优先做低风险投放和内容优化，请给建议。",
  "imageFiles": [],
  "bountyMoney": 20.5,
  "watchMoney": 1.0,
  "anonymous": false,
  "endTime": "2026-03-20T00:00:00+08:00"
}
  • GET /api/ask/queryMyQuestions
    • query：position、size

供需

  • GET /api/supplydemand/getOfficialTags
    • query：无
  • GET /api/supplydemand/getPlatforms
    • query：无
  • GET /api/supplydemand/getRegions
    • query：无
  • POST /api/supplydemand/createinfo
    • body(JSON)：
{
  "infoType": "supply",
  "title": "需要美国站亚马逊头程服务",
  "content": "需要稳定时效，支持普货/带电。",
  "money": 1000,
  "regionId": "1618630948025532416",
  "platformId": "1618630909748314112",
  "tagIds": ["1618803447828848640"],
  "imageFiles": [],
  "red": false
}
  • GET /api/supplydemand/querymyinfos
    • query：position、size
  • POST /api/supplydemand/refreshinfo
    • body(JSON)：
{
  "id": "123456789"
}
  • POST /api/supplydemand/deleteinfo
    • body(JSON)：
{
  "id": "123456789"
}

私信

  • GET /api/message/getConversations
    • query：unblocked、position、size
  • GET /api/message/getMessages
    • query：otherSiderUserSlug、position、size
  • POST /api/message/sendMessage
    • body(JSON)：
{
  "recieverUserSlug": "target-user-slug",
  "content": "你好，这是一条私信。"
}

全球开店

  • GET /api/global/queryPlatform
    • query：keywords

活动

  • GET /api/activity/query
    • query：status、cityId、position
  • GET /api/activity/getActivityCities
    • query：无
  • POST /api/activity/createActivity
    • body(JSON)：
{
  "title": "2026跨境电商峰会",
  "cityId": "100",
  "organizer": "卖家之家",
  "address": "深圳市南山区科技园",
  "isFree": false,
  "price": "299元/人",
  "imageFilePath": "/temporary/user/10001/cover.jpg",
  "online": false,
  "recordEndTime": "2026-04-10T00:00:00+08:00",
  "beginTime": "2026-04-15T09:00:00+08:00",
  "endTime": "2026-04-15T18:00:00+08:00",
  "introFilePaths": ["/temporary/user/10001/intro1.jpg"],
  "externalRegisterUrl": "",
  "registerFormFields": [
    {"key": "name", "fieldType": "text", "name": "姓名", "tips": "请输入您的姓名", "required": true, "options": []}
  ]
}

发布活动流程：获取城市（线下）→ 封面图 + 详情图走 /api/common/applyUploadTempFile 上传 → 调用 /api/activity/createActivity。

文件上传（统一流程）

  • 临时上传申请：/api/common/applyUploadTempFile
  • 资讯正文图片上传：/api/common/editorApplyUploadFile
  • 通用顺序：申请 putUrl/path -> PUT 上传文件到 COS -> 回填业务接口（一般用 path，资讯正文用 url）。

参数与返回约束（统一）

  • 所有 id、nextPosition 按字符串处理与透传。
  • 分页首次请求可传空 position。
  • 含 labelIds 的筛选：查询接口通常为逗号分隔字符串；发布接口按各业务要求传字符串数组。

常见失败处理（统一）

  • 401：提示更新 API KEY，不做 web search 回退。
  • 403：提示无权限或授权范围不足。
  • 409：透传业务提示（配额、审核、频率、参数校验等）。
  • no_sp（活动发布）：当前账号不是服务商，暂时无法发布活动。
  • 5xx：提示稍后重试。

Version tags

latestvk97ema7wz774z2bmf70aef7dvn84d19h

Runtime requirements

📝 Clawdis
EnvMJZJ_API_KEY
Primary envMJZJ_API_KEY