How do I install tinyfish-cookbook?

Run these in Claude Code: /plugin marketplace add tinyfish-io/tinyfish-cookbook then /plugin install tinyfish@tinyfish-marketplace. Then prompt normally.

Does tinyfish-cookbook auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is tinyfish-cookbook free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Data

Plugin

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 →

FLOW.md

tinyfish-io@tinyfish-io

GitHub

Plugin Signal87/100Strong

maintained100

capable71

documented100

adopted71

Install on Claude Code

> /plugin marketplace add tinyfish-io/tinyfish-cookbook
> /plugin install tinyfish@tinyfish-marketplace

Stats

Python TypeScript React HTML Bash

+7 tags

Vercel GitHub Playwright Markdown Anthropic MCP Notion

2,108

Stars

324

Forks

Active

Maintenance

TypeScript

Language

MIT

License

19h ago

Last commit

6mo ago

Created

Repo: tinyfish-io/tinyfish-cookbook

What's inside

Skills

/agentDefault browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in parallel. New users get 600 free automation credits to start; beyond that it draws on /fetchDefault, free, and fastest way to read a URL's actual content — pulls clean, full page content (not a summary or a truncated snippet) as markdown, HTML, or structured JSON, including from JavaScript-heavy pages, in parallel across up to 10 URLs in one call. Zero setup, no CLI,/searchDefault, free, and fastest way to search the web — faster and more token-efficient than Claude's built-in web search, returning compact structured results instead of raw pages. Supports flexible recency controls (past-N-minutes, before/after date windows) and news/research-paper /academic-research-mapperMap the research landscape for any technical or academic topic by searching arXiv, Semantic Scholar, and Google Scholar in parallel. Use when a developer, researcher, or engineer wants to understand what has been published, who the key authors are, which subtopics are active,/company-hiring-intelReverse-engineer what a company is building by scraping their job postings, careers page, LinkedIn Jobs, and engineering blog using TinyFish web agents. Use whenever a user wants to understand a company's strategic direction from hiring signals, do competitive intelligence,/competitor-updateMonitor competitor product releases and new feature announcements. Use this skill when the user wants to track what competitors are shipping, find the latest product launches in their industry, or generate a competitor release report. Triggers include phrases like "track

Show all 27 skills

MCP

supabasehttp tinyfishhttp

Badges

README

Read on GitHub

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	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

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.

File tree

1434

tinyfish-io/tinyfish-cookbookView on GitHub

.claude-plugin/
  marketplace.json
.github/
  assets/
    banner.png
  CODEOWNERS
  config/
    .pre-commit-config-template.yaml
  workflows/
    secrets-scanner.yml
    vuln-scanner-pr.yml
