Ec Web Search

---
name: ec-web-search
description: 通过 ec-crm 搜索互联网公开信息，获取指定关键词的搜索结果。用于：查最新资讯、搜索资料、获取网络信息。不用于：客户搜索/客户管理。
user-invocable: false
metadata:
   builtin_skill_version: "1.3"
description_zh: "通过 ec-crm 搜索互联网公开信息，获取指定关键词的搜索结果。用于：查最新资讯、搜索资料、获取网络信息。不用于：客户搜索/客户管理。"
description_en: "Search public web information by keyword using ec-crm. Use customer management for internal CRM searches."
version: "1.3.0"
author: EC
---

# EC 网络搜索 (Web Search)

通过 ec-crm CLI 调用搜索引擎，获取指定关键词的互联网公开信息。

## Use When
- 用户请求涉及搜索互联网信息、查最新资讯、找资料。
- 用户请求跨域时，本域部分由此 skill 处理。

## Avoid When
- 请求涉及客户管理/搜索 → `ec-customer-mgmt`
- 请求涉及标签/画像 → `ec-customer-insights`
- 请求涉及跟进/待办/工作报告 → `ec-customer-sales`
- 请求涉及电话/质检/话术复盘 → `ec-customer-contact`
- 请求涉及工商数据 → `ec-customer-business`

## 调用方式

执行 ec-crm 命令进行网络搜索：

```bash
ec-crm web-search --query "<搜索关键词>" --size <结果数量>
```

- `--query`：搜索关键词，必填,最大100个字符。
- `--size`：返回结果数量，默认 5，最大 50。

## 意图拆分

当用户意图跨多个域时：
- "搜索XX最新消息" → 本 skill 单独执行搜索。
- "搜索XX并导入客户库" → 本 skill 执行搜索，再将搜索结果中的企业信息转 `ec-customer-business`。
- 多步骤任一失败 → 停止后续步骤，告知用户已完成与未完成的内容。

## 硬约束

### ⛔ 铁律：ec-crm 报错即停。以下规则不可协商，不可绕过。

| 错误类型 | 识别 | 行动 | 严禁 |
|--------|------|------|------|
| **命令不存在** | `command not found` 或找不到这个命令 | 停止调用，引导用户在 WorkBuddy 中安装或重新连接 EC CRM 连接器；由宿主管理安装环境，不自行全局安装 | — |
| **入参错误** | 参数格式/值不合法 | 读错误 → 修正 → 重试（≤2次）；超限后停并告知正确格式 | 猜参/删参/填默认值 |
| **业务错误** | 权限不足/搜索不可用 | 立即停，原样展示错误 | 重试/换命令/绕路 |
| **结果为空** | 命令正常退出但数据为空 | 告知「搜索无结果」，结束 | 换条件重查/扩大范围 |
| **数据错误** | 字段缺失/格式异常/空数据 | 立即停，告知数据异常 | 跳过/补全字段 |

> **任何未列出的错误 → 一律视为"停"。**

### 注意
- 当执行命令的返回结果过长，被系统截断时，主动去读取完整数据文件内容，确保后续步骤使用完整数据。

## 跨会话恢复
- 继续上次任务时，先使用当前对话中可核对的条件和对象标识；仅在宿主实际提供历史检索能力时使用该能力。标识缺失或无法确认时按本域查询流程重新定位；客户标识通过 `ec-customer-mgmt` 查询，多候选时请用户选择，不猜测或复用未核实的 ID。

## 连接与授权

- 在 WorkBuddy 的 EC CRM 连接器已连接后调用；未登录、登录过期或认证失败时停止业务操作，引导用户重新连接。权限不足按业务错误处理，不反复登录或绕过权限。
- 业务写入只执行用户已明确要求或确认的动作、对象及范围；信息不明确时先询问。已有明确授权无需重复确认，后续步骤不得扩大授权范围。
- 按实际返回结果说明已完成内容；写入结果不明或超时先核实状态，不盲目重复写入。错误信息保留错误码和业务原因，隐藏 Token、密钥等凭证。