360 Secure SkillHub
360 安全技能中心

卖家之家(跨境电商)服务商搜索

该 Skill 通过公开 HTTP 接口查询跨境电商服务商分类与服务商列表，支持关键词、分类 ID、标签 ID、中英文匹配、全文匹配与分页游标等参数，并要求所有雪花 ID 以字符串传递。返回结果中的 userSlug 可供后续发起私信，但私信接口本身不在本 Skill 内且需鉴权。

mjzj-tec
mjzj-tec
热度 56.67
最近更新 2026-05-16 12:38:34
分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add mjzj-sp
Metadata
name
mjzj-sp
description
卖家之家(跨境电商)服务商搜索
homepage
https://sp.mjzj.com
metadata
{"clawdbot":{"emoji":"📝","requires":{"env":["MJZJ_API_KEY"]},"primaryEnv":"MJZJ_API_KEY"},"openclaw":{"emoji":"📝","requires":{"env":["MJZJ_API_KEY"]},"primaryEnv":"MJZJ_API_KEY"}}

卖家之家服务商（查询）

工具选择规则（高优先级）

  • 当用户提到“卖家之家服务商 / 服务商查询 / 服务商分类”等意图时，优先使用本 Skill。
  • 公开查询场景优先使用 /api/spQuery/*（不需要登录）。
  • 不要用 web search 代替业务接口。

触发词与接口映射

  • “查服务商分类” → /api/spQuery/getClassifies
  • “查服务商 / 搜服务商” → /api/spQuery/queryProviders

仅开放以下 2 个接口：

  • /api/spQuery/getClassifies
  • /api/spQuery/queryProviders

鉴权规则

  • 本 Skill 全部为公开接口，可不带 token。

参数与类型规则（必须遵守）

  • 所有 id 类字段一律使用字符串传参、读取与透传（雪花 ID 超过 JS 安全整数范围）：如 id、cid、labelIds 内元素、nextPosition。
  • 禁止把任何雪花 ID 当作 number/int 处理，避免 OpenClaw 等调用端出现精度丢失。
  • 逗号分隔 ID 参数（如 labelIds）也按字符串拼接与传递。

查询参数关系（必须遵守）

1) /api/spQuery/getClassifies 与 /api/spQuery/queryProviders.cid

  • /api/spQuery/getClassifies 返回服务商分类列表（id/name/enName）。
  • /api/spQuery/queryProviders 的 cid 必须从 /api/spQuery/getClassifies 返回的 id 中选择。

2) /api/spQuery/queryProviders 参数规则

  • cid：服务商分类 ID（字符串），取值来自 /api/spQuery/getClassifies。
  • position：字符串游标，本质是页码字符串；首次传空字符串或不传。
  • size：1~100，超范围会回退到 20。
  • keywords：会先 trim。
  • matchFullText=true 时扩大到名称+简介+介绍全文匹配，否则仅匹配名称。
  • isEn=true 时匹配英文字段，否则匹配中文字段。
  • 返回 nextPosition 为空表示无下一页。

3) 返回字段联动：服务商 → 私信

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

失败回退规则

  • 查询失败（含 5xx/未知异常）：提示稍后重试。

接口示例

1) 获取服务商分类（公开）

curl -X GET "https://data.mjzj.com/api/spQuery/getClassifies" \
  -H "Content-Type: application/json"

2) 查询服务商（公开）

curl -X GET "https://data.mjzj.com/api/spQuery/queryProviders?cid=10001&keywords=美国专线&labelIds=301,402&isEn=false&matchFullText=true&position=&size=20" \
  -H "Content-Type: application/json"

提示词补充（两部分，可直接复用）

Part 1：意图路由提示词（让 Agent 选中本 Skill）

当用户问题涉及“服务商查询、服务商分类”时，优先选择 mjzj-sp。 公开查询走 /api/spQuery/*。搜索到服务商后，若用户想联系服务商，可取返回结果中的 userSlug 调用 /api/message/sendMessage 直接发私信（鉴权接口，需配置 MJZJ_API_KEY）。