全国招中标信息、政府采购项目查询-保标招标

全国招标中标采购信息搜索 - 保标招标 - 支持多条件筛选的招投标数据搜索，返回项目金额、甲方、乙方、代理机构、采集源网址等核心字段。

Install

openclaw skills install sbkj-bidsearch

⚠️ 安全提示

本技能会向外部 API 发送 HTTP 请求

关键信息

项目	说明
API 端点	`https://gate.gov-bid.com/outer-gateway/bid/SearchProjectForAI`
请求方式	POST (JSON)
凭证要求	`BID_API_KEY` (必需)
数据来源	第三方招标采购信息服务
执行代码	`scripts/bid_search.py`

安装前必读

请确认以下事项后再安装：

✅ 您已从合法渠道获取 API 访问密钥
✅ 您信任 API 服务提供商 (gate.gov-bid.com)
✅ 您已审查技能代码（特别是 scripts/bid_search.py）
✅ 您了解技能会向外部服务器发送您的 API 密钥
✅ 您已在安全环境中测试或限制 API 密钥权限

安全最佳实践

# 1. 使用环境变量管理密钥（不要硬编码）
export BID_API_KEY="your_api_key_here"

# 2. 限制 API 密钥权限（如服务商支持）
# 3. 定期轮换密钥
# 4. 在生产环境使用前先测试
# 5. 监控 API 使用情况

招标采购信息搜索 API 技能

技能描述

封装第三方招标采购信息搜索接口，专为 AI 模型设计，支持多条件筛选的招投标数据搜索。

数据覆盖： 招标信息、中标信息、合同信息、采购意向、拍租信息等

返回核心字段： 项目金额、甲方信息、乙方信息、代理机构、合同到期时间等

安装配置

必需凭证

凭证名	说明	是否必需	示例
`BID_API_KEY`	API 访问密钥	✅ 是	`AK729447427d63c2320ff44c7a`
`BID_SERVER_URL`	API 服务器地址	❌ 否	`https://gate.gov-bid.com`

安装步骤

方式 1：环境变量

export BID_API_KEY="your_api_key_here"
export BID_SERVER_URL="https://gate.gov-bid.com"

方式 2：Hermes 凭证管理（推荐）

# ~/.hermes/config.yaml
credentials:
  BID_API_KEY: "your_api_key_here"
  BID_SERVER_URL: "https://gate.gov-bid.com"

方式 3：技能安装时配置

skill_install sbkj-bidsearch

验证安装

skill_view sbkj-bidsearch

使用方法

基本搜索

from hermes_tools import terminal

result = terminal('''
python3 << 'EOF'
from skill_view import get_credential
import requests

api_key = get_credential("BID_API_KEY")
url = f"https://gate.gov-bid.com/outer-gateway/bid/SearchProjectForAI?key={api_key}"

payload = {
    "keyword": "工程",
    "className": "招标信息",
    "startDate": "2025-01-10",
    "endDate": "2025-01-17",
    "pageId": 1,
    "pageNumber": 20
}

response = requests.post(url, json=payload)
data = response.json()

if data.get("code") == 200:
    print(f"找到 {data['data']['total']} 条记录")
else:
    print(f"错误：{data.get('msg')}")
EOF
''')

Python 函数封装

def search_bid_projects(
    keyword=None,
    exclude_kw=None,
    include_kw=None,
    class_name=None,
    area_name=None,
    search_field="全部",
    start_date=None,
    end_date=None,
    page_id=1,
    page_number=20
):
    """搜索招标采购项目"""
    from skill_view import get_credential
    import requests
    
    api_key = get_credential("BID_API_KEY")
    server_url = get_credential("BID_SERVER_URL") or "https://gate.gov-bid.com"
    
    url = f"{server_url}/outer-gateway/bid/SearchProjectForAI?key={api_key}"
    
    payload = {
        "startDate": start_date,
        "endDate": end_date,
        "pageId": page_id,
        "pageNumber": page_number
    }
    
    if keyword: payload["keyword"] = keyword
    if exclude_kw: payload["excludeKW"] = exclude_kw
    if include_kw: payload["inCludeKW"] = include_kw
    if class_name: payload["className"] = class_name
    if area_name: payload["areaName"] = area_name
    if search_field: payload["searchField"] = search_field
    
    response = requests.post(url, json=payload, timeout=30)
    return response.json()