.semgrepignore
.tags.json
.yamllint
AABW_Vietnam_Hackathon_Samples/
  fareguard/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    app/
      api/
        analyze/
          route.ts
        booking-requests/
          route.ts
        report/
          route.ts
        routes/
          route.ts
        track/
          route.ts
      booking/
        page.tsx
      globals.css
      icon.svg
      layout.tsx
      page.tsx
    components/
      AddRouteForm.tsx
      AgentSwarm.tsx
      ConfidenceGauge.tsx
      Countdown.tsx
      CountUp.tsx
      DashboardSkeleton.tsx
      FareChart.tsx
      Header.tsx
      KpiCard.tsx
      Logo.tsx
      MiniBar.tsx
      MiniDonut.tsx
      MobileNav.tsx
      RecommendationBanner.tsx
      RouteMiniIcon.tsx
      RouteTable.tsx
      Sidebar.tsx
      SiteFavicon.tsx
      Sparkline.tsx
      ThemeToggle.tsx
    lib/
      agents.ts
      analyze.ts
      auth.ts
      booking.ts
      date.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      seed.ts
      siteColors.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      reset-local.mjs
      sweep.ts
    tailwind.config.ts
    tsconfig.json
  finsight/
    .env.example
    .gitignore
    api/
      __init__.py
      core/
        config.py
        logger.py
      index.py
      models/
        __init__.py
        schemas.py
      services/
        __init__.py
        agent_workflows.py
        data_quality.py
        llm_client.py
        pipeline.py
        prompts.py
        query_classifier.py
        query_planner.py
        source_ranker.py
        tinyfish_client.py
    frontend/
      .env.example
      .gitignore
      index.html
      package-lock.json
      package.json
      src/
        App.tsx
        assets/
          hero.png
        components/
          BrandMark.tsx
          landing/
            AnalysisConsole.tsx
            Architecture.tsx
            ClosingCTA.tsx
            IntelligenceReport.tsx
            LivePipelinePanel.tsx
            MarketPulse.tsx
            OpsProblem.tsx
            QueryMatrix.tsx
            SkyHero.tsx
            SourceQualityMeter.tsx
            TinyFishPipeline.tsx
            VerticalPlaybooks.tsx
            VietnamMap.tsx
          MarkdownContent.tsx
          SkylineHero.tsx
          SkylineSilhouette.tsx
        context/
          IntelligenceContext.tsx
        lib/
          api.ts
        main.tsx
        styles.css
      tsconfig.json
      vite.config.ts
    package-lock.json
    package.json
    pyproject.toml
    README.md
    render.yaml
    requirements.txt
    vercel.json
  founder-mode/
    .env.example
    .github/
      workflows/
        discover.yml
    .gitignore
    app/
      api/
        applications/
          [id]/
            route.ts
            submit/
              route.ts
          route.ts
        company-profile/
          route.ts
        discover/
          route.ts
        programs/
          route.ts
      applications/
        [id]/
          page.tsx
        page.tsx
      company-profile/
        page.tsx
      discover/
        page.tsx
      globals.css
      icon.svg
      layout.tsx
      page.tsx
    components/
      AgentStatusStrip.tsx
      Countdown.tsx
      DiscoveryFeed.tsx
      Header.tsx
      KpiCard.tsx
      Logo.tsx
      MobileNav.tsx
      PipelineBoard.tsx
      Sidebar.tsx
      ThemeToggle.tsx
    lib/
      application.ts
      auth.ts
      date.ts
      discovery.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      seed.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      discover.ts
      reset-local.mjs
    tailwind.config.ts
    tsconfig.json
  market-pulse/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    app/
      api/
        products/
          route.ts
        restock-requests/
          [id]/
            draft/
              route.ts
            route.ts
            submit/
              route.ts
          route.ts
        sweep/
          route.ts
      globals.css
      icon.svg
      layout.tsx
      page.tsx
      pricing/
        page.tsx
      restock/
        [id]/
          page.tsx
        page.tsx
    components/
      AgentStatusStrip.tsx
      CategoryTabs.tsx
      Countdown.tsx
      Hero.tsx
      Logo.tsx
      SiteFavicon.tsx
      ThemeToggle.tsx
      TopNav.tsx
    lib/
      auth.ts
      date.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      pricing.ts
      restock.ts
      seed.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      reset-local.mjs
      sweep.ts
    tailwind.config.ts
    tsconfig.json
  monai/
    .env.example
    .gitignore
    .python-version
    app/
      __init__.py
      http_errors.py
      routes/
        __init__.py
        analysis.py
        suppliers.py
        trends.py
      services/
        __init__.py
        ai_client.py
        report_builder.py
        response_parser.py
        search_analysis.py
        tinyfish_client.py
    frontend/
      .env.example
      .gitignore
      index.html
      package-lock.json
      package.json
      public/
        favicon.svg
        icons.svg
      src/
        assets/
          banhmi.webp
          banhxeo.webp
          bunbohue.webp
          capthrung.webp
          leaf.webp
          pho.webp
        components/
          monai/
            analysisExamples.ts
            AnalysisPanel.tsx
            CtaFooter.tsx
            data.ts
            FeaturesSection.tsx
            HeroCollage.tsx
            HeroSection.tsx
            IntelligenceReport.tsx
            ProblemTicker.tsx
            SiteFooter.tsx
            SiteHeader.tsx
            StarBullet.tsx
            TrendsBoard.tsx
            UsersSection.tsx
            VietnamMap.tsx
            WorkflowSection.tsx
          ui/
            button.tsx
            input.tsx
            label.tsx
            tabs.tsx
            textarea.tsx
        lib/
          analysisDefaults.ts
          api.ts
          buildClientReport.ts
          config.ts
          normalizeResult.ts
          utils.ts
        main.tsx
        routes/
          __root.tsx
          dashboard.tsx
          index.tsx
        styles.css
        vite-env.d.ts
      tsconfig.app.json
      tsconfig.json
      tsr.config.json
      vercel.json
      vite.config.ts
    main.py
    README.md
    render.yaml
    requirements.txt
    runtime.txt
    scripts/
      smoke_test.py
  rateradar/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    next.config.js
    package-lock.json
    package.json
    postcss.config.cjs
    README.md
    scripts/
      sweep.ts
    src/
      app/
        api/
          apply/
            route.ts
            submit/
              route.ts
          profile/
            route.ts
          state/
            route.ts
          sweep/
            route.ts
            stream/
              route.ts
        globals.css
        layout.tsx
        page.tsx
      components/
        BankDetailModal.tsx
        BankLogo.tsx
        Hero.tsx
        Navbar.tsx
        SourcesStrip.tsx
