tinyfish-io/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 →

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.

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

• 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

One API key. Use it from wherever you build.

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

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

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

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.

Drop TinyFish into everyday tools with small copyable scripts.

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.

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

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

Check out our Integrations

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

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

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

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

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

Sign up at agent.tinyfish.ai. No credit card. Search and Fetch are free out of the box.

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.

Got something cool you built with TinyFish? We want it in here. See the Contributing Guide for the full rundown.

• Discord — ask questions, share what you're building, hang out
• Docs
• tinyfish.ai

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.