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  # 主脚本

---

🔗 相关文档

• Ollama Web Search API
• OpenClaw Tools
• Ollama API Keys
• OpenClaw Slash Commands