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.

Endpoint	What it does	Best for	Speed	Pricing
Search   api.search.tinyfish.ai	Fast, structured web search built for agents — JSON results, rank-stable across calls.	Drop-in retrieval layer for any agent. Designed for LLM consumption, not blue-link browsing.	< 0.5s	Free
Fetch   api.fetch.tinyfish.ai	Any URL → clean markdown / JSON / HTML. Real full-browser rendering. Failed URLs are free.	Reading specific pages and feeding clean content to LLMs. Drop-in replacement for Firecrawl, native LLM fetch, or hand-rolled Playwright.	A few seconds	Free
Agent	Provide a URL and a natural-language goal. The agent navigates, acts, and returns clean JSON.	Multi-step flows, complex tasks, structured data extraction.	~10s to minutes	Metered
Browser	Rent a fully managed cloud browser. Connect your own Playwright or Selenium scripts.	Hardcore custom agents and scripts.	Real-time	Metered

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.

Script	Description
Raycast TinyFish Search	Search the web from Raycast and get formatted result URLs, titles, and snippets

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.

Recipe	Description	Live demo
viet-bike-scout	Motorbike rental price comparison across Vietnamese cities using parallel browser agents	Demo
tutor-finder	AI-powered tutor discovery for competitive exams across multiple platforms	Demo
openbox-deals	Real-time open-box and refurbished deal aggregator across 8 retailers	Demo
silicon-signal	Semiconductor supply chain tracker for lifecycle, availability, and lead-time signals	Demo
summer-school-finder	Discover and compare summer school programs from universities around the world	Demo
tinyskills	Multi-source AI skill guide generator that scrapes docs, GitHub, and blogs into a single SKILL.md	Demo
saigon-happy-hour-sniper	Find happy hour deals across Saigon in seconds	Demo
worldcup-briefing	AI-powered football highlight reels — discover match footage with TinyFish Search, compile clips with VideoDB	Demo

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.

Recipe	Track(s)	Live demo
fareguard	Mobility (Tasco), Aviation (Vietjet)	Demo
finsight	Financial Services I (Shinhan), Financial Services II (GoTymeX)	Demo
founder-mode	Founder Mode (GenAI Fund)	Demo
market-pulse	Retail (Phong Vu), Retail & Hospitality (Guardian)	Demo
monai	F&B (KFC)	Demo
rateradar	Financial Services I (Shinhan), Financial Services II (GoTymeX)	Demo

Shopping & Deals

Recipe	Description
bestbet	Sports betting odds comparison across books
game-buying-guide	Video game pricing across 10 gaming platforms in parallel
lego-hunter	Rare Lego inventory across 15+ retailers with price and availability analysis
openbox-deals	Real-time open-box and refurbished deal aggregator
waifu-deal-sniper	Discord bot for anime figure collectors hunting AmiAmi, Mercari, Solaris Japan
wing-command	Chicken wing tracker — find the best wings near you by flavor preference

Travel, Stays & Local

Recipe	Description
stay-scout-hub	Cross-site lodging search for conventions and events
viet-bike-scout	Motorbike rental price comparison across Vietnamese cities
district-rent-shark	Vietnamese rental market intelligence + neighborhood walkability scores
restaurant-comparison-tool	Pre-visit restaurant safety + allergen intelligence from Google Maps
saigon-happy-hour-sniper	Live happy hour deal aggregator for Saigon

Research & Market Intelligence

Recipe	Description
research-sentry	Voice-first academic research co-pilot scanning ArXiv, PubMed, and more
silicon-signal	Semiconductor supply chain & lead-time signals
competitor-analysis	Live competitive pricing intelligence dashboard
competitor-scout-cli	Natural-language CLI for researching competitor feature decisions
logistics-sentry	Port congestion and carrier-risk tracking
tenders-finder	Singapore government tender discovery across multiple portals

Education & Discovery

Recipe	Description
tutor-finder	AI-powered tutor discovery for competitive exams
summer-school-finder	Compare summer school programs from universities worldwide
scholarship-finder	Scholarship discovery pulling live data from official sources

Developer Tools

Recipe	Description
code-reference-finder	Find real-world usage examples for any code snippet from GitHub and Stack Overflow
fast-qa	No-code QA testing platform with parallel test execution and live browser previews
tinyskills	Generates comprehensive SKILL.md guides from docs, GitHub, and developer blogs

Finance & Decisioning

Recipe	Description
loan-decision-copilot	Loan comparison across banks and regions

Lifestyle & Health

Recipe	Description
[anime-watch-hub](./anim