百度千帆搜索技能 (Baidu Qianfan Search)
重要提示：这是百度千帆搜索API，不是普通的百度网页搜索。 百度千帆搜索是百度智能云千帆平台的企业级搜索API，需要单独申请API Key。
前置要求
1. API Key配置（首次使用前必须配置）
首次使用前必须配置你的百度千帆API Key，方式如下：
方式1：环境变量（推荐）
export BAIDU_QIANFAN_API_KEY="你的百度千帆API Key"
方式2：配置文件
在技能目录创建 .env 文件：
BAIDU_QIANFAN_API_KEY=你的百度千帆API Key
2. 如何获取API Key
- 访问 https://cloud.baidu.com/
- 登录后进入千帆平台
- 创建应用并获取AppBuilder API Key（格式：
bce-v3/ALTAK-xxxxx）
快速开始
基础搜索
node {baseDir}/scripts/search.mjs "搜索关键词"
指定结果数量
node {baseDir}/scripts/search.mjs "搜索关键词" -n 10
时间范围搜索
# 最近7天
node {baseDir}/scripts/search.mjs "搜索关键词" --time week
# 最近30天
node {baseDir}/scripts/search.mjs "搜索关键词" --time month
# 过去48小时
node {baseDir}/scripts/search.mjs "搜索关键词" --from "now-2d/d" --to "now/d"
完整参数说明
核心参数
| 参数 | 简写 | 说明 | 默认值 |
|---|---|---|---|
query |
无（位置参数） | 搜索关键词，建议36个汉字以内 | 必填 |
--count |
-n |
返回结果数量 | 网页默认20，最大50 |
--edition |
无 | 搜索版本：standard（完整）或 lite（轻量） |
standard |
时间过滤参数
| 参数 | 说明 |
|---|---|
--time |
快速时效过滤：week/month/semiyear/year |
--from |
起始时间：固定日期YYYY-MM-DD或相对时间（见下方） |
--to |
结束时间：格式同上 |
相对时间表达式
now/d- 当天now-1w/d- 最近一周now-2d/d- 最近两天now-1M/d- 最近一个月now-3M/d- 最近三个月now-6M/d- 最近六个月now-1y/d- 最近一年
站点过滤参数
| 参数 | 说明 |
|---|---|
--site |
指定搜索站点（可重复使用） |
--block |
屏蔽搜索站点（可重复使用） |
资源类型参数
| 参数 | 说明 |
|---|---|
--types |
资源类型：web/image/video/aladdin，逗号分隔可带数量：web:10,image:5 |
其他参数
| 参数 | 说明 |
|---|---|
--safe |
开启安全搜索 |
--config |
query干预配置ID（高级） |
--raw |
输出原始JSON响应 |
使用示例
1. 基础网页搜索
node {baseDir}/scripts/search.mjs "北京有哪些旅游景区"
2. 限定站点搜索
node {baseDir}/scripts/search.mjs "北京天气" --site "www.weather.com.cn"
# 多个站点
node {baseDir}/scripts/search.mjs "北京天气" --site "site1.com" --site "site2.com"
3. 时间范围搜索
# 最近7天
node {baseDir}/scripts/search.mjs "人工智能最新进展" --time week
# 固定日期范围
node {baseDir}/scripts/search.mjs "历史事件" --from "2025-01-01" --to "2025-12-31"
4. 多资源类型搜索
# 网页+图片+视频
node {baseDir}/scripts/search.mjs "北京故宫" --types web,image,video
# 仅图片
node {baseDir}/scripts/search.mjs "北京故宫" --types image
# 自定义各类型数量
node {baseDir}/scripts/search.mjs "北京故宫" --types web:10,image:5,video:3
5. 屏蔽特定站点
node {baseDir}/scripts/search.mjs "Python教程" --block "csdn.net" --block "jianshu.com"
6. 安全搜索
node {baseDir}/scripts/search.mjs "敏感内容" --safe
输出格式
默认输出格式：
#1 网页标题
站点: 站点名称
链接: https://example.com
时间: 2025-01-01 12:00:00
摘要: 搜索摘要...
---
使用 --raw 参数输出完整JSON响应。
技能结构
核心文件
scripts/search.mjs- 主搜索脚本，处理所有参数和API调用references/api-reference.md- 完整的API参数说明和参考文档
依赖文件
package.json- Node.js依赖配置.env- API Key配置文件（用户创建）.gitignore- 忽略敏感文件和依赖
故障排除
Q: 提示401认证失败？
A: 检查API Key是否正确，确认账号已开通百度千帆搜索API服务。
Q: 提示429请求超限？
A: 降低请求频率，或联系百度智能云升级配额。
Q: 提示400参数错误？
A: 检查参数格式，特别是时间格式和站点URL格式。
Q: 没有搜索结果？
A: 检查关键词是否过长（超过72字符），或尝试放宽时间/站点过滤条件。
详细API文档
完整API参数说明、错误码和高级用法请参阅 references/api-reference.md。
注意事项
- 无硬编码API Key - 技能不包含任何硬编码的API Key，用户必须配置自己的Key
- 区分明确 - 这是百度千帆搜索API，不是普通百度搜索
- 参数完整 - 支持百度千帆搜索API的所有参数
- 社区规范 - 符合OpenClaw技能社区规范，可被其他agent直接使用