360 Secure SkillHub
360 安全技能中心

Ollama Web Search Tool

通过 shell 脚本调用 Ollama Web Search API，提供网络搜索（查询词、结果数 1-10）与单页抓取两种功能，返回 JSON 结果。需要设置 OLLAMA_API_KEY，依赖 curl 与 python3，内置 API Key 校验、错误处理与 SSRF 保护。

sunnydou
sunnydou
热度 19.69
最近更新 2026-03-26 15:55:17
分类：搜索依赖：代码执行 / 第三方 API应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ollama-search-tool
Metadata
name
ollama-search-tool
description
使用 Ollama Web Search API 进行网络搜索和网页抓取
version
1.0.2
author
sunnydou
license
MIT
requirements
["curl","python3"]
env
["OLLAMA_API_KEY"]

ollama-web-search Skill

使用 Ollama Web Search API 进行网络搜索和网页抓取。

🔧 前置要求

1. Ollama API Key

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-search-tool 搜索 "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              # 技能文档
├── README.md             # 快速入门
├── _meta.json            # 元数据
└── ollama-web-search.sh  # 主脚本

slash-commands/
├── ollama-search         # 搜索命令
└── ollama-fetch          # 抓取命令

🔗 相关文档