The TinyFish Cookbook

Website | Docs | Discord | License | X | LinkedIn | Threads | Instagram

About This Repository

Welcome to the TinyFish Cookbook! This is a growing collection of recipes, demos, and automations built with TinyFish.

Think of this like a recipe book for the web. Whether you want to build an automated travel agent, a job application bot, or a market research tool, you can grab a recipe here, tweak the ingredients, and start cooking.

What is TinyFish?

TinyFish is a web agents API that lets you treat real websites like programmable surfaces. Instead of juggling headless browsers, selectors, proxies, and weird edge cases, you call a single API with a goal and some URLs and get back clean JSON. It handles navigation, forms, filters, dynamic content, and multi-step flows across many sites at once, so you can focus on product logic instead of browser plumbing.

The same enterprise-grade infrastructure used in large production environments is now exposed directly to developers.

Power Features in one API

• Any website as an API — Turn ordinary websites (including ones without official APIs) into programmable surfaces for your apps.
• Natural language -> structured JSON — Send a URL (or many) plus a natural language goal, get back clean JSON in the shape you specify.
• Real browser automation — Navigate real websites in real time. We handle complex flows like multi-step bookings, form filling, filters, calendars, and dynamic JavaScript content.
• Built-in Stealth — Every request runs in a stealth browser profile with rotating proxies to reduce the chance of triggering anti-bot defenses. (No extra charge for proxy data).
• Production-grade Logs — Every run comes with detailed observability so you can debug, monitor, and actually trust what the agents did.
• Flexible Integration — Use it as a direct HTTP API, through our visual Playground, or as an MCP server inside tools like Claude and Cursor.

The Recipes

Each folder in this repo is a standalone project. Dive in to see how to solve real-world problems.

More recipes added weekly!

Getting Started with the API

You don't need to install heavy SDKs. TinyFish works with standard HTTP requests.

1. Get your API Key

Sign up on tinyfish.ai and grab your API key.

2. Run a Command

Here is how to run a simple automation agent:

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
import os
import 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));
}

By the way! if you want to expose your project on localhost to your friends to show them a demo, you can now use the tinyfi.sh by us! Completly free and easy to use!

Star History

Contributors

Got something cool you built with TinyFish? We want it in here! Check out our Contributing Guide for the full rundown on how to submit your project.

Community & Support

• Join us on Discord — ask questions, share what you're building, hang out
• Learn more at tinyfish.ai

Legal Disclaimer

This repository is a community-driven space for sharing derivatives, code samples, and best practices related to Tiny Fish 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: Tiny Fish 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 Tiny Fish 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 Tiny Fish.