请求参数说明

参数名	必填	类型	说明
keyword	否	string	搜索关键词：空格=同时出现，竖线=或关系
excludeKW	否	string	排除关键词，多个用竖线分隔
inCludeKW	否	string	必须包含关键词，多个用竖线分隔
className	否	string	项目类别：全部信息/招标信息/中标信息/合同信息/采购意向/拍租信息
areaName	否	string	项目归属地区名称（如"武汉"）
searchField	否	string	搜索字段：标题、内容、全部（默认"全部"）
startDate	✅	string	发布开始日期，格式：yyyy-MM-dd
endDate	✅	string	发布结束日期，格式：yyyy-MM-dd
pageId	✅	int	当前页码
pageNumber	✅	int	每页记录数（最大 100，设为 0 仅返回总数）

返回参数说明

顶层响应

参数名	类型	说明
code	int	接口响应状态码（200=成功）
msg	string	响应信息
subCode	string	业务侧 code
subMsg	string	业务侧 msg
data	object	业务数据

项目列表项字段

字段	说明
id	项目 ID
title	项目标题
newsTypeName	信息类型名称
publishTime	发布时间
areaName	地区（省/市/区）
projectMoney	项目金额
projectClass	项目类别
purchaseType	采购类型
partAInfo	甲方信息数组（name, contactPhone, email）
partBInfo	乙方信息数组
agencyInfo	代理机构信息数组

常见用例

1. 获取某地区最新招标公告

result = search_bid_projects(
    class_name="招标信息",
    area_name="上海",
    start_date="2025-01-15",
    end_date="2025-01-17"
)

2. 搜索特定关键词的中标信息

result = search_bid_projects(
    keyword="智慧城市",
    class_name="中标信息",
    start_date="2025-01-01",
    end_date="2025-01-17"
)

3. 排除特定关键词

result = search_bid_projects(
    keyword="空调",
    exclude_kw="维修 | 保养",
    class_name="招标信息",
    start_date="2025-01-10",
    end_date="2025-01-17"
)

4. 仅获取结果总数

result = search_bid_projects(
    keyword="工程",
    start_date="2025-01-01",
    end_date="2025-01-17",
    page_number=0
)
print(f"总数：{result['data']['total']}")

错误处理

状态码	说明	处理建议
200	成功	正常处理返回数据
401	认证失败	检查 BID_API_KEY 是否正确
403	权限不足	联系 API 服务提供商
500	服务器错误	稍后重试
504	网关超时	检查网络或稍后重试

注意事项

API Key 安全：不要将 API Key 硬编码在代码中
请求频率：建议控制请求频率，避免触发限流
日期格式：必须使用 yyyy-MM-dd 格式
分页限制：pageNumber 最大值为 100
关键词语法：空格=AND，竖线=OR

隐私与数据保护

数据传输：所有请求通过 HTTPS 加密传输
凭证存储：API Key 存储在本地凭证管理系统或环境变量中
日志记录：技能本身不记录请求日志

故障排查

问题：返回 401 认证失败

解决：检查 BID_API_KEY 是否正确配置

问题：返回数据为空

解决：

检查日期范围是否合理
尝试放宽搜索条件
设置 pageNumber=0 先查看是否有匹配记录

问题：请求超时

解决：

检查网络连接
增加请求超时时间
减少 pageNumber 值

技术细节

代码结构

sbkj-bidsearch/
├── SKILL.md
└── scripts/
    └── bid_search.py

网络请求详情

协议: HTTPS
方法: POST
Content-Type: application/json
超时: 30 秒

依赖项

Python 3.7+
requests 库

更新日志

版本	日期	变更
1.0.1	2026-04-22	更新许可证为 MIT-0，更新 homepage
1.0.0	2026-04-21	初始版本

参考链接

接口文档：http://faq.zhvac.com/web/#/p/50f55291c248b58163e9ae4aa178eb12
官方网站：https://www.bog-bid.com
API 端点：https://gate.gov-bid.com

最后更新: 2026-04-22
技能版本: 1.0.1
许可证: MIT-0 (无需署名)