- name
- ollama-web-search-cli
- description
- 使用 Ollama Web Search API 进行网络搜索和网页抓取
- homepage
- https://github.com/SunnyDou/ollama-web-search-skill
- version
- 1.0.1
- author
- sunnydou
- license
- MIT
- requirements
- [curl, python3]
- env
- description
- Ollama API Key for web search and fetch endpoints
- required
- true
- source
- https://ollama.com/settings/keys
- credentials
- metadata
- openclaw
- emoji
- 🔍
- requires
- bins
- ["curl", "python3"]
- env
- ["OLLAMA_API_KEY"]
- primaryEnv
- OLLAMA_API_KEY
ollama-web-search Skill
使用 Ollama Web Search API 进行网络搜索和网页抓取。
🔧 前置要求
1. Ollama API Key
- 访问 https://ollama.com/settings/keys 创建 API Key
- 设置环境变量：
export OLLAMA_API_KEY=your_key_here
2. 依赖工具
curl: HTTP 请求工具 (macOS/Linux 自带)python3: JSON 解析和转义 (macOS/Linux 自带)
3. 依赖检查
python3 --version # 检查 Python3
curl --version # 检查 curl📋 功能
| 功能 | 命令 | 说明 |
|---|---|---|
| Web Search | search | 执行网络搜索，返回相关结果 |
| Web Fetch | fetch | 获取单个网页内容 |
🛠️ 使用方法
方法一：直接执行脚本
搜索:
./ollama-web-search.sh search "AI 最新进展" 5抓取网页:
./ollama-web-search.sh fetch "https://ollama.com"方法二：使用 Slash 命令 (推荐)
搜索:
/ollama-search "AI 最新进展" 5抓取网页:
/ollama-fetch "https://ollama.com"方法三：在对话中使用
用 ollama-web-search-cli 搜索 "Ollama 新功能"
抓取 https://docs.ollama.com 页面内容📊 参数
Web Search
| 参数 | 类型 | 必需 | 默认值 | 说明 |
|---|---|---|---|---|
query | string | ✅ | - | 搜索查询字符串 |
max_results | number | ❌ | 5 | 最大结果数 (1-10) |
Web Fetch
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
url | string | ✅ | 要抓取的网页 URL |
📤 响应格式
Web Search
{
"results": [
{
"title": "页面标题",
"url": "https://example.com",
"content": "相关内容摘要"
}
]
}Web Fetch
{
"title": "页面标题",
"content": "页面主要内容",
"links": ["链接 1", "链接 2", ...]
}🔍 示例
搜索示例
# 基本搜索
./ollama-web-search.sh search "什么是 Ollama" 5
# 技术搜索
./ollama-web-search.sh search "LLM model scheduling" 10
# 新闻搜索
./ollama-web-search.sh search "AI news 2026" 5
# Slash 命令
/ollama-search "Ollama Web Search API" 5抓取示例
# 抓取 Ollama 首页
./ollama-web-search.sh fetch "https://ollama.com"
# 抓取文档
./ollama-web-search.sh fetch "https://docs.ollama.com"
# Slash 命令
/ollama-fetch "https://docs.openclaw.ai"🔧 API 端点
| API | 端点 | 方法 |
|---|---|---|
| Web Search | https://ollama.com/api/web_search | POST |
| Web Fetch | https://ollama.com/api/web_fetch | POST |
cURL 示例
# Web Search
curl -X POST "https://ollama.com/api/web_search" \
-H "Authorization: Bearer $OLLAMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"what is ollama","max_results":5}'
# Web Fetch
curl -X POST "https://ollama.com/api/web_fetch" \
-H "Authorization: Bearer $OLLAMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ollama.com"}'⚠️ 注意事项
- API Key: 必须设置
OLLAMA_API_KEY - 账户: 需要免费 Ollama 账户
- 速率限制: 参考 Ollama API 文档
- 缓存: 结果缓存 15 分钟
- SSRF 保护: 私有/内部 IP 地址会被阻止
- 错误处理: 脚本会检查 API Key 和响应状态
📁 文件结构
ollama-search-tool/
├── SKILL.md # 技能文档（含 metadata）
├── README.md # 快速入门
└── ollama-web-search.sh # 主脚本