SkillHub

mjzj-wuliu

v1.0.0

卖家之家跨境电商物流海外仓搜索

Sourced from ClawHub, Authored by mjzj-tec

Installation

Please help me install the skill `mjzj-wuliu` from SkillHub official store. npx skills add mjzj-tec/mjzj-wuliu

卖家之家物流服务商（查询）

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

  • 当用户提到“物流服务商 / 国际物流 / 头程 / 海外仓 / 专线 / 清关 / 物流标签 / 查询物流商”等意图时，优先使用本 Skill。
  • 公开查询场景统一走 /api/spQuery/*，且物流商查询必须使用 /api/spQuery/queryLogisticsProviders。
  • 不要用 web search 代替业务接口。

触发词与接口映射

  • “查物流服务商标签分组” → /api/spQuery/getLogisticsLabels
  • “查物流服务商 / 搜物流商” → /api/spQuery/queryLogisticsProviders

仅开放以下 2 个接口： - /api/spQuery/getLogisticsLabels - /api/spQuery/queryLogisticsProviders

鉴权规则

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

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

  • 所有接口中的 id（含返回值与入参中的各类 ID）都按字符串读取、存储与透传。
  • 雪花 ID 禁止用整数处理，避免在部分调用端出现精度丢失。
  • 逗号分隔 ID 参数（如 labelIds）也按字符串拼接与传递。

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

1) /api/spQuery/getLogisticsLabels 与 /api/spQuery/queryLogisticsProviders.labelIds

  • /api/spQuery/getLogisticsLabels 返回物流相关标签分组（物流类型/揽收方式/渠道/目的地/业务类型）。
  • /api/spQuery/queryLogisticsProviders.labelIds 为逗号分隔字符串（如 "301,402"），ID 来源必须是 /api/spQuery/getLogisticsLabels。
  • 筛选语义：
  • 同一分组内：OR（命中任意一个标签即可）
  • 不同分组间：AND（每个已选择分组都要命中）

2) /api/spQuery/queryLogisticsProviders 共同参数规则

  • position：字符串游标，本质是页码字符串；首次传空字符串或不传。
  • size：1~100，超范围会回退到 20。
  • keywords：会先 trim。
  • 返回 nextPosition 为空表示无下一页。

3) /api/spQuery/queryLogisticsProviders 差异参数

  • matchFullText=true 时扩大到名称+简介+介绍全文匹配，否则仅匹配名称。
  • isEn=true 时匹配英文字段，否则匹配中文字段。

失败回退规则

  • 查询失败（含 5xx/未知异常）：提示稍后重试。
  • 不要在失败时改走 web search。

接口示例

1) 获取物流标签分组（公开）

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

2) 查询物流服务商（公开）

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

提示词补充（可直接复用）

当用户问题涉及“物流服务商查询、物流标签分组、海外仓/专线筛选”等意图时，优先选择 mjzj-wuliu。 先调用 /api/spQuery/getLogisticsLabels 获取可选标签，再调用 /api/spQuery/queryLogisticsProviders 查询；不要改用 /api/spQuery/queryProviders。