猪八戒网官方技能

猪八戒网(ZBJ) MCP服务器 - AI智能需求发布、订单管理、服务搜索、类目匹配，连接百万服务商的一站式威客平台

Install

openclaw skills install @nylk/zbj

猪八戒网(ZBJ) MCP 官方技能 🚀

基于 Model Context Protocol (MCP) 构建的猪八戒网官方集成，让 AI Agent 能够智能管理需求发布、订单处理、服务搜索和类目匹配，连接中国最大的服务交易平台。

🎯 核心功能

✅ 智能需求管理 - 发布/修改/关闭需求、选标中标、淘汰服务商 ✅ 订单全流程 - 查询详情、评价服务商、获取托管支付链接 ✅ 全平台搜索 - 服务商品、店铺、需求三维搜索 ✅ AI类目匹配 - 智能识别需求类型，推荐最佳服务类目

18 个工具 + 2 个资源，覆盖需求管理、订单管理、搜索服务、类目服务 4 大功能模块。

安装

自动安装（推荐）

bash

# Clawhub 会自动执行 npm install
# 只需配置 API Key
export ZBJ_API_KEY="your_api_key_here"  # 从 https://account.zbj.com/setting/mcpapikey 获取

手动安装

bash

# 1. 进入技能目录
cd ~/.openclaw/skills/zbj

# 2. 安装依赖
npm install

# 3. 配置环境变量
export ZBJ_API_URL="https://zmcp.zbj.com"  # 可选，默认值
export ZBJ_API_KEY="your_api_key_here"     # 必填

依赖说明：

axios ^1.7.7 - HTTP 请求库
Node.js 18+ - 运行环境

🔐 安全说明

最小权限原则

本技能严格遵循最小权限原则：

✅ 网络访问：仅允许 zmcp.zbj.com:443（猪八戒网官方 API）
✅ 执行权限：仅允许运行 node 和 npm
✅ 沙箱隔离：强制启用沙箱模式
✅ 非自主运行：需要用户明确调用，不会自动执行
❌ 无文件系统读写权限
❌ 无系统级权限
❌ 无高危操作权限

API Key 安全建议

使用专用 API Key：为此技能创建独立的 API Key
最小权限：仅授予需求发布、订单管理等必要权限
定期轮换：建议每 90 天更换一次 API Key
环境变量：不要在代码中硬编码 API Key
安全存储：使用系统密钥链或加密配置存储

数据隐私

所有 API 调用通过 HTTPS 加密传输
不会在本地缓存敏感信息（除类目数据）
不会向第三方服务发送数据

🎬 适用场景

企业级应用

🏢 智能采购助手 - 企业 AI 助手自动发布外包需求，管理服务商对接
📊 订单管理系统 - 集成到企业 ERP，自动化订单跟踪和状态同步
💼 供应商管理 - 批量搜索、评估、选择服务商，构建供应商库

AI Agent 集成

🤖 智能客服机器人 - 用户咨询时自动推荐服务、报价、发布需求
🔍 需求分析引擎 - 自然语言理解需求，自动匹配类目和服务商
📈 数据分析助手 - 分析平台服务趋势、价格区间、服务商评价

开发者工具

🌐 多平台聚合 - 整合猪八戒网到统一服务采购平台
🔗 工作流自动化 - 与 Slack、飞书、企业微信集成，自动化通知和审批
📱 移动应用集成 - 企业 App 内嵌服务交易能力

工具列表（18个工具，4个模块）

需求管理（8个）

工具名	功能说明
publish_demand	发布或修改需求，传入 demandId 则为修改
get_demand_detail	查询需求详情（含投标情况）
close_demand	关闭需求
pause_demand	暂停需求
open_demand	公开已暂停的需求
eliminate_seller	淘汰服务商
select_winner	选服务商中标
search_demands	搜索需求（支持状态筛选）

订单管理（5个）

工具名	功能说明
get_order_detail	查询订单详情
search_orders	搜索订单
eval_seller	评价已完成订单的服务商
close_order	关闭订单
get_trusteeship_pay_url	获取托管支付地址

搜索服务（2个）

工具名	功能说明
search_services	搜索服务商品
search_shops	搜索店铺/服务商

类目服务（2个）

工具名	功能说明
get_categories	获取类目列表（支持层级筛选）
search_category	根据关键词搜索匹配类目

系统工具（1个）

