tinyfish

<a href="https://agent.tinyfish.ai/"> <img width="100%" alt="Search and Fetch are now FREE" src=".github/assets/banner.png" /> </a>

<div align="center">

       

</div>

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 &rarr;

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 &rarr; 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.

Shopping & Deals

Travel, Stays & Local

Research & Market Intelligence

Education & Discovery

Developer Tools

Finance & Decisioning

Lifestyle & Health

New recipes land weekly. See CONTRIBUTING.md to add yours.

n8n Workflows

Pre-built n8n workflows using TinyFish — import the JSON and go.

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 -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"
  }'

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)

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

<p align="center"> <a href="https://www.star-history.com/#tinyfish-io/tinyfish-cookbook&type=date"> <img src="https://api.star-history.com/svg?repos=tinyfish-io/tinyfish-cookbook&type=date&legend=top-left" alt="Star History Chart"> </a> </p>

Contributors

<a href="https://github.com/tinyfish-io/tinyfish-cookbook/graphs/contributors"> <img src="https://contrib.rocks/image?repo=tinyfish-io/tinyfish-cookbook" /> </a>

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.

<img src="https://github.com/user-attachments/assets/2cf004f0-0065-4f21-9835-12ac693964f1" width="100%" />