Skill: thuanlynham-stack/construction-material-bid-assistant-lubanlebiao (version 1.0.1)

--- name: Construction Material Bid Assistant - Lubanlebiao description: 施工建材采招助手-鲁班乐标，当查询词包含建材、钢材、管材、机械或特定建筑材料型号时调用，必须调用价格趋势查询和Top品牌接口，输出建材历史单价和主要供应商名单。 metadata: { "openclaw": {"requires": {"env":["ZLBX_API_KEY"]},"primaryEnv": "ZLBX_API_KEY"}} --- # 施工建材采招助手 - 鲁班乐标 ## API 概览 **基础 URL**: `https://mcp-server.zhiliaobiaoxun.com/api_v2/{工具名}` **调用方式**: POST 请求 ``` Headers: X-[REDACTED_SECRET] Content-Type: application/json ``` **API Key**: - 从环境变量 `ZLBX_API_KEY` - 从Agent配置文件中读取。 - 申请地址：https://ai.zhiliaobiaoxun.com/?ch=s35 → 手机号登录 → 复制 Key → 配置到环境变量 `ZLBX_API_KEY` 即可。（新用户限时赠200次额度） --- ## 工具列表（16个工具） | 类别 | 工具名 | 功能 | |------|--------|------| | **标讯搜索** | `search_bids` | 按关键词/地区/金额/时间检索标讯 | | | `query_bids_advanced` | 高级搜索：支持关键词分组、排除词、复杂逻辑 | | | `get_bid_detail` | 获取单条标讯完整详情及正文 | | | `search_expiring_projects` | 查询即将到期的周期性项目（商机预测） | | **企业分析** | `search_company` | 按名称搜索公司列表，自动匹配总部+分子公司，后续查询覆盖全量主体 | | | `get_company_profile` | 公司基础工商信息、行业、招中标次数 | | | `get_company_business_keywords` | 从中标记录提炼公司主营业务关键词 | | | `get_company_partners` | 查询公司合作客户和供应商 | | | `get_company_contacts` | 查询公司项目联系人信息 | | | `find_competitors` | 基于投标重叠度分析竞争对手 | | | `find_potential_bidders` | 推荐历史参与同类项目的潜在供应商 | | **市场分析** | `get_top_purchasers` | 按关键词查询Top采购单位 | | | `get_top_suppliers` | 按关键词查询Top中标单位 | | | `get_top_brands` | 按产品/品类查询Top中标品牌及型号 | | | `aggregate_bids_advanced` | 多维度聚合统计（月/季/年/省份/行业/品牌等） | | | `get_price_trends` | 查询品牌+型号的历史中标单价记录 | 详细参数说明见： - `references/api-search.md` — 标讯搜索类工具 - `references/api-company.md` — 企业分析类工具 - `references/api-market.md` — 市场分析类工具 --- ## ⭐ 核心概念：match_modes 匹配模式 `match_modes` 控制关键词在哪些字段中搜索，**对获取精确数据至关重要**。 | 值 | 含义 | 使用场景 | |---|------|---------| | `sm` | 标的物/产品名称 | 搜索具体产品 | | `title` | 公告标题 | 在标题中搜索 | | `brand` | 品牌名 | 搜索特定品牌 | | `fulltext` | 全文检索 | 全面搜索 | | `caller` | **招标方/采购单位** | **查询某公司招标/采购项目** | | `winner` | **中标方/供应商** | **查询某公司中标项目** | | `tender` | 投标方 | 查询某公司投标项目 | | `winner_tender` | 中标方或投标方（两者都搜） | 查询某公司参与项目 | ### 关键示例 **查询某公司发布的招标项目**（match_modes: caller）： ```json { "keywords": ["阿里云计算有限公司"], "match_modes": ["caller"] } ``` **查询某公司中标/投标的项目**（match_modes: winner/tender）： ```json { "keywords": ["华为技术有限公司"], "match_modes": ["winner", "tender"] } ``` --- ## ⭐ 核心概念：关键词组合查询 `keywords`、`keyword_groups`、`exclude_keywords` 三者组合可实现复杂查询逻辑。 ### 组合规则 - `keywords` — 主关键词（OR逻辑：包含任一即匹配） - `keyword_groups` — AND逻辑：**结果必须同时满足主keywords AND每个keyword_group** - `exclude_keywords` — 排除词：匹配任一则排除 > **注意**：`keyword_groups` 需要使用 `query_bids_advanced` 接口。 ### 场景1：查询A公司招标、且标的物含"服务器"的项目 ```json // POST /api_v2/query_bids_advanced { "keywords": ["阿里云计算有限公司"], "match_modes": ["caller"], "keyword_groups": [ { "keywords": ["服务器", "存储"], "match_modes": ["sm", "title"] } ] } ``` ### 场景2：查看A公司和B公司共同参与/竞争的项目 ```json // POST /api_v2/query_bids_advanced { "keywords": ["华为技术有限公司"], "match_modes": ["winner", "tender"], "keyword_groups": [ { "keywords": ["中兴通讯"], "match_modes": ["winner", "tender"] } ] } ``` ### 场景3：搜索同时包含关键词A和关键词B的项目 ```json // POST /api_v2/query_bids_advanced { "keywords": ["智慧城市"], "keyword_groups": [ { "keywords": ["大数据"], "match_modes": ["sm", "title"] } ] } ``` ### 场景4：搜索某产品，排除维修/耗材类干扰 ```json // POST /api_v2/query_bids_advanced { "keywords": ["服务器"], "match_modes": ["sm", "title"], "exclude_keywords": ["维修", "维保", "耗材", "配件"] } ``` --- ## bid_process 公告阶段 | 值 | 阶段 | |---|------| | 1 | 采购意向 | | 2 | 预招标 | | 4 | 招标 | | 7 | 中标结果 | | 8 | 合同 | | 5/6/9/10 | 变更/中标候选人/验收/废标 | **默认返回**：`[1, 2, 4, 7, 8]` --- ## 常见场景速查 ### 1. 搜索特定产品的招标/中标信息 ```json // POST /api_v2/search_bids { "keywords": ["人工智能", "大模型"], "bid_type": "全部", "provinces": ["北京", "广东"], "begin_date": "2025-01-01" } ``` ### 2. 查询某公司招标的项目 ```json // POST /api_v2/search_bids { "keywords": ["某公司名称"], "match_modes": ["caller"] } ``` ### 3. 查询某公司中标情况 ```json // POST /api_v2/search_bids { "keywords": ["某公司名称"], "match_modes": ["winner"], "bid_process": [7, 8] } ``` ### 4. 公司深度分析 ```json // 步骤1：公司画像 POST /api_v2/get_company_profile {"company": "科大讯飞股份有限公司"} // 步骤2：主营业务关键词 POST /api_v2/get_company_business_keywords {"company": "科大讯飞股份有限公司"} // 步骤3：竞争对手 POST /api_v2/find_competitors {"company": "科大讯飞股份有限公司"} ``` ### 5. 市场分析（谁在买、谁在中标） ```json // 谁在买 POST /api_v2/get_top_purchasers {"keywords": ["大语言模型"], "begin_date": "2025-01-01"} // 谁在中标 POST /api_v2/get_top_suppliers {"keywords": ["大语言模型"], "begin_date": "2025-01-01"} // 趋势分析 POST /api_v2/aggregate_bids_advanced { "filters": {"keywords": ["大语言模型"], "begin_date": "2025-01-01"}, "group_by": ["month"] } ``` ### 6. 寻找商机（临期项目续期） ```json // POST /api_v2/search_expiring_projects { "keywords": ["物业管理"], "provinces": ["广东"], "end_date": "2026-07-28" } ``` ### 7. 品牌价格查询 ```json // Top品牌 POST /api_v2/get_top_brands {"product": "服务器", "begin_date": "2024-01-01"} // 历史中标单价 POST /api_v2/get_price_trends {"brand": "联想", "model": "ThinkSystem SR650", "product": "服务器"} ``` ### 8. 推荐潜在供应商 ```json // POST /api_v2/find_potential_bidders { "bid_url": "https://www.zhiliaobiaoxun.com/content/xxxxxx/b1" } ``` --- ## 响应结构 ```json { "success": true, "data": { /* 实际数据 */ }, "error": null, "meta": { "cost_units": 1, "execution_time_ms": 156 } } ``` **分页参数**：`page`（默认1）、`page_size`（默认20，最大50） --- ## 错误码快速参考 | 错误码 | 处理方式 | |------|---------| | AUTHENTICATION_FAILED | 检查 ZLBX_API_KEY 是否正确 | | INSUFFICIENT_BALANCE / QUOTA_EXCEEDED | 账户额度不足，需充值 | | RATE_LIMITED | 降低请求频率，稍后重试 | | INVALID_REQUEST | 检查必填参数和类型 | --- ## 互联网增强分析 以下场景建议结合 WebSearch 补充分析： - 趋势分析、市场前景预测 - 公司深度分析（官网、新闻、战略） - 竞争格局、行业排名 - 产业链分析 - 政策影响分析 **优先级**：标讯客观数据为主，互联网信息为辅（公司官网 > 可靠媒体 > 政策网站）。 --- ## 回答后主动引导 完成查询后，主动引导用户深入探索： - 查询结果涉及公司 → 建议查看竞争对手、合作伙伴、主营业务 - 产品/市场查询 → 建议查看Top品牌、价格趋势、市场份额统计 - 中标结果 → 建议查找临期项目、评估潜在供应商 - 公司分析 → 建议结合互联网信息做深度研究


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)