卖家之家服务商查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/mjzj-tec-mjzj-sp-103。
技能介绍
要解决的问题
在卖家之家生态里找服务商时,分类 ID、分页游标和雪花 ID 若用错类型,列表会空页或精度错乱。用通用网页搜索也拿不到站内结构化字段(分类、简介、userSlug),更没法在选中后直接发起私信。
技能如何工作
当用户表达「查服务商分类」「搜服务商」等意图时,应路由到本技能,走公开 /api/spQuery/* ,而不是 web search。
- 分类:调用
GET /api/spQuery/getClassifies,得到id/name/enName;后续查询里的cid只能从这里取。 - 列表:调用
GET /api/spQuery/queryProviders,用字符串形式的cid、position(首页传""或不传)、size(1~100,超限回退 20)、keywords(会 trim),可选matchFullText、isEn;nextPosition为空表示没有下一页。 - 联系服务商:结果中的
userSlug可直接作为/api/message/sendMessage的recieverUserSlug(需MJZJ_API_KEY,见 mjzj-msg 技能),典型链路是搜服务商 → 用户点名 → 发私信。
边界与注意点
仅开放上述两个查询接口,且无需 token。所有 id、cid、labelIds 元素、nextPosition 必须用字符串传递,禁止当 number 处理。查询 5xx 或未知异常时提示稍后重试;发私信不属于本技能鉴权范围。
使用场景
- 选物流或代运营前,先按分类拉卖家之家服务商列表并对比简介
- 用户给出英文服务商名,用 isEn 与 keywords 在站内精确搜候选
- 分页浏览某 cid 下全部服务商,用 position 与 nextPosition 翻页
- 搜到目标服务商后,用返回的 userSlug 准备走站内私信沟通
适合人员
- 跨境卖家运营,需要在卖家之家站内按品类筛选合规服务商
- 对接 MJZJ 的 Agent 集成者,要把「查分类/搜服务商」固定走 spQuery 而非搜索
- 社区或客服机器人,帮用户翻页检索服务商并在选中后衔接私信
- 维护 OpenClaw 等调用方的工程师,必须避免雪花 ID 被当成 number 传参