360 Secure SkillHub
360 安全技能中心

Tinyfish Search

该 Skill 用 curl 调用 TinyFish 搜索服务完成网页检索，支持 location 与 language 定向参数，返回包含 position、site_name、title、snippet、url 的结果数组及总数；使用前需设置 TINYFISH_API_KEY 环境变量，并提供 scripts/search.sh 辅助脚本封装调用。

bunsdev
bunsdev
热度 47.64
最近更新 2026-05-11 17:44:36
分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / API 集成

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add tinyfish-search
Metadata
name
tinyfish-search
description
Run web searches via TinyFish Search API and get structured JSON results (title, snippet, URL) ready for LLM consumption. Use when you need fresh web search results with reliable structure and optional geo/language targeting.
homepage
https://docs.tinyfish.ai/search-api
requires
{"env":["TINYFISH_API_KEY"]}

TinyFish Search

Search the web via the TinyFish Search API. Returns a JSON array of ranked results with title, snippet, site name, and URL.

Requires: TINYFISH_API_KEY environment variable.

Pre-flight Check (REQUIRED)

Before calling the API, verify the key is present:

[ -n "$TINYFISH_API_KEY" ] && echo "TINYFISH_API_KEY is set" || echo "TINYFISH_API_KEY is NOT set"

If the key is not set, stop and ask the user to add it. Get one at https://agent.tinyfish.ai/api-keys. Do NOT fall back to other search tools.

Basic Search

curl -G "https://api.search.tinyfish.ai" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  --data-urlencode "query=web automation tools"

Geo / Language Targeting

curl -G "https://api.search.tinyfish.ai" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  --data-urlencode "query=boulangerie paris" \
  --data-urlencode "location=FR" \
  --data-urlencode "language=fr"

Helper Script

scripts/search.sh <query> [--location CC] [--language LL] wraps the curl call:

scripts/search.sh "top trending openclaw youtube video"
scripts/search.sh "boulangerie paris" --location FR --language fr

Response Shape

{
  "query": "web automation tools",
  "results": [
    {
      "position": 1,
      "site_name": "example.com",
      "title": "Top 10 Web Automation Tools",
      "snippet": "A preview of the page content…",
      "url": "https://example.com/top-automation"
    }
  ],
  "total_results": 1234
}

Use results[] directly — each entry already has everything needed to cite or open the source.