工具名	功能说明
health_check	检查后端服务健康状态

资源列表（2个）

URI	描述	MIME 类型
`zbj://config`	系统配置信息	application/json
`zbj://categories`	所有服务类目数据（AI 智能识别用）	application/json

💡 真实使用案例

案例 1：企业官网开发需求发布（完整流程）

场景：创业公司需要找服务商开发企业官网

typescript

// 1. AI 智能识别类目
用户："帮我找能做企业网站的服务商"
→ search_category({"keyword": "网站建设"})
→ 返回：categoryId=1001, name="网站建设"

// 2. 发布需求
→ publish_demand({
    "title": "开发响应式企业官网",
    "description": "需要PC+移动端自适应，包含首页、产品介绍、新闻资讯等5个页面",
    "categoryId": 1001,
    "price": 8000,
    "deadline": "2026-04-30"
  })
→ 返回：demandId=12345

// 3. 查看投标情况
→ get_demand_detail({"demandId": 12345})
→ 返回：已有 8 家服务商投标

// 4. 选择中标服务商
用户："选择报价 7500 的那家"
→ select_winner({"demandId": 12345, "sellerId": 67890})

案例 2：Logo 设计服务搜索与下单

场景：需要为新品牌设计 Logo

typescript

// 1. 搜索 Logo 设计服务
用户："找一些 Logo 设计服务，预算 2000 以内"
→ search_services({
    "keyword": "logo设计",
    "minPrice": 500,
    "maxPrice": 2000,
    "pageSize": 10
  })

// 2. 搜索优质设计师店铺
→ search_shops({
    "keyword": "品牌设计",
    "sort": "rating"  // 按评分排序
  })

// 3. 查看订单详情
→ get_order_detail({"orderId": "ORD20260327001"})

// 4. 获取支付链接
→ get_trusteeship_pay_url({
    "orderId": "ORD20260327001",
    "hostedPrice": 1800,
    "clientType": "h5"
  })

案例 3：订单管理与服务商评价

场景：项目完成后进行评价

typescript

// 1. 查询所有进行中的订单
→ search_orders({
    "status": "IN_PROGRESS",
    "pageNum": 1
  })

// 2. 查看订单详情
→ get_order_detail({"orderId": "ORD20260320005"})

// 3. 项目完成，评价服务商
用户："项目做得不错，给个好评"
→ eval_seller({
    "orderId": "ORD20260320005",
    "rating": 5,
    "comment": "设计稿很满意，沟通顺畅，交付及时，推荐！",
    "tags": ["设计专业", "沟通顺畅", "交付及时"]
  })

案例 4：AI 智能需求助手

对话式交互示例：

text

用户："我想做一个小程序商城"

AI：正在为您匹配最合适的服务类目...
   → search_category({"keyword": "小程序开发"})

   已找到类目：【移动应用开发 > 小程序开发】

   为您搜索相关服务商...
   → search_services({"keyword": "小程序商城", "pageSize": 5})

   找到 156 个相关服务，推荐以下 5 家：
   1. XX科技 - ¥8,000 起 ⭐4.9 (已服务 320 单)
   2. XX工作室 - ¥6,500 起 ⭐4.8 (已服务 180 单)
   ...

   是否需要我帮您发布需求，让服务商主动报价？

用户："好的，预算 1 万以内，要求支持拼团和优惠券"

AI：正在为您发布需求...
   → publish_demand({
       "title": "小程序商城开发",
       "description": "需要开发微信小程序商城，包含商品展示、购物车、订单管理、拼团功能、优惠券系统",
       "categoryId": 2103,
       "price": 10000
     })

   ✅ 需求发布成功！需求编号：#12346
   已通知平台服务商，预计 24 小时内开始收到报价。

🛠️ 快速开始

bash

# 健康检查
/run zbj health_check '{}'

# 搜索类目
/run zbj search_category '{"keyword":"网站"}'

# 发布需求
/run zbj publish_demand '{"title":"开发企业官网","description":"需要开发响应式企业官网","categoryId":1001,"price":5000}'

# 搜索服务
/run zbj search_services '{"keyword":"logo设计","pageNum":1,"pageSize":20}'

获取 API Key

1. 访问 API Key 管理页面

https://account.zbj.com/setting/mcpapikey

2. 创建专用 API Key

