TinyFish Web Agent

要求：TINYFISH_API_KEY环境变量

飞行前检查（必需）

在进行任何 API 调用之前，务必首先运行此检查以验证密钥是否可用：

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

如果密钥未设置，您必须停止并询问用户添加其 API 密钥。请不要回退到其他工具或方法——该任务需要使用 TinyFish。

告知用户：

您需要一个 TinyFish API 密钥。请在以下网址获取：https://agent.tinyfish.ai/api-keys

然后进行设置，以便代理可以使用它：

选项 1 — 环境变量（适用于所有环境）：

export TINYFISH_API_KEY="your-key-here"

选项 2 — Claude Code 设置（仅限 Claude Code）：添加到~/.claude/settings.local.json：

{
  "env": {
    "TINYFISH_API_KEY": "your-key-here"
  }
}

在确认密钥可用之前，请勿继续操作。

最佳实践

1. 指定JSON格式：始终描述你希望返回的确切结构
2. 并行调用：当从多个独立站点提取数据时，应进行单独的并行调用，而不是合并到一个提示中

基础提取/抓取

从页面提取数据。请指定你想要的JSON结构：

curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "goal": "Extract product info as JSON: {\"name\": str, \"price\": str, \"in_stock\": bool}"
  }'

多项目

使用明确的结构提取数据列表：

curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products",
    "goal": "Extract all products as JSON array: [{\"name\": str, \"price\": str, \"url\": str}]"
  }'

隐身模式

对于有机器人防护的网站，在请求体中添加"browser_profile": "stealth"：

curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://protected-site.com",
    "goal": "Extract product data as JSON: {\"name\": str, \"price\": str, \"description\": str}",
    "browser_profile": "stealth"
  }'

代理

通过添加"proxy_config"到请求体，可通过特定国家路由：

curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://geo-restricted-site.com",
    "goal": "Extract pricing data as JSON: {\"item\": str, \"price\": str, \"currency\": str}",
    "browser_profile": "stealth",
    "proxy_config": {"enabled": true, "country_code": "US"}
  }'

输出

SSE流返回数据：{...}行。最终结果是当类型 == "COMPLETE"且状态 == "COMPLETED"时的事件——提取的数据位于resultJson字段中。Claude直接读取原始的SSE输出；不需要脚本端解析。

并行提取

当从多个独立来源提取时，应进行单独的并行curl调用，而不是合并到一个提示中：

良好做法- 并行调用：

# Compare pizza prices - run these simultaneously
curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://pizzahut.com",
    "goal": "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"
  }'

curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://dominos.com",
    "goal": "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"
  }'

不良做法- 单一合并调用：

# Don't do this - less reliable and slower
curl -N -s -X POST "https://agent.tinyfish.ai/v1/automation/run-sse" \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://pizzahut.com",
    "goal": "Extract prices from Pizza Hut and also go to Dominos..."
  }'

每个独立的提取任务都应该是其自己的API调用。这样更快（并行执行）且更可靠。