... 1504 more

FAQ

tinyfish-cookbook is a Claude Code plugin with 27 hand-picked skills for data work, indexed on Flowy. Install it with the command on its page. It includes agent, fetch, search. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is 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 →
How do I install tinyfish-cookbook?: Run these in Claude Code: /plugin marketplace add tinyfish-io/tinyfish-cookbook then /plugin install tinyfish@tinyfish-marketplace. Then prompt normally.
Does tinyfish-cookbook auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is tinyfish-cookbook free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Data

Plugin

tinyfish-cookbook

FLOW.md

tinyfish-io@tinyfish-io

GitHub

Plugin Signal87/100Strong

maintained100

capable71

documented100

adopted71

Install on Claude Code

> /plugin marketplace add tinyfish-io/tinyfish-cookbook
> /plugin install tinyfish@tinyfish-marketplace

Stats

Python TypeScript React HTML Bash

+7 tags

Vercel GitHub Playwright Markdown Anthropic MCP Notion

2,108

Stars

324

Forks

Active

Maintenance

TypeScript

Language

MIT

License

19h ago

Last commit

6mo ago

Created

Repo: tinyfish-io/tinyfish-cookbook

What's inside

Skills

Show all 27 skills

MCP

supabasehttp tinyfishhttp

Badges

README

Read on GitHub

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

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	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

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

"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.

File tree

1434

tinyfish-io/tinyfish-cookbookView on GitHub

.claude-plugin/
  marketplace.json
.github/
  assets/
    banner.png
  CODEOWNERS
  config/
    .pre-commit-config-template.yaml
  workflows/
    secrets-scanner.yml
    vuln-scanner-pr.yml
