WebSearchAPI
基于 SearchAPI (Google) 的多类型搜索工具，适合 Agent 获取实时网络信息。
功能特点
- 多种搜索类型: 网页、新闻、视频、财经、地图、酒店、航班
- 自动重试: 网络错误自动重试，提高稳定性
- 结构化返回: Agent 直接可用的 JSON 格式
- 零外部依赖: 纯 Node.js 内置模块
安装
# 复制 tools/websearchapi 目录到你的项目
# 配置 API Key
cd tools/websearchapi
node websearchapi.js config set-key YOUR_API_KEY
API Key 获取: https://searchapi.io (免费注册)
使用方法
使用 exec 工具调用：
node <path>/websearchapi.js <命令> [关键词] [选项]
搜索类型
| 类型 | 命令 | 说明 |
|---|---|---|
| 网页 | s 或 search | 通用网页搜索 |
| 新闻 | news | 最新新闻 |
| 视频 | video | 视频搜索 |
| 财经 | finance | 股票/金融信息 |
| 地图 | maps | 地点/商户 |
| 酒店 | hotels | 酒店搜索 |
| 航班 | flights | 航班搜索 |
选项
| 选项 | 说明 | 默认值 |
|---|---|---|
--num | 结果数量 | 5 |
--lang | 语言 | zh-CN |
--gl | 地区 | cn |
--json | JSON 格式输出 | 文本 |
Agent 调用示例
# 网页搜索
node websearchapi.js s "MCP 协议"
# 新闻搜索
node websearchapi.js news "人工智能"
# 财经搜索 (用股票代码)
node websearchapi.js finance "AAPL"
# JSON 格式 (推荐，便于解析)
node websearchapi.js s "关键词" --json
返回格式
JSON 模式返回：
{
"success": true,
"query": "关键词",
"type": "google",
"count": 5,
"results": [
{
"title": "结果标题",
"link": "链接地址",
"snippet": "摘要内容",
"source": "来源"
}
],
"metadata": {
"totalResults": 数量,
"timeTaken": 耗时,
"engine": "google"
}
}
配置
查看配置
node websearchapi.js config
设置 API Key
node websearchapi.js config set-key YOUR_API_KEY
修改默认选项
node websearchapi.js config set-num 10 # 默认结果数
node websearchapi.js config set-lang en # 默认语言
node websearchapi.js config set-gl us # 默认地区
node websearchapi.js config set-retry 5 # 重试次数
迁移部署
将整个 tools 目录复制到新机器：
# 复制到新机器
scp -r ./tools/websearchapi user@new-server:/path/to/tools/
# 配置 API Key
cd /path/to/tools/websearchapi
node websearchapi.js config set-key YOUR_API_KEY
# 测试
node websearchapi.js test
故障排除
搜索失败
- 检查 API Key 是否正确:
node websearchapi.js config - 检查网络连接
财经搜索无结果
- 尝试用股票代码:
finance "AAPL" - 尝试英文:
finance "Tesla stock"
请求超时
- 网络较慢时可增加重试次数:
config set-retry 5