企业官网建设流程全解析

用TinyFish Cookbook打造价格狙击手：lego-hunter实时监控15+零售商乐高库存与价格波动

【免费下载链接】tinyfish-cookbookA collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build!项目地址: https://gitcode.com/gh_mirrors/ti/tinyfish-cookbook

TinyFish Cookbook 是 TinyFish 网页智能体的官方示例项目集，其中的lego-hunter是一个开箱即用的乐高库存监控与价格对比工具：输入乐高套装名称或编号，即可并行扫描 15 家以上零售商，实时抓取库存、价格与运费，并自动推荐最低价渠道。本文将带你快速上手这个价格狙击手，并看懂它的监控原理。

🧱 lego-hunter 功能速览：这个乐高价格监控工具能做什么？

lego-hunter 用 Next.js 16 + TypeScript + Tailwind CSS 4 构建，核心体验只有三步：输入套装 → 一键开猎 → 看结果。

默认监控的 15 家零售商在 lego-hunter/lib/retailers.ts 中定义，覆盖美英两地主流渠道：

🧱 LEGO Store · 📦 Amazon · 🎯 Target · 🛒 Walmart · 🔗 BrickLink · 🎮 Zavvi / GameStop · 🦒 Toys R Us · 📚 Barnes & Noble · 🏬 Kohl's · 💻 Best Buy · 🧸 Smyths Toys · 🛍️ John Lewis · 🔵 Argos · 🌍 Entertainment Earth

🔍 工作原理：TinyFish 三步价格监控流水线

lego-hunter 没有数据库、没有缓存、不依赖大模型做分析——全部纯内存实时计算（见 lego-hunter/README.md 的架构图）。

第一步：TinyFish Search 自动定位真实商品页

前端提交套装名后，lego-hunter/app/api/discover-retailers/route.ts 会并发发起两组 TinyFish Search 查询：

• 一组定向搜索 lego.com、amazon.com、target.com 等已知乐高零售商；
• 一组做更宽泛的补充搜索，兜底任何有货的渠道。

随后自动过滤 Reddit、Quora、YouTube 等聚合站，按域名去重，最多取 12 家零售商的真实商品页 URL——不靠 AI 编造链接。

第二步：并行浏览器 Agent 实时采集库存与价格

拿到 URL 后，lego-hunter/app/api/search-lego/route.ts 用Promise.allSettled让每家零售商各开一个 TinyFish 浏览器 Agent 同时开跑。每个 Agent 打开页面、找到对应套装，并只返回结构化 JSON：

{ "inStock": true, "price": "99.99", "currency": "USD", "shipping": "Free shipping", "productUrl": "..." }

一个值得学习的工程细节：代码中特意注明COMPLETED状态只表示浏览器没崩溃，必须校验返回内容本身，不能只信状态码——这是写爬虫类项目的通用教训。

第三步：SSE 流式推送 + 自动算出最便宜交易

Agent 的每一步进展（打开哪个页面、正在做什么）都通过 Server-Sent Events 实时推给前端，你在界面里能看到每家零售商的"直播画面"。全部完成后，应用在有货结果中取最低价，生成含"总花费 + 运费"对比的最佳交易卡片，全程零 LLM 成本。

⚡ 快速上手：三步跑起来 lego-hunter

前置条件

• Node.js22.x
• 一个 TinyFish API Key（在 TinyFish 平台获取，Search 与 Fetch 能力对开发者免费开放）

3 条命令本地运行

git clone https://gitcode.com/gh_mirrors/ti/tinyfish-cookbook cd tinyfish-cookbook/lego-hunter && npm install cp .env.example .env.local # 填入 TINYFISH_API_KEY=你的密钥 npm run dev # 打开 http://localhost:3000

打开页面后输入套装名、可选填最高预算，点击HUNT FOR STOCK即可看到 15 家零售商的状态卡从 idle 逐个亮起。

📁 项目结构与源码地图

🎯 适合谁学？

• 抢货玩家：绝版乐高、热门套装补货时多平台比价，省下的运费可能远超差价；
• AI 应用新手：想学"搜索 + 并行 Agent + 流式更新"这条真实产品链路的完整参考实现，代码量小、零数据库，极易读；
• 想造自己监控工具的人：把零售商列表换成机票、演唱会门票、球鞋渠道，这套骨架直接就能用。

tinyfish-cookbook 里还有竞品分析、市场调研等更多同款示例（见仓库根目录 README.md），可以照着 lego-hunter 的思路继续"抄作业"。

【免费下载链接】tinyfish-cookbookA collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build!项目地址: https://gitcode.com/gh_mirrors/ti/tinyfish-cookbook