.semgrepignore
.tags.json
.yamllint
AABW_Vietnam_Hackathon_Samples/
  fareguard/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    app/
      api/
        analyze/
          route.ts
        booking-requests/
          route.ts
        report/
          route.ts
        routes/
          route.ts
        track/
          route.ts
      booking/
        page.tsx
      globals.css
      icon.svg
      layout.tsx
      page.tsx
    components/
      AddRouteForm.tsx
      AgentSwarm.tsx
      ConfidenceGauge.tsx
      Countdown.tsx
      CountUp.tsx
      DashboardSkeleton.tsx
      FareChart.tsx
      Header.tsx
      KpiCard.tsx
      Logo.tsx
      MiniBar.tsx
      MiniDonut.tsx
      MobileNav.tsx
      RecommendationBanner.tsx
      RouteMiniIcon.tsx
      RouteTable.tsx
      Sidebar.tsx
      SiteFavicon.tsx
      Sparkline.tsx
      ThemeToggle.tsx
    lib/
      agents.ts
      analyze.ts
      auth.ts
      booking.ts
      date.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      seed.ts
      siteColors.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      reset-local.mjs
      sweep.ts
    tailwind.config.ts
    tsconfig.json
  finsight/
    .env.example
    .gitignore
    api/
      __init__.py
      core/
        config.py
        logger.py
      index.py
      models/
        __init__.py
        schemas.py
      services/
        __init__.py
        agent_workflows.py
        data_quality.py
        llm_client.py
        pipeline.py
        prompts.py
        query_classifier.py
        query_planner.py
        source_ranker.py
        tinyfish_client.py
    frontend/
      .env.example
      .gitignore
      index.html
      package-lock.json
      package.json
      src/
        App.tsx
        assets/
          hero.png
        components/
          BrandMark.tsx
          landing/
            AnalysisConsole.tsx
            Architecture.tsx
            ClosingCTA.tsx
            IntelligenceReport.tsx
            LivePipelinePanel.tsx
            MarketPulse.tsx
            OpsProblem.tsx
            QueryMatrix.tsx
            SkyHero.tsx
            SourceQualityMeter.tsx
            TinyFishPipeline.tsx
            VerticalPlaybooks.tsx
            VietnamMap.tsx
          MarkdownContent.tsx
          SkylineHero.tsx
          SkylineSilhouette.tsx
        context/
          IntelligenceContext.tsx
        lib/
          api.ts
        main.tsx
        styles.css
      tsconfig.json
      vite.config.ts
    package-lock.json
    package.json
    pyproject.toml
    README.md
    render.yaml
    requirements.txt
    vercel.json
  founder-mode/
    .env.example
    .github/
      workflows/
        discover.yml
    .gitignore
    app/
      api/
        applications/
          [id]/
            route.ts
            submit/
              route.ts
          route.ts
        company-profile/
          route.ts
        discover/
          route.ts
        programs/
          route.ts
      applications/
        [id]/
          page.tsx
        page.tsx
      company-profile/
        page.tsx
      discover/
        page.tsx
      globals.css
      icon.svg
      layout.tsx
      page.tsx
    components/
      AgentStatusStrip.tsx
      Countdown.tsx
      DiscoveryFeed.tsx
      Header.tsx
      KpiCard.tsx
      Logo.tsx
      MobileNav.tsx
      PipelineBoard.tsx
      Sidebar.tsx
      ThemeToggle.tsx
    lib/
      application.ts
      auth.ts
      date.ts
      discovery.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      seed.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      discover.ts
      reset-local.mjs
    tailwind.config.ts
    tsconfig.json
  market-pulse/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    app/
      api/
        products/
          route.ts
        restock-requests/
          [id]/
            draft/
              route.ts
            route.ts
            submit/
              route.ts
          route.ts
        sweep/
          route.ts
      globals.css
      icon.svg
      layout.tsx
      page.tsx
      pricing/
        page.tsx
      restock/
        [id]/
          page.tsx
        page.tsx
    components/
      AgentStatusStrip.tsx
      CategoryTabs.tsx
      Countdown.tsx
      Hero.tsx
      Logo.tsx
      SiteFavicon.tsx
      ThemeToggle.tsx
      TopNav.tsx
    lib/
      auth.ts
      date.ts
      fetchJson.ts
      format.ts
      github.ts
      orchestrate.ts
      pricing.ts
      restock.ts
      seed.ts
      store.ts
      types.ts
    next.config.js
    package-lock.json
    package.json
    postcss.config.js
    README.md
    scripts/
      reset-local.mjs
      sweep.ts
    tailwind.config.ts
    tsconfig.json
  monai/
    .env.example
    .gitignore
    .python-version
    app/
      __init__.py
      http_errors.py
      routes/
        __init__.py
        analysis.py
        suppliers.py
        trends.py
      services/
        __init__.py
        ai_client.py
        report_builder.py
        response_parser.py
        search_analysis.py
        tinyfish_client.py
    frontend/
      .env.example
      .gitignore
      index.html
      package-lock.json
      package.json
      public/
        favicon.svg
        icons.svg
      src/
        assets/
          banhmi.webp
          banhxeo.webp
          bunbohue.webp
          capthrung.webp
          leaf.webp
          pho.webp
        components/
          monai/
            analysisExamples.ts
            AnalysisPanel.tsx
            CtaFooter.tsx
            data.ts
            FeaturesSection.tsx
            HeroCollage.tsx
            HeroSection.tsx
            IntelligenceReport.tsx
            ProblemTicker.tsx
            SiteFooter.tsx
            SiteHeader.tsx
            StarBullet.tsx
            TrendsBoard.tsx
            UsersSection.tsx
            VietnamMap.tsx
            WorkflowSection.tsx
          ui/
            button.tsx
            input.tsx
            label.tsx
            tabs.tsx
            textarea.tsx
        lib/
          analysisDefaults.ts
          api.ts
          buildClientReport.ts
          config.ts
          normalizeResult.ts
          utils.ts
        main.tsx
        routes/
          __root.tsx
          dashboard.tsx
          index.tsx
        styles.css
        vite-env.d.ts
      tsconfig.app.json
      tsconfig.json
      tsr.config.json
      vercel.json
      vite.config.ts
    main.py
    README.md
    render.yaml
    requirements.txt
    runtime.txt
    scripts/
      smoke_test.py
  rateradar/
    .env.example
    .github/
      workflows/
        sweep.yml
    .gitignore
    next.config.js
    package-lock.json
    package.json
    postcss.config.cjs
    README.md
    scripts/
      sweep.ts
    src/
      app/
        api/
          apply/
            route.ts
            submit/
              route.ts
          profile/
            route.ts
          state/
            route.ts
          sweep/
            route.ts
            stream/
              route.ts
        globals.css
        layout.tsx
        page.tsx
      components/
        BankDetailModal.tsx
        BankLogo.tsx
        Hero.tsx
        Navbar.tsx
        SourcesStrip.tsx
... 1504 more

FAQ

What is 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 →
How do I install tinyfish-cookbook?: Run these in Claude Code: /plugin marketplace add tinyfish-io/tinyfish-cookbook then /plugin install tinyfish@tinyfish-marketplace. Then prompt normally.
Does tinyfish-cookbook auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is tinyfish-cookbook free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.