tinyfish

The TinyFish Cookbook

Search and Fetch are now FREE

TinyFish Search and Fetch endpoints are now free for everyone with generous rate limits, no credit card required. Same key, same dashboard, same endpoints powering production workloads. Grab a key →

About This Repository

Welcome to the TinyFish Cookbook! A growing collection of recipes, demos, and automations built on TinyFish — the web layer for AI agents.

If your agent needs to search the live web, read a page cleanly, run a multi-step browser flow, or hit any site that doesn't expose an API, this is where to start.

The Endpoints

TinyFish gives you four endpoints, layered from lightning-fast retrieval to fully managed browser automation. Search and Fetch are free.

Why TinyFish?

• Any website → API — turn sites without APIs into programmable data sources
• Natural-language goals — send a URL + plain English, get structured JSON back
• Real browser automation — multi-step flows, forms, filters, calendars, dynamic content
• Built-in stealth — rotating proxies and stealth profiles included, no extra cost
• Vault — agent-grade credentials and session memory for authenticated workflows (1Password JIT, encrypted session reuse)
• Production-grade observability — full logs and debugging on every run
• Token-efficient by design — Fetch strips nav, scripts, and cookie banners, so you stop paying tokens on junk HTML

Ways to use TinyFish

One API key. Use it from wherever you build.

REST API

# Search
curl "https://api.search.tinyfish.ai?query=web+automation+tools" \
  -H "X-API-Key: $TINYFISH_API_KEY"

# Fetch
curl -X POST https://api.fetch.tinyfish.ai \
  -H "X-API-Key: $TINYFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://www.tinyfish.ai/"]}'

# Agent (streaming)
curl -N -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://agentql.com", "goal": "Find all subscription plans and prices. Return JSON."}'

MCP Server

Drop the server URL into Claude Code, Cursor, Codex, ChatGPT desktop, or any MCP-aware client.

{
  "mcpServers": {
    "tinyfish": { "url": "https://mcp.tinyfish.ai" }
  }
}

CLI

npm install -g @tiny-fish/cli
tinyfish auth login
tinyfish search query "web automation tools"
tinyfish fetch content get https://example.com

The CLI writes results to the filesystem instead of piping them through your model's context window — tokens stay low, output stays structured.

Scripts

Drop TinyFish into everyday tools with small copyable scripts.

Agent Skill

One-line install. Works with Claude Code, Codex, Cursor, OpenCode, Antigravity, and other coding agents. The Skill teaches your agent when to reach for Search vs. Fetch vs. Agent, and how to call them.

npx skills add github.com/tinyfish-io/tinyfish-cookbook --skill use-tinyfish

Browse it on skills.sh/tinyfish-io/tinyfish-cookbook/use-tinyfish.

SDKs

pip install tinyfish              # Python
npm install @tiny-fish/sdk        # TypeScript

Both SDKs cover Search, Fetch, Browser, Agent, and Vault — full parity.

Where it's already wired up

Check out our Integrations

The Recipes

Each folder is a standalone project. Categorized below by what they do, not what's under the hood.

Featured (live demos)

These use the latest TinyFish SDK and are deployed with live demos you can try right now.

AABW Vietnam Hackathon Samples

Built for the Agentic AI Build Week (AABW) hackathon — July 8-12, 2026, Ho Chi Minh City. See the full track mapping.

Bounty Drop 001 Winners

The 12 winning builds from the first Bounty Drop of the TinyFish Student and Ambassador Programs: job finders, AI-readiness auditors, brand guide generators and iMessage assistants. See all the winners.

Shopping & Deals

Travel, Stays & Local

Research & Market Intelligence

Education & Discovery

Developer Tools