Tinyfish Cookbook
A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build!
Ask AI about Tinyfish Cookbook
Powered by Claude · Grounded in docs
I know everything about Tinyfish Cookbook. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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.
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 |
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 | Find sites to read or watch your favorite manga and anime |
| pharmacy-panic | Compare medicine prices across Vietnam's top pharmacy chains in real time |
New recipes land weekly. See CONTRIBUTING.md to add yours.
n8n Workflows
Pre-built n8n workflows using TinyFish — import the JSON and go.
| Workflow | Description |
|---|---|
| Competitor Scout | Research competitor feature decisions with OpenAI planning + TinyFish evidence collection |
| Web Research Agent | Chatbot that scrapes any website with TinyFish and saves summaries to Notion |
| Daily Product Hunt Tracker | Scheduled workflow delivering daily top 5 trending Product Hunt products to Telegram |
Getting Started
1. Get your API key
Sign up at agent.tinyfish.ai. No credit card. Search and Fetch are free out of the box.
2. Run something
cURL
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 AgentQL subscription plans and their prices. Return result in json format"
}'
Python
import json, os, requests
response = requests.post(
"https://agent.tinyfish.ai/v1/automation/run-sse",
headers={
"X-API-Key": os.getenv("TINYFISH_API_KEY"),
"Content-Type": "application/json",
},
json={
"url": "https://agentql.com",
"goal": "Find all AgentQL subscription plans and their prices. Return result in json format",
},
stream=True,
)
for line in response.iter_lines():
if line:
line_str = line.decode("utf-8")
if line_str.startswith("data: "):
event = json.loads(line_str[6:])
print(event)
TypeScript
const response = await fetch("https://agent.tinyfish.ai/v1/automation/run-sse", {
method: "POST",
headers: {
"X-API-Key": process.env.TINYFISH_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://agentql.com",
goal: "Find all AgentQL subscription plans and their prices. Return result in json format",
}),
});
const reader = response.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
console.log(decoder.decode(value));
}
Sharing a localhost demo with a friend? Use tinyfi.sh — free and dead simple.
Star History
Contributors
Got something cool you built with TinyFish? We want it in here. See the Contributing Guide for the full rundown.
Community & Support
- Discord — ask questions, share what you're building, hang out
- Docs
- tinyfish.ai
Legal Disclaimer
This repository is a community-driven space for sharing derivatives, code samples, and best practices related to TinyFish products. By using the materials in this repository, you acknowledge and agree to the following:
- "As-Is" Basis: All code, scripts, and documentation shared here are provided "AS IS" and "AS AVAILABLE." TinyFish makes no warranties of any kind, whether express or implied, regarding the accuracy, reliability, or security of community-contributed content.
- No Obligation to Maintain: TinyFish is under no obligation to monitor, update, or fix bugs, errors, or security vulnerabilities found in community-contributed derivatives.
- User Responsibility: You are solely responsible for vetting and testing any code before implementing it in a production environment. Use of these derivatives is at your own risk.
- Limitation of Liability: In no event shall TinyFish be held liable for any claim, damages, or other liability — including but not limited to system failures, data loss, or security breaches — arising from the use of or inability to use the contents of this repository.
Note: Contributions from the community do not represent the official views or supported products of TinyFish.