[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11693":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},11693,"tinyfish-cookbook","tinyfish-io\u002Ftinyfish-cookbook","tinyfish-io","A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build!",null,"https:\u002F\u002Fgithub.com\u002Ftinyfish-io\u002Ftinyfish-cookbook","TypeScript",2034,310,8,3,0,11,35,125,33,29.48,false,"main",[25,26,27,28,29,30,31,32,33],"agent","agentic","ai","cookbook","examples","typescript","web-agents","web-automation","tinyfish","2026-06-12 02:02:33","# The TinyFish Cookbook\n\n\u003Ca href=\"https:\u002F\u002Fagent.tinyfish.ai\u002F\">\n  \u003Cimg width=\"100%\" alt=\"Search and Fetch are now FREE\" src=\".github\u002Fassets\u002Fbanner.png\" \u002F>\n\u003C\u002Fa>\n\n\u003Cdiv align=\"center\">\n\n[![Website](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWebsite-141414?style=for-the-badge&logo=googlechrome&logoColor=white)](https:\u002F\u002Ftinyfish.ai\u002F)\n[![Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-526CE5?style=for-the-badge&logo=readthedocs&logoColor=white)](https:\u002F\u002Fdocs.tinyfish.ai\u002F)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002Ftinyfish)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-View-green?style=for-the-badge)](LICENSE)\n[![X](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-000000?style=for-the-badge&logo=x&logoColor=white)](https:\u002F\u002Fx.com\u002FTiny_Fish)\n[![LinkedIn](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ftinyfish-ai\u002F)\n[![Threads](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FThreads-000000?style=for-the-badge&logo=threads&logoColor=white)](https:\u002F\u002Fwww.threads.com\u002F@tinyfish_ai)\n[![Instagram](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white)](https:\u002F\u002Fwww.instagram.com\u002Ftinyfish_ai\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n> **Search and Fetch are now FREE**\n>\n> 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 →](https:\u002F\u002Fagent.tinyfish.ai\u002F)\n\n---\n\n## About This Repository\n\nWelcome to the **TinyFish Cookbook!** A growing collection of recipes, demos, and automations built on TinyFish — the web layer for AI agents.\n\nIf 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.\n\n## The Endpoints\n\nTinyFish gives you four endpoints, layered from lightning-fast retrieval to fully managed browser automation. **Search** and **Fetch** are free.\n\n| Endpoint | What it does | Best for | Speed | Pricing |\n|----------|-------------|----------|-------|---------|\n| **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. | \u003C 0.5s | **Free** |\n| **Fetch**   `api.fetch.tinyfish.ai` | Any URL → clean markdown \u002F JSON \u002F 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** |\n| **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 |\n| **Browser** | Rent a fully managed cloud browser. Connect your own Playwright or Selenium scripts. | Hardcore custom agents and scripts. | Real-time | Metered |\n\n## Why TinyFish?\n\n- **Any website → API** — turn sites without APIs into programmable data sources\n- **Natural-language goals** — send a URL + plain English, get structured JSON back\n- **Real browser automation** — multi-step flows, forms, filters, calendars, dynamic content\n- **Built-in stealth** — rotating proxies and stealth profiles included, no extra cost\n- **Vault** — agent-grade credentials and session memory for authenticated workflows (1Password JIT, encrypted session reuse)\n- **Production-grade observability** — full logs and debugging on every run\n- **Token-efficient by design** — Fetch strips nav, scripts, and cookie banners, so you stop paying tokens on junk HTML\n\n## Ways to use TinyFish\n\nOne API key. Use it from wherever you build.\n\n### REST API\n\n```bash\n# Search\ncurl \"https:\u002F\u002Fapi.search.tinyfish.ai?query=web+automation+tools\" \\\n  -H \"X-API-Key: $TINYFISH_API_KEY\"\n\n# Fetch\ncurl -X POST https:\u002F\u002Fapi.fetch.tinyfish.ai \\\n  -H \"X-API-Key: $TINYFISH_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"urls\": [\"https:\u002F\u002Fwww.tinyfish.ai\u002F\"]}'\n\n# Agent (streaming)\ncurl -N -X POST https:\u002F\u002Fagent.tinyfish.ai\u002Fv1\u002Fautomation\u002Frun-sse \\\n  -H \"X-API-Key: $TINYFISH_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"url\": \"https:\u002F\u002Fagentql.com\", \"goal\": \"Find all subscription plans and prices. Return JSON.\"}'\n```\n\n### MCP Server\n\nDrop the server URL into Claude Code, Cursor, Codex, ChatGPT desktop, or any MCP-aware client.\n\n```json\n{\n  \"mcpServers\": {\n    \"tinyfish\": { \"url\": \"https:\u002F\u002Fmcp.tinyfish.ai\" }\n  }\n}\n```\n\n### CLI\n\n```bash\nnpm install -g @tiny-fish\u002Fcli\ntinyfish auth login\ntinyfish search query \"web automation tools\"\ntinyfish fetch content get https:\u002F\u002Fexample.com\n```\n\nThe CLI writes results to the filesystem instead of piping them through your model's context window — tokens stay low, output stays structured.\n\n### Agent Skill\n\nOne-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.\n\n```bash\nnpx skills add github.com\u002Ftinyfish-io\u002Ftinyfish-cookbook --skill use-tinyfish\n```\n\nBrowse it on [skills.sh\u002Ftinyfish-io\u002Ftinyfish-cookbook\u002Fuse-tinyfish](https:\u002F\u002Fskills.sh\u002Ftinyfish-io\u002Ftinyfish-cookbook\u002Fuse-tinyfish).\n\n### SDKs\n\n```bash\npip install tinyfish              # Python\nnpm install @tiny-fish\u002Fsdk        # TypeScript\n```\n\nBoth SDKs cover Search, Fetch, Browser, Agent, and Vault — full parity.\n\n### Where it's already wired up\n\nCheck out our [Integrations](https:\u002F\u002Fwww.tinyfish.ai\u002Fintegrations)\n\n## The Recipes\n\nEach folder is a standalone project. Categorized below by what they do, not what's under the hood.\n\n### Featured (live demos)\n\nThese use the latest TinyFish SDK and are deployed with live demos you can try right now.\n\n| Recipe | Description | Live demo |\n|--------|-------------|-----------|\n| [viet-bike-scout](.\u002Fviet-bike-scout) | Motorbike rental price comparison across Vietnamese cities using parallel browser agents | [Demo](https:\u002F\u002Fcookbook-viet-bike-scout.vercel.app\u002F) |\n| [tutor-finder](.\u002Ftutor-finder) | AI-powered tutor discovery for competitive exams across multiple platforms | [Demo](https:\u002F\u002Fcookbook-tutor-finder.vercel.app\u002F) |\n| [openbox-deals](.\u002Fopenbox-deals) | Real-time open-box and refurbished deal aggregator across 8 retailers | [Demo](https:\u002F\u002Fcookbook-openbox-deals.vercel.app\u002F) |\n| [silicon-signal](.\u002Fsilicon-signal) | Semiconductor supply chain tracker for lifecycle, availability, and lead-time signals | [Demo](https:\u002F\u002Fcookbook-silicon-signal.vercel.app\u002F) |\n| [summer-school-finder](.\u002Fsummer-school-finder) | Discover and compare summer school programs from universities around the world | [Demo](https:\u002F\u002Fcookbook-summer-school-finder.vercel.app\u002F) |\n| [tinyskills](.\u002Ftinyskills) | Multi-source AI skill guide generator that scrapes docs, GitHub, and blogs into a single SKILL.md | [Demo](https:\u002F\u002Fcookbook-tinyskills.vercel.app\u002F) |\n| [saigon-happy-hour-sniper](.\u002Fsaigon-happy-hour-sniper) | Find happy hour deals across Saigon in seconds | [Demo](https:\u002F\u002Fsaigon-happy-hour-sniper.vercel.app\u002F) |\n\n### Shopping & Deals\n\n| Recipe | Description |\n|--------|-------------|\n| [bestbet](.\u002Fbestbet) | Sports betting odds comparison across books |\n| [game-buying-guide](.\u002Fgame-buying-guide) | Video game pricing across 10 gaming platforms in parallel |\n| [lego-hunter](.\u002Flego-hunter) | Rare Lego inventory across 15+ retailers with price and availability analysis |\n| [openbox-deals](.\u002Fopenbox-deals) | Real-time open-box and refurbished deal aggregator |\n| [waifu-deal-sniper](.\u002Fwaifu-deal-sniper) | Discord bot for anime figure collectors hunting AmiAmi, Mercari, Solaris Japan |\n| [wing-command](.\u002Fwing-command) | Chicken wing tracker — find the best wings near you by flavor preference |\n\n### Travel, Stays & Local\n\n| Recipe | Description |\n|--------|-------------|\n| [stay-scout-hub](.\u002Fstay-scout-hub) | Cross-site lodging search for conventions and events |\n| [viet-bike-scout](.\u002Fviet-bike-scout) | Motorbike rental price comparison across Vietnamese cities |\n| [district-rent-shark](.\u002Fdistrict-rent-shark) | Vietnamese rental market intelligence + neighborhood walkability scores |\n| [restaurant-comparison-tool](.\u002Frestaurant-comparison-tool) | Pre-visit restaurant safety + allergen intelligence from Google Maps |\n| [saigon-happy-hour-sniper](.\u002Fsaigon-happy-hour-sniper) | Live happy hour deal aggregator for Saigon |\n\n### Research & Market Intelligence\n\n| Recipe | Description |\n|--------|-------------|\n| [research-sentry](.\u002Fresearch-sentry) | Voice-first academic research co-pilot scanning ArXiv, PubMed, and more |\n| [silicon-signal](.\u002Fsilicon-signal) | Semiconductor supply chain & lead-time signals |\n| [competitor-analysis](.\u002Fcompetitor-analysis) | Live competitive pricing intelligence dashboard |\n| [competitor-scout-cli](.\u002Fcompetitor-scout-cli) | Natural-language CLI for researching competitor feature decisions |\n| [logistics-sentry](.\u002Flogistics-sentry) | Port congestion and carrier-risk tracking |\n| [tenders-finder](.\u002Ftenders-finder) | Singapore government tender discovery across multiple portals |\n\n### Education & Discovery\n\n| Recipe | Description |\n|--------|-------------|\n| [tutor-finder](.\u002Ftutor-finder) | AI-powered tutor discovery for competitive exams |\n| [summer-school-finder](.\u002Fsummer-school-finder) | Compare summer school programs from universities worldwide |\n| [scholarship-finder](.\u002Fscholarship-finder) | Scholarship discovery pulling live data from official sources |\n\n### Developer Tools\n\n| Recipe | Description |\n|--------|-------------|\n| [code-reference-finder](.\u002Fcode-reference-finder) | Find real-world usage examples for any code snippet from GitHub and Stack Overflow |\n| [fast-qa](.\u002Ffast-qa) | No-code QA testing platform with parallel test execution and live browser previews |\n| [tinyskills](.\u002Ftinyskills) | Generates comprehensive SKILL.md guides from docs, GitHub, and developer blogs |\n\n### Finance & Decisioning\n\n| Recipe | Description |\n|--------|-------------|\n| [loan-decision-copilot](.\u002Floan-decision-copilot) | Loan comparison across banks and regions |\n\n### Lifestyle & Health\n\n| Recipe | Description |\n|--------|-------------|\n| [anime-watch-hub](.\u002Fanime-watch-hub) | Find sites to read or watch your favorite manga and anime |\n| [pharmacy-panic](.\u002Fpharmacy-panic) | Compare medicine prices across Vietnam's top pharmacy chains in real time |\n\n> New recipes land weekly. See [CONTRIBUTING.md](CONTRIBUTING.md) to add yours.\n\n### n8n Workflows\n\nPre-built n8n workflows using TinyFish — import the JSON and go.\n\n| Workflow | Description |\n|----------|-------------|\n| [Competitor Scout](.\u002FN8N_WorkFlows\u002FCompetitor%20Scout%20CLI) | Research competitor feature decisions with OpenAI planning + TinyFish evidence collection |\n| [Web Research Agent](.\u002FN8N_WorkFlows\u002FWeb%20Research%20Agent) | Chatbot that scrapes any website with TinyFish and saves summaries to Notion |\n| [Daily Product Hunt Tracker](.\u002FN8N_WorkFlows\u002FDaily%20Product%20Hunt%20Tracker) | Scheduled workflow delivering daily top 5 trending Product Hunt products to Telegram |\n\n## Getting Started\n\n### 1. Get your API key\n\nSign up at [agent.tinyfish.ai](https:\u002F\u002Fagent.tinyfish.ai\u002F). No credit card. Search and Fetch are free out of the box.\n\n### 2. Run something\n\n#### cURL\n\n```bash\ncurl -N -X POST https:\u002F\u002Fagent.tinyfish.ai\u002Fv1\u002Fautomation\u002Frun-sse \\\n  -H \"X-API-Key: $TINYFISH_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fagentql.com\",\n    \"goal\": \"Find all AgentQL subscription plans and their prices. Return result in json format\"\n  }'\n```\n\n#### Python\n\n```python\nimport json, os, requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fagent.tinyfish.ai\u002Fv1\u002Fautomation\u002Frun-sse\",\n    headers={\n        \"X-API-Key\": os.getenv(\"TINYFISH_API_KEY\"),\n        \"Content-Type\": \"application\u002Fjson\",\n    },\n    json={\n        \"url\": \"https:\u002F\u002Fagentql.com\",\n        \"goal\": \"Find all AgentQL subscription plans and their prices. Return result in json format\",\n    },\n    stream=True,\n)\n\nfor line in response.iter_lines():\n    if line:\n        line_str = line.decode(\"utf-8\")\n        if line_str.startswith(\"data: \"):\n            event = json.loads(line_str[6:])\n            print(event)\n```\n\n#### TypeScript\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fagent.tinyfish.ai\u002Fv1\u002Fautomation\u002Frun-sse\", {\n  method: \"POST\",\n  headers: {\n    \"X-API-Key\": process.env.TINYFISH_API_KEY,\n    \"Content-Type\": \"application\u002Fjson\",\n  },\n  body: JSON.stringify({\n    url: \"https:\u002F\u002Fagentql.com\",\n    goal: \"Find all AgentQL subscription plans and their prices. Return result in json format\",\n  }),\n});\n\nconst reader = response.body.getReader();\nconst decoder = new TextDecoder();\n\nwhile (true) {\n  const { done, value } = await reader.read();\n  if (done) break;\n  console.log(decoder.decode(value));\n}\n```\n\n> Sharing a localhost demo with a friend? Use [tinyfi.sh](https:\u002F\u002Ftinyfi.sh\u002F) — free and dead simple.\n\n## Star History\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#tinyfish-io\u002Ftinyfish-cookbook&type=date\">\n    \u003Cimg src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=tinyfish-io\u002Ftinyfish-cookbook&type=date&legend=top-left\" alt=\"Star History Chart\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftinyfish-io\u002Ftinyfish-cookbook\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=tinyfish-io\u002Ftinyfish-cookbook\" \u002F>\n\u003C\u002Fa>\n\nGot something cool you built with TinyFish? We want it in here. See the [Contributing Guide](CONTRIBUTING.md) for the full rundown.\n\n## Community & Support\n\n- [Discord](https:\u002F\u002Fdiscord.gg\u002Ftinyfish) — ask questions, share what you're building, hang out\n- [Docs](https:\u002F\u002Fdocs.tinyfish.ai\u002F)\n- [tinyfish.ai](https:\u002F\u002Ftinyfish.ai\u002F)\n\n## Legal Disclaimer\n\nThis 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:\n\n- **\"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.\n- **No Obligation to Maintain**: TinyFish is under no obligation to monitor, update, or fix bugs, errors, or security vulnerabilities found in community-contributed derivatives.\n- **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.\n- **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.\n\n> Note: Contributions from the community do not represent the official views or supported products of TinyFish.\n\n---\n\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F2cf004f0-0065-4f21-9835-12ac693964f1\" width=\"100%\" \u002F>\n","TinyFish Cookbook 是一个基于 TinyFish Web 代理构建的示例应用和自动化脚本集合，旨在帮助开发者学习和构建自己的项目。该项目使用 TypeScript 编写，提供了四个主要端点：Search 和 Fetch 免费提供快速网页搜索和内容抓取服务，支持结构化数据返回；Agent 和 Browser 则分别针对多步骤流程执行及云端浏览器租赁，适用于需要复杂任务处理或无 API 网站访问的场景。无论是初学者还是经验丰富的开发者，都能从中找到适合自己的示例来加速开发过程。",2,"2026-06-11 03:32:18","trending"]