板块:壹贰线报 · 官方定价页核实
关键词:Tinyfish / 免费搜索 API / 网页抓取 / MCP / AI Agent 工具
Tinyfish — 免费的网页搜索与抓取 API,有速率限制。 后端跑真浏览器(非传统搜索引擎缓存),Search 永远返回实时新鲜结果,Fetch 把渲染后的页面清洗成干净 Markdown / JSON / HTML,直接喂给 AI Agent 当输入。注册就送 500 步 Agent 浏览器额度,搜索+抓取本身 0 credits、永久免费只按速率限流,无需绑卡。
📌 上手前要看的 3 个细节
先把你最容易踩坑的边界讲清楚,免费额度才能用得久、用得稳:
"免费"的核心定义:Search API + Fetch API 0 credits、没有月度总量上限、永不过期,只有速率限制(免费档 Search 30次/分钟、Fetch 150 URL/分钟 + 1,000 URL/天);注册送的 500 credits 是给 Agent API + Browser API(自然语言多步自动化+真实浏览器会话)用的,不是搜/抓的配额——Search/Fetch 本身不限月度次数,只卡QPS。
需要注册拿 API Key:与 Parallel MCP 的"无 Key"路线不同,Tinyfish 所有 API 都需要
X-API-Key请求头,注册 2 分钟、邮箱验证即可,500 credits 自动到账;免费档不超速率不用花一分钱。免费档没有并发配额:Agent API 并发 2、Browser API 并发会话 5;搜索结果用真实 Chromium 渲染(非缓存),对价格变动/财报/突发新闻等"秒级变动"场景非常友好,但需要代理/反爬绕过/高并发的场景走 Starter $15/月起步(搜索 60/分钟、Fetch 300/分钟、Agent 并发 10)。
🎁 两个隐藏福利(官方没在定价页大字写,但免费用)
MCP Server + CLI + Agent Skill 全套免费:官方托管 MCP 端点直接接 Claude Desktop / Cursor / ChatGPT Desktop / Codex;
npm install -g @tiny-fish/cli一条命令装好 CLI 直接命令行搜/抓;npx skills add github.com/tinyfish-io/tinyfish-cookbook --skill tinyfish把"何时用 Search 何时用 Fetch"自动教给 Agent,Claude Code / Codex / Cursor / OpenCode / Antigravity 都能用——搜索+抓取+MCP+CLI+Skill 全免费。OpenBenchmarks 搜索 token 效率 Top1:在 OpenBenchmarks 对编码 Agent 的实测中,Tinyfish 每个任务平均只灌 7,469 个 token 进模型(Firecrawl 7,456 并列第一、Brave 14,103、Exa 22,344),Fetch 返回前自动剥离广告/导航/Cookie Banner/脚本,免费抓取的页面直接喂模型 token 开销比传统抓取省一半。
💰 免费额度与各档对比(官方定价页核实)
能力项 | 免费 PAYG | Starter $15/月 | Pro $150/月 | Enterprise |
|---|---|---|---|---|
Search API | 0 credits / req | 0 credits | 0 credits | 0 credits |
Search 速率 | 30 req/min | 60 req/min | 120 req/min | 自定义 |
Fetch API | 0 credits / url | 0 credits | 0 credits | 0 credits |
Fetch 速率 | 150 url/min · 1000/天 | 300 url/min | 600 url/min | 自定义 |
Agent API(自然语言自动化) | 1 credit/step,并发 2 | 1 credit/step,并发 10 | 并发 50 | 自定义 |
Browser API(云 CDP 浏览器会话) | 1 credit/4min(单任务60min)·并发 5 | 并发 10 | 并发 50 | 自定义 |
注册送 credits | 500 credits | 1,650 credits/月 | 16,500 credits/月 | 定制 |
超量 credits 单价 | $0.015 | $0.014(省40%) | $0.012 | 定制 |
真实浏览器渲染 + 反爬 + Stealth + 代理 + Vault | ✅ | ✅ | ✅ | ✅ |
SDK + CLI + MCP Server + OpenAPI + llms.txt | ✅ | ✅ | ✅ | ✅ |
失败 runs 不计费 | ✅ | ✅ | ✅ | ✅ |
支持 | 邮件 | Priority 邮件 | Slack + onboarding | 专属工程师 |
Research mode(研究 Agent) | — | — | — | ✅ |
SLA / 合规 / on-prem 部署 | — | — | — | ✅ |
年付 | — | $290/年(≈$24.2/月,省~38%) | $990/年(≈$82.5/月) | 定制 |
✅ 一句话:Search+Fetch 永久免费不限月量(只限速),注册白送 500 步 Agent 自动化,月付 $15 拿 1650 credits + 翻倍速率,团队级 Pro $150 解锁 50 并发。
🛠 能力卡 — 6 张看懂它能干嘛
🔍 Search API — 真浏览器渲染、永不缓存
GET https://api.search.tinyfish.ai?query=...一条请求,真 Chromium 实时跑搜索,不读历史缓存——对财报、价格、突发新闻等"分钟级变化"场景特别友好;支持
location=US/CN/GB地理定位、language=en/zh/fr语言、include_domains/exclude_domains域名白/黑名单、recency_minutes=N只搜 N 分钟内的新结果、purpose=可选字段传"为什么搜"意图让结果更准;查询字符串原生支持
site:/-site:运算符(例python tutorial site:docs.python.org或recipe ideas -site:facebook.com -site:youtube.com);返回结构化 JSON(title / url / snippet / …),OpenBenchmarks 实测 7,469 task tokens 搜索 token 效率并列第一,喂模型便宜。
📄 Fetch API — 页面到干净 Markdown/JSON/HTML 一步到位
POST https://api.fetch.tinyfish.ai用真实浏览器渲染页面(能对付 JS 单页应用、懒加载、动态内容),返回前自动剥离广告/导航/Cookie Banner/脚本/侧边栏,只保留正文 Markdown、结构化 JSON 或原始 HTML;免费档 150 URL/分钟 + 1,000 URL/天,每 URL 0 credits——研究管线、资料归档、AI Agent 做工具调用直接走它,省掉自己跑 Puppeteer+清洗的算力;
返回内容直接进 LLM context,比原生 HTTP 拉的 HTML 省一半 token。
🤖 Agent API — 自然语言多步浏览器自动化(用 credits)
自然语言描述目标("登录这个后台、点报表、导出 CSV、上传到我的 S3"),Tinyfish 自动规划步骤+在真浏览器里执行,支持 sync / async / SSE-streaming / batch 四种调用方式;
1 credit = 1 step,免费档并发 2,注册送的 500 credits 足够跑真实站测试;适合价格监控、表单自动填写、登录后提取数据等需要多步操作的场景。
🌐 Browser API — 云 CDP 浏览器会话(用 credits)
直接给一个可以远程连接的真实 Chromium(自带 Stealth 反检测、Anti-bot、代理池、Vault 凭证存储、Profile 指纹),1 credit/4 分钟,单任务 60 分钟上限;
免费档并发 5 会话——调试爬虫、跑登录态自动化、做反爬绕过实验不用自己搭 Selenium 集群。
🔬 Research + 📡 Monitor API(付费/企业)
Research:
POST https://agent.tinyfish.ai/v1/automation/run-research一键跑多源研究 Agent,Pro/Enterprise 可用;Monitor:定时监控页面变化+告警,把 Search/Fetch 组合成"网页变更雷达"。
🧩 开发者生态
官方 MCP Server:JSON config 一行接 Claude Desktop / Cursor / ChatGPT Desktop / Codex / 任何 MCP 客户端,AI Agent 直接调 Tinyfish;
CLI:
npm install -g @tiny-fish/cli命令行直出结果到文件系统,不绕模型 context;Agent Skill:
npx skills add github.com/tinyfish-io/tinyfish-cookbook --skill tinyfish给 AI 助手加"什么时候搜什么时候抓"的认知;SDK:Python + TypeScript 官方 SDK,REST API 也裸调无门槛;
文档:OpenAPI spec + llms.txt(专门给 AI 读的文档)+ 25+ 开发者资源,官方文档站 docs.tinyfish.ai;
团队背景:Tinyfish 是开源项目 AgentQL 背后的公司,由 ICONIQ Capital 投资。
⚠️ 三个必须知道的避坑点
Fetch 1000 URL/天是硬限制:免费档一天超过 1,000 URL 直接 429,做全量站点爬取/批量 RSS 抓取会当天打满,建议先做去重+缓存;
Search 永不缓存 = 每个请求都是真爬:省 token 但慢(比传统 Google CSE 缓存结果稍慢),对延迟敏感的场景本地做一层 1-5 分钟缓存;
Agent/Browser 用 credits:注册 500 credits 测通工作流没问题,生产持续跑必须升 Starter $15/月;失败 runs 不计费是友好兜底,但网络超时/反爬封禁导致的部分步骤仍会计费,建议加重试。
🎯 适合 / 不适合场景
适合:
AI Agent 接 Search/Fetch 做实时联网问答(尤其跑 Claude Code / Cursor 配 MCP 一条命令启用);
个人开发者 / 小团队做价格监控、新闻聚合、竞品情报;
研究管线批量拉页面→Markdown 进 RAG(免费+清洗过的 Markdown 直接喂 embedding);
想省 LLM 输入 token(Tinyfish 返回结果比普通 HTTP 抓 HTML 少一半 token);
免费额度足够覆盖每天几百次搜索+几千 URL 抓取的小产品。
不适合:
大规模全量站点爬取 / 每天几十万 URL 批量抓取(免费 Fetch 1000/天硬上限);
国内强反爬站点(免费数据中心代理容易被拦,需要 Residential 代理的走企业定制);
对响应时间有毫秒级要求的在线服务(真浏览器渲染有百毫秒-秒级延迟);
需要 SLA / 合规 / 私有化部署(走 Enterprise 联系销售)。
🚀 4 步上手(可复制)
Step 1:注册拿 API Key
打开 https://tinyfish.ai 用邮箱注册,控制台立即看到 X-API-Key,500 credits 自动到账,无需绑卡。
Step 2:CLI 装一个(可选,命令行秒测)
npm install -g @tiny-fish/cli
tinyfish config set api-key sk_xxx_xxxx
tinyfish search "NVIDIA Q4 2025 earnings"
tinyfish fetch https://example.com/report --format markdown
Step 3:Python 最简调用
import requests
API_KEY = "sk_xxx_xxxx"
# 1) 实时搜索(永不缓存、真浏览器)
resp = requests.get(
"https://api.search.tinyfish.ai",
headers={"X-API-Key": API_KEY},
params={
"query": "2026 国内 AI Agent 框架对比",
"location": "CN",
"language": "zh",
"recency_minutes": 60 * 24 * 7, # 最近 7 天
"exclude_domains": "pinterest.com,quora.com",
"purpose": "为壹贰线报公众号选 AI Agent 开发工具",
},
timeout=30,
)
results = resp.json()["results"]
for r in results[:5]:
print(r["title"], r["url"])
# 2) 抓页面拿干净 Markdown
resp = requests.post(
"https://api.fetch.tinyfish.ai",
headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
json={"url": results[0]["url"], "format": "markdown"},
timeout=60,
)
md = resp.json()["markdown"]
print(md[:2000])
Step 4:MCP 接入 Claude Desktop / Cursor(推荐给 Agent 开发者)
在 Claude Desktop 的 claude_desktop_config.json(或 Cursor 的 MCP 配置)里加:
{
"mcpServers": {
"tinyfish": {
"url": "https://mcp.tinyfish.ai/mcp",
"headers": { "X-API-Key": "sk_xxx_xxxx" }
}
}
}
重启后 AI 助手自然能"帮我搜下今天 NVIDIA 的财报并总结要点"、"抓这个网页的正文转成 Markdown 存下来"。
🆚 横向对比 — 8 款免费搜索/抓取 API 速查
工具 | 搜索免费量 | 抓取免费量 | 是否需Key | 真浏览器 | MCP | 特色 |
|---|---|---|---|---|---|---|
Tinyfish | 30/min·无月限 | 150/min·1000/天 | 是(注册免费) | ✅ | ✅ 免费 | 搜索+抓取0credit、token效率并列第一、AgentQL 团队 |
Tavily | 1,000 credits/月 | 含 | 是 | — | ✅ | 专为 Agent 设计、语义检索强 |
Exa | $10/月credit+注册送$10 | 含 | 是 | — | ✅ | 神经语义搜索、相似文档检索 |
Firecrawl Free | 500次搜索/月 | 500页/月(1000 credits) | 是+Keyless | ✅ | ✅ | Keyless免注册、爬取站点强 |
Parallel MCP | 5000次/月Turbo | 含 | 否(MCP无Key) | ✅ | ✅ | 无账户无Key、MCP原生 |
Serper.dev | 2,500次免费 | — | 是 | — | — | Google SERP 结构化 |
SerpAPI | 100次/月 | — | 是 | — | — | Google/Bing/Yahoo 多引擎 |
Brave Search API | 2,000次/月免费 | — | 是 | — | ✅ | Brave 自有索引、隐私 |
URLpipe | 50次AI+500次Web/月 | 同 | 是 | ✅ | ✅ | Markdown+Lighthouse+Console |
💳 付费快速参考($0 → 企业级)
档位 | 价格 | 核心升级 |
|---|---|---|
PAYG(免费) | $0 永久 | Search 30/min、Fetch 150/min·1000/天、Agent 并发 2、Browser 并发 5、注册送 500 credits、$0.015/credit 超量 |
Starter | $15/月(年付$24.2/月) | 1,650 credits/月、Search 60/min、Fetch 300/min、Agent 并发 10、Browser 并发 10、$0.014/credit 超量 |
Pro | $150/月(年付$82.5/月) | 16,500 credits/月、Search 120/min、Fetch 600/min、Agent 并发 50、Browser 并发 50、Slack+onboarding、$0.012/credit |
Enterprise | 联系销售 | 定制 credits + 速率、SLA、Research mode、on-prem 私有化部署、专属工程师、DPA 合规 |
📢 你在用哪款免费搜索/抓取 API 喂你的 AI Agent? Tinyfish / Tavily / Exa / Firecrawl / Parallel / Brave Search / Serper / 自搭 SearXNG,评论区聊聊你的使用场景和踩过的坑。
文中价格与规则以官方文档为准(核实时点:2026 年 11 月)。
如果你需要一张已带标题文字的独立头图 PNG,告诉我一声,马上给你生成。需要我把全部平台整理成一张横向对比速查表也随时说。