Skip to content
Back to search

tinyfish-cookbook

A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tinyfish-io/tinyfish-cookbook with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tinyfish-io/tinyfish-cookbook'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tinyfish-io--tinyfish-cookbook/badge.svg)](/listings/tinyfish-io--tinyfish-cookbook)

HTML

<a href="/listings/tinyfish-io--tinyfish-cookbook"><img src="/api/listings/tinyfish-io--tinyfish-cookbook/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get your API key

Sign up at [agent.tinyfish.ai](https://agent.tinyfish.ai/). No credit card. Search and Fetch are free out of the box.

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](https://tinyfi.sh/) — free and dead simple.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 34 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "tinyfish-marketplace",
  3. "owner": {
  4. "name": "TinyFish",
  5. "email": "support@tinyfish.io"
  6. },
  7. "metadata": {
  8. "description": "Official TinyFish plugins for Claude Code",
  9. "version": "1.0.0",
  10. "pluginRoot": "./plugins"
  11. },
  12. "plugins": [
  13. {
  14. "name": "tinyfish",
  15. "source": "./plugins/tinyfish",
  16. "description": "The complete web toolkit for your agent. Search the web, fetch clean content from URLs, automate browsers with natural language, and spin up headless browsers for full programmatic control.",
  17. "version": "1.2.4",
  18. "author": {
  19. "name": "TinyFish",
  20. "url": "https://tinyfish.ai"
  21. },
  22. "category": "automation",
  23. "tags": [
  24. "web-automation",
  25. "web-agent",
  26. "browser-automation",
  27. "web-scraping",
  28. "data-extraction",
  29. "search",
  30. "fetch"
  31. ]
  32. }
  33. ]
  34. }
