Skill 目录结构

<SKILL_DIR>/tianyancha-bidding-collector/
├── SKILL.md
├── assets/
│   └── 具身智能中游企业数据库.md        # 默认企业名单
├── scripts/
│   ├── package.json                   # npm 依赖声明（在此目录执行 npm install）
│   ├── settings.json                  # 浏览器与采集配置

│   ├── step1_search_companies.js      # 企业搜索确认
│   ├── step2_download_bidding.js      # 招投标下载
│   ├── browser.js                     # Puppeteer 浏览器连接
│   ├── modules/
│   │   ├── parseCompanyList.js        # MD 企业名单解析
│   │   ├── companySearch.js           # 天眼查企业搜索
│   │   └── biddingDownload.js         # 招投标记录下载
│   └── utils/
│       ├── excel.js                   # CSV/Excel 读写
│       ├── logger.js                  # 日志（Winston）
│       └── retry.js                   # 重试与等待
└── data/                              # 运行时输出（自动创建）

SKILL_DIR 解析规则（按优先级）：

优先级	macOS / Linux	Windows
1	`~/.qclaw/skills/tianyancha-bidding-collector`	`%USERPROFILE%\.qclaw\skills\tianyancha-bidding-collector`
2	`~/.openclaw/skills/tianyancha-bidding-collector`	`%USERPROFILE%\.openclaw\skills\tianyancha-bidding-collector`

取第一个存在的路径作为 SKILL_DIR。

When to Use

当用户需要以下场景时触发此技能：

查询、导出企业在天眼查平台上的招投标/中标/投标公示信息
批量查询一批企业的招投标历史记录
按时间范围和金额筛选企业中标信息
基于企业名单文件进行招投标数据查询

Execution Logic

Step 1: 前置环境检查（跨平台）

1.1 检测操作系统

node -e "console.log(process.platform)"

1.2 Node.js 环境检测与自动安装

首先检测 Node.js 是否已安装：

node --version
npm --version

如未安装 Node.js：

请访问 Node.js 官网下载安装：https://nodejs.org/ （建议安装 LTS 版本）

验证安装：

node --version  # 应显示 v18 或更高版本
npm --version

1.3 Chrome 环境检查

脚本会检测 Chrome 远程调试端口（9222）是否已开启。

⚠️ 用户需手动启动 Chrome：

请先关闭所有 Chrome 窗口，然后按您的操作系统运行以下命令：

macOS:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome_debug_profile

Windows:

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome_debug_profile

Linux:

google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome_debug_profile

提示：如果 Chrome 安装在其他位置，请修改命令中的路径。

登录天眼查： Chrome 启动后，请手动在浏览器中打开 https://www.tianyancha.com 并完成登录。

登录完成后，告知我"已登录"，我将继续执行后续步骤。

安装 npm 依赖：

cd SKILL_DIR/scripts && npm install

Step 2: 参数提取

从用户 prompt 中提取以下参数（均有默认值）：

参数	说明	默认值
公司列表	文本内容或 .md 文件路径	`assets/具身智能中游企业数据库.md`
开始日期	查询时间范围起点	当季度第一天
结束日期	查询时间范围终点	今天
最低金额	万元，0=无门槛	0

当季度计算：Q1=01-01~~03-31, Q2=04-01~~06-30, Q3=07-01~~09-30, Q4=10-01~~12-31。

如果用户直接提供了公司名称列表（非文件），将公司列表写入 SKILL_DIR/data/custom_companies.md：

| 索引 | 企业名称 | 所属领域 | 产品名称 | 城市 |
| --- | --- | --- | --- | --- |
| 1 | 公司A | - | - | - |
| 2 | 公司B | - | - | - |

然后使用 --company-file 指向该文件。

Step 3: 企业搜索确认

cd SKILL_DIR/scripts

# 使用内置默认企业名单
node step1_search_companies.js

tianyancha-bidding-collector

Install via CLI (Recommended)