# tinyfish-io/tinyfish-cookbook architecture

> Architecture diagram of the GitHub repository tinyfish-io/tinyfish-cookbook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tinyfish-io/tinyfish-cookbook
- Repository: https://github.com/tinyfish-io/tinyfish-cookbook

## Overview

The TinyFish Cookbook is a collection of independent recipes and demos for using web search, page fetching, and browser automation in agent workflows—not one application or a shared runtime. The README documents the platform endpoints and additional access methods; the tree and sampled source show representative recipe workflows, including competitor research, video highlight compilation, and local skill storage. Connections between separate recipes are omitted because they are not wired together.

Main entry points: [`competitor-scout-cli/app/api/research/route.ts`](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/app/api/research/route.ts) (Research route), [`worldcup-briefing/src/lib/video-pipeline.ts`](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/worldcup-briefing/src/lib/video-pipeline.ts) (World Cup Briefing), [`competitor-scout-cli`](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/competitor-scout-cli) (Competitor Scout), [`tinyskills`](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/tinyskills) (TinySkills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["TinyFish platform"]
  node_search["Search endpoint"]
  node_fetch["Fetch endpoint"]
  node_agent["Agent endpoint"]
  node_browser["Browser endpoint"]
end

subgraph group_research["Research recipes"]
  node_scout["Competitor Scout"]
  node_research_api["Research route<br/>[route.ts]"]
  node_tinyfish_client["TinyFish client<br/>[tinyfish.ts]"]
  node_openai_client["Research planning<br/>[openai-client.ts]"]
  node_scout_report["Comparison report<br/>[report-view.tsx]"]
end

subgraph group_media["Media recipes"]
  node_worldcup["World Cup Briefing<br/>[video-pipeline.ts]"]
  node_videodb["VideoDB"]
  node_video_search["TinyFish Search"]
end

subgraph group_apps["Hackathon apps"]
  node_tinyskills["TinySkills"]
  node_skill_storage[("Skill storage<br/>[storage.ts]")]
  node_fareguard["FareGuard"]
  node_finsight["FinSight"]
  node_founder_mode["Founder Mode"]
  node_market_pulse["Market Pulse"]
  node_monai["MonAI"]
  node_rateradar["RateRadar"]
end

node_builder(("Agent builder"))

node_builder -->|"queries"| node_search
node_builder -->|"fetches pages"| node_fetch
node_builder -->|"runs goals"| node_agent
node_builder -->|"connects scripts"| node_browser
node_scout -->|"submits research"| node_research_api
node_research_api -->|"plans and reports"| node_openai_client
node_research_api -->|"searches and fetches"| node_tinyfish_client
node_research_api -->|"streams report data"| node_scout_report
node_worldcup -->|"searches videos"| node_video_search
node_worldcup -->|"uploads and indexes"| node_videodb
node_tinyskills -->|"saves skills"| node_skill_storage

click node_scout "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/competitor-scout-cli"
click node_research_api "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/app/api/research/route.ts"
click node_tinyfish_client "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/lib/tinyfish.ts"
click node_openai_client "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/lib/openai-client.ts"
click node_scout_report "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/components/report-view.tsx"
click node_worldcup "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/worldcup-briefing/src/lib/video-pipeline.ts"
click node_tinyskills "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/tinyskills"
click node_skill_storage "https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/tinyskills/lib/storage.ts"
click node_fareguard "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/fareguard"
click node_finsight "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/finsight"
click node_founder_mode "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/founder-mode"
click node_market_pulse "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/market-pulse"
click node_monai "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/monai"
click node_rateradar "https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/rateradar"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_search,node_fetch,node_agent,node_browser toneBlue
class node_scout,node_research_api,node_tinyfish_client,node_openai_client,node_scout_report toneAmber
class node_worldcup,node_videodb,node_video_search toneMint
class node_tinyskills,node_skill_storage,node_fareguard,node_finsight,node_founder_mode,node_market_pulse,node_monai,node_rateradar toneRose
class node_builder toneIndigo
```

## Components

### TinyFish platform

- **Search endpoint**
- **Fetch endpoint**
- **Agent endpoint**
- **Browser endpoint**

### Research recipes

- [Competitor Scout](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/competitor-scout-cli): `competitor-scout-cli`
- [Research route](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/app/api/research/route.ts): `competitor-scout-cli/app/api/research/route.ts`
- [TinyFish client](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/lib/tinyfish.ts): `competitor-scout-cli/lib/tinyfish.ts`
- [Research planning](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/lib/openai-client.ts): `competitor-scout-cli/lib/openai-client.ts`
- [Comparison report](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/competitor-scout-cli/components/report-view.tsx): `competitor-scout-cli/components/report-view.tsx`

### Media recipes

- [World Cup Briefing](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/worldcup-briefing/src/lib/video-pipeline.ts): `worldcup-briefing/src/lib/video-pipeline.ts`
- **VideoDB**
- **TinyFish Search**

### Hackathon apps

- [TinySkills](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/tinyskills): `tinyskills`
- [Skill storage](https://github.com/tinyfish-io/tinyfish-cookbook/blob/main/tinyskills/lib/storage.ts): `tinyskills/lib/storage.ts`
- [FareGuard](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/fareguard): `AABW_Vietnam_Hackathon_Samples/fareguard`
- [FinSight](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/finsight): `AABW_Vietnam_Hackathon_Samples/finsight`
- [Founder Mode](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/founder-mode): `AABW_Vietnam_Hackathon_Samples/founder-mode`
- [Market Pulse](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/market-pulse): `AABW_Vietnam_Hackathon_Samples/market-pulse`
- [MonAI](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/monai): `AABW_Vietnam_Hackathon_Samples/monai`
- [RateRadar](https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/AABW_Vietnam_Hackathon_Samples/rateradar): `AABW_Vietnam_Hackathon_Samples/rateradar`

### Other components

- **Agent builder**

## Connections

- Agent builder → Search endpoint: queries
- Agent builder → Fetch endpoint: fetches pages
- Agent builder → Agent endpoint: runs goals
- Agent builder → Browser endpoint: connects scripts
- Competitor Scout → Research route: submits research
- Research route → Research planning: plans and reports
- Research route → TinyFish client: searches and fetches
- Research route → Comparison report: streams report data
- World Cup Briefing → TinyFish Search: searches videos
- World Cup Briefing → VideoDB: uploads and indexes
- TinySkills → Skill storage: saves skills