小艺联网搜索

SKILL.md

---
name: xiaoyiwebsearch
description: 使用华为云AI联网搜索API进行网页内容检索，获取实时网络信息
---

# 小艺联网搜索 Skill

## 简介
通过华为云 AI 联网搜索 API 进行实时网络搜索，获取最新的网页信息、新闻、资料等内容。

## 特性
- ✅ **开箱即用** - Token 已固化，无需配置
- ✅ **智能搜索** - 支持自定义搜索数量
- ✅ **简洁输出** - 清晰展示搜索结果
- ✅ **中文优化** - 适合中文搜索场景

## 文件结构
```
xiaoyiwebsearch/
├── SKILL.md          # 使用说明（本文档）
├── search.js         # 主程序（执行搜索）
├── _meta.json        # Skill 元数据
└── package.json     # 项目配置
```

## 使用方法

### 命令行调用
```bash
# 进入 skill 目录
cd /root/.openclaw/workspace/skills/xiaoyiwebsearch

# 默认搜索（10条结果）
node search.js "人工智能最新进展"

# 指定数量搜索
node search.js "ChatGPT 新闻" -n 5
```

### Node.js 代码调用
```javascript
const { webSearch } = require('./search.js');

async function searchExample() {
  const results = await webSearch('人工智能最新进展', 10);
  console.log(results);
}
```

## API 信息

| 项目 | 值 |
|------|-----|
| 请求地址 | `https://connect-api.cloud.huawei.com/api/aiNetworking/v1/webSearch` |
| 鉴权方式 | Bearer Token |
| Token | 已固化在代码中 |
| 请求格式 | `{"query": "关键词", "count": 10}` |

## 何时使用

### ✅ 适合场景
1. 需要获取**最新网络信息**时
2. 需要查询**实时新闻、资料**时
3. 需要**验证或补充已过时**的信息时
4. 用户**明确要求联网搜索**时
5. 需要中文搜索结果时

### ❌ 不适合场景
1. 纯计算或本地数据处理
2. 用户要求不使用网络
3. 已有可靠本地信息

## 输出示例

```bash
$ node search.js "ChatGPT 新闻" -n 3

🔍 搜索结果: "ChatGPT 新闻"
✅ 找到 3 条相关结果

================================================================================

📌 1. ChatGPT 官方网站
🔗 https://openai.com/chat
📝 ChatGPT 是 OpenAI 开发的大型语言模型...
🏷️ 来源: OpenAI

--------------------------------------------------------------------------------
...
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| query | string | ✅ | - | 搜索关键词 |
| count | number | ❌ | 10 | 返回结果数量（建议 5-15） |

## 注意事项

1. **Token 有效期**: Token 有过期时间，如遇到 401 错误，可能需要更新 Token
2. **搜索优化**: 使用准确、具体的关键词可获得更好的搜索结果
3. **结果数量**: 建议 count 参数设置在 5-15 之间，平衡信息量和处理速度
4. **错误处理**: 如遇到 API 错误，请检查网络连接和参数格式
5. **内容安全**: 搜索结果可能包含各种信息，请根据实际需求过滤和验证

## 总结

当需要联网搜索时：
1. ✅ 明确搜索目标
2. ✅ 构建合适的搜索关键词
3. ✅ 调用华为云 web search API
4. ✅ 整理和总结搜索结果
5. ✅ 以用户友好的方式呈现

记住：联网搜索是获取最新信息的强大工具，但要确保搜索关键词准确、结果可信。✅