为此技能创建独立的 API Key（便于管理和撤销）
设置合理的权限范围：
- ✅ 需求发布与管理
- ✅ 订单查询与管理
- ✅ 服务搜索
- ✅ 类目查询
- ❌ 不需要账户管理等其他权限

3. 配置环境变量

bash

# Linux/macOS
export ZBJ_API_KEY="your_api_key_here"

# Windows PowerShell
$env:ZBJ_API_KEY="your_api_key_here"

# Windows CMD
set ZBJ_API_KEY=your_api_key_here

4. 验证配置

bash

# 运行健康检查
/run zbj health_check '{}'

# 应该返回：{"status":"ok","message":"ZBJ MCP service is running"}

环境变量

变量名	说明	必填	默认值	安全建议
ZBJ_API_URL	后端 API 地址	否	https://zmcp.zbj.com	使用官方地址，除非有私有部署
ZBJ_API_KEY	API 认证密钥	✅ 是	-	使用专用 Key，定期轮换，最小权限
ZBJ_API_TIMEOUT	API 请求超时时间 (ms)	否	30000	根据网络情况调整，建议 10000-60000

🔧 故障排查

常见问题

1. API Key 未配置

text

Error: ZBJ_API_KEY is not set

解决方案：设置环境变量 export ZBJ_API_KEY="your_key"

2. 网络连接失败

text

Error: connect ETIMEDOUT

解决方案：

检查网络连接
验证防火墙是否允许访问 zmcp.zbj.com:443
尝试增加超时时间 export ZBJ_API_TIMEOUT=60000

3. API Key 权限不足

text

Error: 403 Forbidden

解决方案：在 API Key 管理页面检查并更新权限

4. 依赖安装失败

text

Error: Cannot find module 'axios'

解决方案：手动运行 npm install

📊 技术栈与兼容性

核心依赖

TypeScript 5.3+
@modelcontextprotocol/sdk 1.0+
Node.js 18+ (推荐 20 LTS)
Zod 3.22+ (参数验证)
axios ^1.7.7 (HTTP 客户端)

平台兼容性

✅ macOS (Intel & Apple Silicon)
✅ Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
✅ Windows 10/11 (需要 Node.js 18+)
✅ Docker / 容器环境

📝 更新日志

v0.1.0 (2026-03-27)

🎉 首次发布
✅ 实现 18 个工具（需求管理、订单管理、搜索、类目）
✅ 提供 2 个资源（配置、类目数据）
✅ 添加自动安装机制
✅ 强制沙箱隔离，最小权限原则
✅ 完善安全说明和故障排查文档

🤝 贡献与支持

报告问题

遇到问题？请访问：

GitHub Issues: https://github.com/zbj/zbj-mcp/issues
官方文档: https://zmcp.zbj.com/docs

功能建议

欢迎提交功能建议和改进意见！

开源协议

MIT License - 可自由使用、修改、分发

⚠️ 免责声明

本技能为第三方集成工具，非猪八戒网官方客户端
使用本技能前请阅读并同意猪八戒网服务条款
请妥善保管 API Key，避免泄露造成损失
建议在测试环境验证后再用于生产环境
作者不对因使用本技能造成的任何损失负责

猪八戒网官方技能

Install

猪八戒网(ZBJ) MCP 官方技能 🚀

🎯 核心功能

安装

自动安装（推荐）

手动安装

🔐 安全说明

最小权限原则

API Key 安全建议

数据隐私

🎬 适用场景

企业级应用

AI Agent 集成

开发者工具

工具列表（18个工具，4个模块）

需求管理（8个）

订单管理（5个）

搜索服务（2个）

类目服务（2个）

系统工具（1个）

资源列表（2个）

💡 真实使用案例

案例 1：企业官网开发需求发布（完整流程）

案例 2：Logo 设计服务搜索与下单

案例 3：订单管理与服务商评价

案例 4：AI 智能需求助手

🛠️ 快速开始

获取 API Key

1. 访问 API Key 管理页面

2. 创建专用 API Key

3. 配置环境变量

4. 验证配置

环境变量

🔧 故障排查

常见问题

1. API Key 未配置

2. 网络连接失败

3. API Key 权限不足

4. 依赖安装失败

📊 技术栈与兼容性

核心依赖

平台兼容性

📝 更新日志

v0.1.0 (2026-03-27)

🤝 贡献与支持

报告问题

功能建议

开源协议

⚠️ 免责声明

Related skills