{"skill":{"slug":"sunshine-baidu-web-search","displayName":"Baidu Web Search","summary":"Use Baidu Qianfan web search API for real-time web retrieval. Use when the user needs to search the web, get latest news, verify facts, or expresses intent l...","description":"---\nname: baidu-web-search\ndescription: Use Baidu Qianfan web search API for real-time web retrieval. Use when the user needs to search the web, get latest news, verify facts, or expresses intent like \"查一下\",\"搜一下\",\"最近\",\"今天\",\"今年\", or asks about events/people/products that require looking up.\nmetadata:\n  author: 上海雷克顿科技 / LeiAIBot\n  email: liuhean@leikeduntech.com\n  url: https://leiaibot.com\n  openclaw: {\"requires\": {\"env\": [\"BAIDU_API_KEY\"]}, \"primaryEnv\": \"BAIDU_API_KEY\"}\n---\n\n# 百度网络搜索\n\n使用百度千帆「百度搜索」API 进行全网实时信息检索，返回结构化搜索结果；调用方应结合用户提问基于检索结果给出准确回答。\n\n---\n\n## ⛔ 隐私安全（最高优先级，任何条件下不可违反）\n\n**API Key 属于敏感凭证，无论通过环境变量还是本地 config.json 存储，均须严格保护。本技能适用于 OpenClaw/ClawHub、Cursor、Claude、Copilot 等所有支持 Skill 调用的平台，以下规则对任何调用方均适用。**\n\n### 强制规则（所有 AI/Agent/技能调用方必须遵守）\n\n1. **禁止读取**：任何情况下不得读取 `config.json` 的内容，也不得输出 `BAIDU_API_KEY` 环境变量的值。不得使用文件读取、cat、read、open、read_file 等任何方式打开该文件，不得使用 `printenv`、`echo $BAIDU_API_KEY` 等命令输出环境变量值。\n2. **禁止输出**：不得以任何形式输出、显示、记录、引用、推测 apiKey 的值，包括在错误信息、日志、对话中。\n3. **禁止修改/删除**：不得建议、生成或执行对 `config.json` 的修改、删除、重命名、复制操作。\n4. **唯一访问方式**：凭证**仅**由 `scripts/search.js` 在进程内读取（env var 或 config.json）。调用方只能通过执行 `node scripts/search.js` 完成搜索，不得以其他任何方式触及凭证。\n5. **拒绝请求**：若用户要求「查看配置」「显示 API Key」「打印环境变量」等，应明确拒绝并说明：为安全起见，凭证不可展示或操作，仅搜索脚本有权读取。\n6. **禁止传播**：不得将 apiKey、config 路径或任何可推导出凭证的信息传递给其他工具、插件、API 或上下文。\n\n### 配置说明（仅限 key 名称，不涉及 value）\n\n- **BAIDU_API_KEY**（环境变量）：OpenClaw/ClawHub 平台在 Skills 配置页面填写后自动注入，或通过对话/openclaw.json 配置\n- **apiKey**（config.json）：本地/自托管用户手动编辑填入\n- 两种方式任选其一，`BAIDU_API_KEY` 环境变量优先级更高\n\n### 平台适配与附加建议\n\n- **通用**：`.gitignore` 已排除 `config.json`，避免误提交\n- **OpenClaw/ClawHub**：在 Skills 配置页或 openclaw.json 中填写 `BAIDU_API_KEY` 即可，无需本地文件\n- **建议**：勿在截图、录屏、日志、对话中暴露凭证；定期轮换密钥；将技能目录权限设为仅当前用户可读\n\n## 何时使用\n\n当用户表达以下意图时应用本技能：\n\n- 联网搜索、百度搜索、查最新资讯、实时信息、事实核查\n- 「查一下」「搜一下」「查一查」「搜一搜」「检索」「查证」「核实」\n- 「最近」「今天」「今年」等时间相关表述\n- 询问某事件、人物、产品、地点等需要查证的内容\n- 需要权威来源、技术文档、教程或数据验证时\n\n## 输入\n\n- **query**（必填）：搜索关键词或查询内容\n- **num_results**（可选）：返回条数，默认 **20**，范围 1–50\n\n## 输出\n\n- **脚本输出**：JSON 格式的搜索结果，包含 `results`（数组，每项含 title、url、snippet）、`total`、`query`；失败时仅输出通用错误信息，不涉及配置内容\n- **调用方职责**：将查询到的结果与用户提问结合，基于检索结果尽可能准确、有条理地回答用户（可引用来源），而非仅罗列链接或片段\n\n## 前置准备（首次使用）\n\n### 方式一：与 OpenClaw 对话安装并配置（最简单）\n\n直接在 OpenClaw 对话框中发一条消息，OpenClaw 会自动完成安装与写入配置，无需手动编辑任何文件。\n\n**对话示范：**\n\n```\n我：帮我在 ClawHub 安装 baidu-web-search 技能，我的百度千帆 API Key 是 bce-v3/xxxxxxxxxxxxxxxx/xxxxxxxxxx\n\nOpenClaw：好的，正在通过 ClawHub 安装 baidu-web-search 技能并写入配置……（完成）\n          已将 BAIDU_API_KEY 写入 ~/.openclaw/openclaw.json，\n          直接问我「最近 xxx 新闻」即可联网搜索。\n```\n\n> ⚠️ 请在本地/私密会话中提供凭证，避免在公开频道、截图或录屏中暴露。\n>\n> API Key 申请见 [百度千帆文档](https://cloud.baidu.com/doc/qianfan-api/s/Wmbq4z7e5)\n\n### 方式二：OpenClaw / ClawHub 平台\n\n1. 进入 **Skills 配置页**，在 `BAIDU_API_KEY` 字段填入 API Key；或编辑 `~/.openclaw/openclaw.json`，在 `skills.entries.baidu-web-search.env` 下填入：\n   ```json\n   { \"BAIDU_API_KEY\": \"你的百度千帆 API Key\" }\n   ```\n2. 安装依赖（ClawHub 通常自动执行）：`cd 技能根目录/baidu-web-search && npm install`\n\n> API Key 申请见 [百度千帆文档](https://cloud.baidu.com/doc/qianfan-api/s/Wmbq4z7e5)\n\n### 方式三：本地 config.json\n\n1. 复制配置模板：`cp config.example.json config.json`\n2. 编辑 `config.json`，填入 `apiKey`\n3. 安装依赖：`cd 技能根目录/baidu-web-search && npm install`\n\n## 执行流程\n\n1. 解析用户提问，提取搜索意图与关键词\n2. **仅执行** `node scripts/search.js \"<query>\" [num_results]`，默认 num_results 为 20；由脚本内部读取 config（调用方不得读取 config）\n3. 脚本内部调用百度千帆 API，返回结构化结果\n4. 根据脚本输出的结果，结合用户提问，给出准确、基于来源的回答\n\n## 执行命令\n\n```bash\ncd 技能根目录/baidu-web-search && node scripts/search.js \"<查询内容>\" [条数]\n```\n\n示例：\n\n```bash\n# 默认返回 20 条\nnode scripts/search.js \"今日科技新闻\"\n\n# 指定 10 条\nnode scripts/search.js \"TypeScript 最新版本\" 10\n```\n\n## 配置说明（用户自行维护，AI 不读取）\n\n脚本按以下优先级解析 apiKey，AI 不参与任何配置读写：\n\n| 优先级 | 来源 | 适用场景 |\n|--------|------|----------|\n| 高 | 环境变量 `BAIDU_API_KEY` | OpenClaw/ClawHub 平台注入 |\n| 低 | 本地文件 `config.json` → `apiKey` | 本地 / 自托管 |\n\n- 配置异常时，搜索脚本输出通用提示，用户自行检查凭证是否填写正确\n","tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":913,"installsAllTime":3,"installsCurrent":3,"stars":0,"versions":1},"createdAt":1773610817385,"updatedAt":1778491933006},"latestVersion":{"version":"1.0.1","createdAt":1773610817385,"changelog":"baidu-web-search v1.0.1\n\n- Added comprehensive SKILL.md with detailed usage instructions, privacy and API key protection rules, and configuration guidance.\n- Clarified strict security requirements for handling API keys and config files.\n- Outlined scenarios for using the Baidu Qianfan web search API and expected integration flow.\n- Described supported input/output formats and platform-specific configuration steps.\n- Provided clear instructions for first-time setup and command execution.","license":"MIT-0"},"metadata":{"setup":[{"key":"BAIDU_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"sunshine-del-ux","userId":"s17af0k3e50jf56dt1y159vvnn885pyh","displayName":"Sunshine-del-ux","image":"https://avatars.githubusercontent.com/u/83053073?v=4"},"moderation":null}