README.md · README · 349 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # The TinyFish Cookbook
  2. <a href="https://agent.tinyfish.ai/">
  3. <img width="100%" alt="Search and Fetch are now FREE" src=".github/assets/banner.png" />
  4. </a>
  5. <div align="center">
  6. [![Website](https://img.shields.io/badge/Website-141414?style=for-the-badge&logo=googlechrome&logoColor=white)](https://tinyfish.ai/)
  7. [![Docs](https://img.shields.io/badge/Docs-526CE5?style=for-the-badge&logo=readthedocs&logoColor=white)](https://docs.tinyfish.ai/)
  8. [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/tinyfish)
  9. [![License](https://img.shields.io/badge/License-View-green?style=for-the-badge)](LICENSE)
  10. [![X](https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/Tiny_Fish)
  11. [![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/tinyfish-ai/)
  12. [![Threads](https://img.shields.io/badge/Threads-000000?style=for-the-badge&logo=threads&logoColor=white)](https://www.threads.com/@tinyfish_ai)
  13. [![Instagram](https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white)](https://www.instagram.com/tinyfish_ai/)
  14. </div>
  15. ---
  16. > **Search and Fetch are now FREE**
  17. >
  18. > 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;](https://agent.tinyfish.ai/)
  19. ---
  20. ## About This Repository
  21. Welcome to the **TinyFish Cookbook!** A growing collection of recipes, demos, and automations built on TinyFish — the web layer for AI agents.
  22. 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.
  23. ## The Endpoints
  24. TinyFish gives you four endpoints, layered from lightning-fast retrieval to fully managed browser automation. **Search** and **Fetch** are free.
  25. | Endpoint | What it does | Best for | Speed | Pricing |
  26. |----------|-------------|----------|-------|---------|
  27. | **Search** &nbsp; `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** |
  28. | **Fetch** &nbsp; `api.fetch.tinyfish.ai` | Any URL &rarr; 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** |
  29. | **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 |
  30. | **Browser** | Rent a fully managed cloud browser. Connect your own Playwright or Selenium scripts. | Hardcore custom agents and scripts. | Real-time | Metered |
  31. ## Why TinyFish?
  32. - **Any website &rarr; API** — turn sites without APIs into programmable data sources
  33. - **Natural-language goals** — send a URL + plain English, get structured JSON back
  34. - **Real browser automation** — multi-step flows, forms, filters, calendars, dynamic content
  35. - **Built-in stealth** — rotating proxies and stealth profiles included, no extra cost
  36. - **Vault** — agent-grade credentials and session memory for authenticated workflows (1Password JIT, encrypted session reuse)
  37. - **Production-grade observability** — full logs and debugging on every run
  38. - **Token-efficient by design** — Fetch strips nav, scripts, and cookie banners, so you stop paying tokens on junk HTML
  39. ## Ways to use TinyFish
  40. One API key. Use it from wherever you build.
  41. ### REST API
  42. ```bash
  43. # Search
  44. curl "https://api.search.tinyfish.ai?query=web+automation+tools" \
  45. -H "X-API-Key: $TINYFISH_API_KEY"
  46. # Fetch
  47. curl -X POST https://api.fetch.tinyfish.ai \
  48. -H "X-API-Key: $TINYFISH_API_KEY" \
  49. -H "Content-Type: application/json" \
  50. -d '{"urls": ["https://www.tinyfish.ai/"]}'
  51. # Agent (streaming)
  52. curl -N -X POST https://agent.tinyfish.ai/v1/automation/run-sse \
  53. -H "X-API-Key: $TINYFISH_API_KEY" \
  54. -H "Content-Type: application/json" \
  55. -d '{"url": "https://agentql.com", "goal": "Find all subscription plans and prices. Return JSON."}'
  56. ```
  57. ### MCP Server
  58. Drop the server URL into Claude Code, Cursor, Codex, ChatGPT desktop, or any MCP-aware client.
  59. ```json
  60. {
  61. "mcpServers": {
  62. "tinyfish": { "url": "https://mcp.tinyfish.ai" }
  63. }
  64. }
  65. ```
  66. ### CLI
  67. ```bash
  68. npm install -g @tiny-fish/cli
  69. tinyfish auth login
  70. tinyfish search query "web automation tools"
  71. tinyfish fetch content get https://example.com
  72. ```
  73. The CLI writes results to the filesystem instead of piping them through your model's context window — tokens stay low, output stays structured.
  74. ### Scripts
  75. Drop TinyFish into everyday tools with small copyable scripts.
  76. | Script | Description |
  77. |--------|-------------|
  78. | [Raycast TinyFish Search](./scripts/raycast-tinyfish-search) | Search the web from Raycast and get formatted result URLs, titles, and snippets |
  79. ### Agent Skill
  80. 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.
  81. ```bash
  82. npx skills add github.com/tinyfish-io/tinyfish-cookbook --skill use-tinyfish
  83. ```
  84. Browse it on [skills.sh/tinyfish-io/tinyfish-cookbook/use-tinyfish](https://skills.sh/tinyfish-io/tinyfish-cookbook/use-tinyfish).
  85. ### SDKs
  86. ```bash
  87. pip install tinyfish # Python
  88. npm install @tiny-fish/sdk # TypeScript
  89. ```
  90. Both SDKs cover Search, Fetch, Browser, Agent, and Vault — full parity.
  91. ### Where it's already wired up
  92. Check out our [Integrations](https://www.tinyfish.ai/integrations)
  93. ## The Recipes
  94. Each folder is a standalone project. Categorized below by what they do, not what's under the hood.
  95. ### Featured (live demos)
  96. These use the latest TinyFish SDK and are deployed with live demos you can try right now.
  97. | Recipe | Description | Live demo |
  98. |--------|-------------|-----------|
  99. | [viet-bike-scout](./viet-bike-scout) | Motorbike rental price comparison across Vietnamese cities using parallel browser agents | [Demo](https://cookbook-viet-bike-scout.vercel.app/) |
  100. | [tutor-finder](./tutor-finder) | AI-powered tutor discovery for competitive exams across multiple platforms | [Demo](https://cookbook-tutor-finder.vercel.app/) |
  101. | [openbox-deals](./openbox-deals) | Real-time open-box and refurbished deal aggregator across 8 retailers | [Demo](https://cookbook-openbox-deals.vercel.app/) |
  102. | [silicon-signal](./silicon-signal) | Semiconductor supply chain tracker for lifecycle, availability, and lead-time signals | [Demo](https://cookbook-silicon-signal.vercel.app/) |
  103. | [summer-school-finder](./summer-school-finder) | Discover and compare summer school programs from universities around the world | [Demo](https://cookbook-summer-school-finder.vercel.app/) |
  104. | [tinyskills](./tinyskills) | Multi-source AI skill guide generator that scrapes docs, GitHub, and blogs into a single SKILL.md | [Demo](https://cookbook-tinyskills.vercel.app/) |
  105. | [saigon-happy-hour-sniper](./saigon-happy-hour-sniper) | Find happy hour deals across Saigon in seconds | [Demo](https://saigon-happy-hour-sniper.vercel.app/) |
  106. | [worldcup-briefing](./worldcup-briefing) | AI-powered football highlight reels — discover match footage with TinyFish Search, compile clips with VideoDB | [Demo](https://worldcup-briefing.vercel.app) |
  107. ### AABW Vietnam Hackathon Samples
  108. Built for the [Agentic AI Build Week (AABW)](https://aabw.genaifund.ai/) hackathon — July 8-12, 2026, Ho Chi Minh City. See the [full track mapping](./AABW_Vietnam_Hackathon_Samples/README.md).
  109. | Recipe | Track(s) | Live demo |
  110. |--------|----------|-----------|
  111. | [fareguard](./AABW_Vietnam_Hackathon_Samples/fareguard) | Mobility (Tasco), Aviation (Vietjet) | [Demo](https://fareguard.vercel.app/) |
  112. | [finsight](./AABW_Vietnam_Hackathon_Samples/finsight) | Financial Services I (Shinhan), Financial Services II (GoTymeX) | [Demo](https://finsight.vercel.app/) |
  113. | [founder-mode](./AABW_Vietnam_Hackathon_Samples/founder-mode) | Founder Mode (GenAI Fund) | [Demo](https://founder-mode-brown.vercel.app/) |
  114. | [market-pulse](./AABW_Vietnam_Hackathon_Samples/market-pulse) | Retail (Phong Vu), Retail & Hospitality (Guardian) | [Demo](https://marketpulse-gray.vercel.app/) |
  115. | [monai](./AABW_Vietnam_Hackathon_Samples/monai) | F&B (KFC) | [Demo](https://mon-ai-alpha.vercel.app/) |
  116. | [rateradar](./AABW_Vietnam_Hackathon_Samples/rateradar) | Financial Services I (Shinhan), Financial Services II (GoTymeX) | [Demo](https://rateradar-teal.vercel.app/) |
  117. ### Bounty Drop 001 Winners
  118. The 12 winning builds from the first Bounty Drop of the [TinyFish Student](https://tinyfish.ai/students) and [Ambassador](https://tinyfish.ai/ambassadors) Programs: job finders, AI-readiness auditors, brand guide generators and iMessage assistants. See [all the winners](./Bounty_Drop_001_Winners/README.md).
  119. ### Shopping & Deals
  120. | Recipe | Description |
  121. |--------|-------------|
  122. | [bestbet](./bestbet) | Sports betting odds comparison across books |
  123. | [game-buying-guide](./game-buying-guide) | Video game pricing across 10 gaming platforms in parallel |
  124. | [lego-hunter](./lego-hunter) | Rare Lego inventory across 15+ retailers with price and availability analysis |
  125. | [openbox-deals](./openbox-deals) | Real-time open-box and refurbished deal aggregator |
  126. | [waifu-deal-sniper](./waifu-deal-sniper) | Discord bot for anime figure collectors hunting AmiAmi, Mercari, Solaris Japan |
  127. | [wing-command](./wing-command) | Chicken wing tracker — find the best wings near you by flavor preference |
  128. ### Travel, Stays & Local
  129. | Recipe | Description |
  130. |--------|-------------|
  131. | [stay-scout-hub](./stay-scout-hub) | Cross-site lodging search for conventions and events |
  132. | [viet-bike-scout](./viet-bike-scout) | Motorbike rental price comparison across Vietnamese cities |
  133. | [district-rent-shark](./district-rent-shark) | Vietnamese rental market intelligence + neighborhood walkability scores |
  134. | [restaurant-comparison-tool](./restaurant-comparison-tool) | Pre-visit restaurant safety + allergen intelligence from Google Maps |
  135. | [saigon-happy-hour-sniper](./saigon-happy-hour-sniper) | Live happy hour deal aggregator for Saigon |
  136. ### Research & Market Intelligence
  137. | Recipe | Description |
  138. |--------|-------------|
  139. | [research-sentry](./research-sentry) | Voice-first academic research co-pilot scanning ArXiv, PubMed, and more |
  140. | [silicon-signal](./silicon-signal) | Semiconductor supply chain & lead-time signals |
  141. | [competitor-analysis](./competitor-analysis) | Live competitive pricing intelligence dashboard |
  142. | [competitor-scout-cli](./competitor-scout-cli) | Natural-language CLI for researching competitor feature decisions |
  143. | [logistics-sentry](./logistics-sentry) | Port congestion and carrier-risk tracking |
  144. | [tenders-finder](./tenders-finder) | Singapore government tender discovery across multiple portals |
  145. ### Education & Discovery
  146. | Recipe | Description |
  147. |--------|-------------|
  148. | [tutor-finder](./tutor-finder) | AI-powered tutor discovery for competitive exams |
  149. | [summer-school-finder](./summer-school-finder) | Compare summer school programs from universities worldwide |
  150. | [scholarship-finder](./scholarship-finder) | Scholarship discovery pulling live data from official sources |
  151. ### Developer Tools
  152. | Recipe | Description |
  153. |--------|-------------|
  154. | [code-reference-finder](./code-reference-finder) | Find real-world usage examples for any code snippet from GitHub and Stack Overflow |
  155. | [fast-qa](./fast-qa) | No-code QA testing platform with parallel test execution and live browser previews |
  156. | [tinyskills](./tinyskills) | Generates comprehensive SKILL.md guides from docs, GitHub, and developer blogs |
  157. ### Finance & Decisioning
  158. | Recipe | Description |
  159. |--------|-------------|
  160. | [loan-decision-copilot](./loan-decision-copilot) | Loan comparison across banks and regions |
  161. ### Lifestyle & Health
  162. | Recipe | Description |
  163. |--------|-------------|
  164. | [anime-watch-hub](./anime-watch-hub) | Find sites to read or watch your favorite manga and anime |
  165. | [pharmacy-panic](./pharmacy-panic) | Compare medicine prices across Vietnam's top pharmacy chains in real time |
  166. > New recipes land weekly. See [CONTRIBUTING.md](CONTRIBUTING.md) to add yours.
  167. ### n8n Workflows
  168. Pre-built n8n workflows using TinyFish — import the JSON and go.
  169. | Workflow | Description |
  170. |----------|-------------|
  171. | [Competitor Scout](./N8N_WorkFlows/Competitor%20Scout%20CLI) | Research competitor feature decisions with OpenAI planning + TinyFish evidence collection |
  172. | [Web Research Agent](./N8N_WorkFlows/Web%20Research%20Agent) | Chatbot that scrapes any website with TinyFish and saves summaries to Notion |
  173. | [Daily Product Hunt Tracker](./N8N_WorkFlows/Daily%20Product%20Hunt%20Tracker) | Scheduled workflow delivering daily top 5 trending Product Hunt products to Telegram |
  174. ## Getting Started
  175. ### 1. Get your API key
  176. Sign up at [agent.tinyfish.ai](https://agent.tinyfish.ai/). No credit card. Search and Fetch are free out of the box.
  177. ### 2. Run something
  178. #### cURL
  179. ```bash
  180. curl -N -X POST https://agent.tinyfish.ai/v1/automation/run-sse \
  181. -H "X-API-Key: $TINYFISH_API_KEY" \
  182. -H "Content-Type: application/json" \
  183. -d '{
  184. "url": "https://agentql.com",
  185. "goal": "Find all AgentQL subscription plans and their prices. Return result in json format"
  186. }'
  187. ```
  188. #### Python
  189. ```python
  190. import json, os, requests
  191. response = requests.post(
  192. "https://agent.tinyfish.ai/v1/automation/run-sse",
  193. headers={
  194. "X-API-Key": os.getenv("TINYFISH_API_KEY"),
  195. "Content-Type": "application/json",
  196. },
  197. json={
  198. "url": "https://agentql.com",
  199. "goal": "Find all AgentQL subscription plans and their prices. Return result in json format",
  200. },
  201. stream=True,
  202. )
  203. for line in response.iter_lines():
  204. if line:
  205. line_str = line.decode("utf-8")
  206. if line_str.startswith("data: "):
  207. event = json.loads(line_str[6:])
  208. print(event)
  209. ```
  210. #### TypeScript
  211. ```typescript
  212. const response = await fetch("https://agent.tinyfish.ai/v1/automation/run-sse", {
  213. method: "POST",
  214. headers: {
  215. "X-API-Key": process.env.TINYFISH_API_KEY,
  216. "Content-Type": "application/json",
  217. },
  218. body: JSON.stringify({
  219. url: "https://agentql.com",
  220. goal: "Find all AgentQL subscription plans and their prices. Return result in json format",
  221. }),
  222. });
  223. const reader = response.body.getReader();
  224. const decoder = new TextDecoder();
  225. while (true) {
  226. const { done, value } = await reader.read();
  227. if (done) break;
  228. console.log(decoder.decode(value));
  229. }
  230. ```
  231. > Sharing a localhost demo with a friend? Use [tinyfi.sh](https://tinyfi.sh/) — free and dead simple.
  232. ## Star History
  233. <p align="center">
  234. <a href="https://www.star-history.com/#tinyfish-io/tinyfish-cookbook&type=date">
  235. <img src="https://api.star-history.com/svg?repos=tinyfish-io/tinyfish-cookbook&type=date&legend=top-left" alt="Star History Chart">
  236. </a>
  237. </p>
  238. ## Contributors
  239. <a href="https://github.com/tinyfish-io/tinyfish-cookbook/graphs/contributors">
  240. <img src="https://contrib.rocks/image?repo=tinyfish-io/tinyfish-cookbook" />
  241. </a>
  242. Got something cool you built with TinyFish? We want it in here. See the [Contributing Guide](CONTRIBUTING.md) for the full rundown.
  243. ## Community & Support
  244. - [Discord](https://discord.gg/tinyfish) — ask questions, share what you're building, hang out
  245. - [Docs](https://docs.tinyfish.ai/)
  246. - [tinyfish.ai](https://tinyfish.ai/)
  247. ## Legal Disclaimer
  248. 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:
  249. - **"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.
  250. - **No Obligation to Maintain**: TinyFish is under no obligation to monitor, update, or fix bugs, errors, or security vulnerabilities found in community-contributed derivatives.
  251. - **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.
  252. - **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.
  253. > Note: Contributions from the community do not represent the official views or supported products of TinyFish.
  254. ---
  255. <img src="https://github.com/user-attachments/assets/2cf004f0-0065-4f21-9835-12ac693964f1" width="100%" />

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.