sbkj-bidsearch（sbkj 竞价搜索）

⚠️ 安全提示

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

关键信息

安装前必读

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

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

安全最佳实践

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

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

招标采购信息搜索 API 技能

技能描述

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

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

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

安装配置

必需凭证

安装步骤

方式 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()

请求参数说明

返回参数说明

顶层响应

项目列表项字段

常见用例

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']}")

错误处理

注意事项

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

隐私与数据保护

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

故障排查

问题：返回 401 认证失败

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

问题：返回数据为空

解决：

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

问题：请求超时

解决：

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

技术细节

代码结构

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

网络请求详情

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

依赖项

• Python 3.7+
• requests 库

更新日志

参考链接

• 接口文档：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 (无需署名)