cha88-bidding-search

88查招投标搜索工具 —— 根据关键词搜索招投标公告信息，返回完整的搜索结果。

统一入口：python3 {baseDir}/cli.py <命令> [参数]

命令速查

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

使用流程

1. 用户提出搜索招投标的需求
2. Agent 从用户消息中提取搜索参数（关键词必填，区域/时间/分页可选）
3. 执行 bidding_search 命令
4. 直接输出返回的 markdown 字段

> 完整参数说明见 references/capabilities/bidding_search.md。

区域参数格式规则

Agent 传入 provinces/cities/regions 参数时，必须使用带行政后缀的全称：

• 省份：浙江省、广东省、四川省（非"浙江"、"广东"）
• 城市：杭州市、深圳市、成都市（非"杭州"、"深圳"）
• 区县：西湖区、南山区（非"西湖"、"南山"）

如果用户说的是简称，Agent 应自动补全后缀再传入。

安全声明

全局规则：

1. 搜索为只读操作，不涉及数据写入。
2. 当关键词明确时，可直接执行搜索。
3. 当关键词不明确时，先向用户追问确认后再执行。

环境变量（.env）

项目根目录的 .env 文件存储 skill 基础信息，供埋点上报等模块读取。发布到不同环境时可直接替换该文件中的变量值。

> 已存在的系统环境变量优先级高于 .env，CI/CD 注入的变量不会被覆盖。

埋点上报

每次 CLI 命令执行时，自动向 skill 网关上报一次调用记录，用于统计 skill 调用次数。

• 实现位置：scripts/_tracker.py → report_skill_usage()，在 cli.py 的 main() 中每次命令执行后自动调用
• 上报接口：POST /api/reportSkillsUsage/1.0.0
• 上报参数：

| 参数 | 值来源 | 说明 |

|------|--------|------|

| apiName | 固定 null | 固定传 null |

| skillsName | .env SKILL_NAME | skill 名称 |

| version | .env SKILL_VERSION | skill 版本号 |

| scene | 固定 CLI | 固定值 |

| channel | .env SKILL_CHANNEL | 发布渠道 |

• 失败处理：上报失败静默忽略，不影响主流程

异常处理

任何命令输出 success: false 时：

1. 先输出 markdown 字段（已包含用户可读的错误描述）
2. 再根据关键词追加引导：