用途:通过 Shell 调用 Ollama Cloud 的 web_search 与 web_fetch API。适用于用户要求使用 Ollama 搜索网页,或通过 Ollama Cloud 抓取单个网页并提取结构化内容的场景。
必要环境变量:发送请求前必须设置 OLLAMA_API_KEY。
export OLLAMA_API_KEY=your_api_key_here test -n "$OLLAMA_API_KEY" || { echo "OLLAMA_API_KEY is required" >&2; exit 1; }
HTTP 客户端策略:优先使用 curl;不要为本技能专门创建脚本;不要为发请求安装新依赖;若 curl 不可用,使用环境中已有的其它 HTTP 客户端,并保持相同的方法、URL、请求头与 JSON 请求体;若没有任何可发送 HTTP 请求的工具,停止并报告确切的请求规格,不要编造结果。检查 curl:
command -v curl >/dev/null 2>&1 || echo "curl not found"
网页搜索:对单个查询执行搜索并返回相关结果。方法 POST,URL https://ollama.com/api/web_search,请求头为 Authorization: Bearer $OLLAMA_API_KEY 与 Content-Type: application/json。JSON 请求体包含 query(字符串,必填)与 max_results(整数,可选,默认 5,最大 10)。curl 示例:
curl --request POST
--url https://ollama.com/api/web_search
--header "Authorization: Bearer $OLLAMA_API_KEY"
--header 'Content-Type: application/json'
--data '{
"query": "what is ollama?",
"max_results": 5
}'
响应包含 results 数组,每项有 title、url、content。注意:query 是单个搜索字符串,不是列表;除非需要非默认值,否则省略 max_results;绝不要发送大于 10 的 max_results;只报告 API 返回的内容,不要编造缺失的搜索结果。
网页抓取:按 URL 抓取单个网页并返回其内容。方法 POST,URL https://ollama.com/api/web_fetch,请求头同上。JSON 请求体包含 url(字符串,必填)。curl 示例:
curl --request POST
--url https://ollama.com/api/web_fetch
--header "Authorization: Bearer $OLLAMA_API_KEY"
--header 'Content-Type: application/json'
--data '{
"url": "https://ollama.com"
}'
响应包含 title、content、links。注意:每次请求只发送一个 URL;优先使用绝对 URL;只报告返回的 title、content 和 links,除非 API 返回了完整页面,否则不要声称已抓取完整页面。
限制:需要有效的 OLLAMA_API_KEY;依赖环境中的 HTTP 客户端(优先 curl);搜索为单次查询,抓取为单页;若无可用的 HTTP 工具,应停止并报告请求规格,不应伪造结果。其它收费、价格、平台等细节暂未提供。