TinyFish Cookbook越南黑客松案例集：6个出行、金融、零售与餐饮行业的AI Web代理解决方案

TinyFish Cookbook越南黑客松案例集：6个出行、金融、零售与餐饮行业的AI Web代理解决方案

【免费下载链接】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 仓库中的越南黑客松案例集：6 个基于 TinyFish AI Web 代理搭建的开源应用，覆盖出行、金融、零售与餐饮 4 大行业。每个案例都能直接克隆运行，是学习"AI 代理如何真正操作网页"的完整教程。

黑客松背景：Agentic AI Build Week 是什么？

这 6 个项目来自 2026 年 7 月在胡志明市举办的Agentic AI Build Week（AABW）黑客松，每个案例都对应一条官方赛道（Tasco 出行、Shinhan 金融、KFC 餐饮、Phong Vu 零售等）。官方赛道与案例的完整映射表见 AABW_Vietnam_Hackathon_Samples/README.md。

1️⃣ FareGuard：机票价格监控，企业差旅成本控制的"哨兵"

FareGuard 面向企业的差旅/财务团队（而非个人订票），核心机制非常值得学习：

• 7 个 TinyFish 代理并行工作，分别盯住 Vietjet、Vietnam Airlines、Bamboo Airways、Traveloka、Baolau、12Bay 与 Skyscanner VN 的价格页面；
• 6 个站点走TinyFish Agent API（隐身模式浏览器自动化，因为这些站点的搜索框没有可分享的直达链接）；Skyscanner VN 则走更轻量的TinyFish Fetch API——它有公开的深链格式，页面本身就带答案，无需点击，更快更省；
• 每8 小时扫描一次，把完整价格历史交给 LLM（Groq Llama 3.3 70B）生成"何时订最划算"的建议；
• 设定"阈值价"后，票价跌到位时状态自动翻转，为下一步的自动订票铺路。

📄 详细实现：fareguard/README.md

2️⃣ FinSight：越南 B2B 市场情报，会"诚实打分"的研究助理

FinSight 把自然语言问题（如"胡志明市一区商铺租金多少？"）转成结构化情报简报，流水线是：

多角度搜索 → 来源排序 → 并发抓取 → 预检信号 → LLM 综合成文

• TinyFish Search发现越南本地实时信源（越南编辑域名优先）；
• TinyFish Fetch把 JS 重度依赖的站点（GrabFood、ShopeeFood、Batdongsan、越南央行 SBV 通函）提取成 token 高效的 Markdown；
• 最打动人的设计：置信度诚实分级——来源质量足够时输出董事会级简报，数据不足时直接标注not_answered，绝不编造占位指标。

📄 架构与查询类型：finsight/README.md

3️⃣ RateRadar：银行利率对比神器，并行自动填表但"点到为止"

RateRadar 是 6 个案例中"代理操作边界"设计得最教科书级的一个：

1. 选择产品——12 个月定存、房贷或消费贷；
2. 对比 Shinhan 与 Vietcombank、Techcombank、VPBank、BIDV、MB Bank 共6 家银行的实时利率，存款比最高年化、贷款比最低利率；
3. 填一次个人信息，每家银行一个 TinyFish 代理并行填写对方真实申请页面上的表单；
4. ⚠️ 硬性安全线：代理永远停在"提交"按钮之前，绝不代用户完成具有法律约束力的金融申请，由用户自己点最后一下。

4️⃣ MarketPulse：零售竞品价格追踪 + 自动补货申请草稿

面向越南电子零售商，每日上午 8 点（越南时间）由 GitHub Actions 触发5 个 TinyFish 代理并行采集 The Gioi Di Dong、FPT Shop、CellphoneS、Nguyen Kim、Gear.vn 的真实价格与库存。

当自家商品跌破库存阈值时，进入 AI 补货流程：标记 → AI 按固定供应商模板起草补货申请（结合真实竞品价格上下文）→ 人工审阅 → 提交。AI 承诺"从不编造数字"——数据缺失时如实说明而非瞎猜。

5️⃣ MónAI：餐饮趋势情报，比竞品抢先一步上新

MónAI 帮咖啡连锁、餐饮集团和食品厂商做一件事：在竞品上新前发现病毒式流行菜品。工作流像夹越南法棍面包一样层层叠加：

Detect（监控 TikTok/Facebook/外卖平台信号）→ Validate → Analyze（菜单缺口分析）→ Rank → Source（供应商发现）→ RFQ（询盘邮件）→ Launch（抢先上新）

前端甚至把整套流程做成了"一层层组装法棍"的创意落地页，设计系统直接取材越南菜——辣椒红、罗勒绿、鱼露棕，极具黑客松气质。后端每个情报接口都遵循同一管线：TinyFish 采集信号 → OpenAI 结构化分析 → 返回 JSON。

6️⃣ Founder Mode：创业申请副驾驶，真的会替你填真实表单

面向越南创业生态：每天凌晨 4 点（UTC）自动扫描VIISA、VSV Capital、ThinkZone、Antler、Techfest、F6S共 6 个加速器/资助源，提取真实申请页面上的每一道题（含字数限制），再用 AI 基于你的"公司档案"逐题起草答案——绝不虚构档案之外的信息。

流程：Discovered → Extracting → Drafting → Ready for review → Submitted。提交环节是真实操作：代理把（可编辑的）答案填进真实表单并提交。注意作者刻意避开了 LinkedIn/Crunchbase 这类禁止爬取或反爬严格的平台，这在代理开发中是很好的合规示范。

6 个案例背后的共同架构模式

想复用这套方案？记住这个"三件套"结构，6 个案例几乎全部采用：

GitHub Actions（定时调度，无时长限制） → 多个 TinyFish 代理并行采集 → 写入 Redis Vercel（部署的看板站） → 只读 Redis，打开页面绝不触发爬取 → "立即扫描"按钮远程触发 GitHub Actions

为什么这样设计？一次多站点扫描往往超过 Vercel 函数 60 秒的执行时限，所以把"重活"放 GitHub Actions，站点只做"读"。此外所有案例都内置模拟数据兜底：不配TINYFISH_API_KEY也能跑起来，新手零门槛体验。

新手上手：克隆仓库并本地运行这 6 个 AI Web 代理

git clone https://gitcode.com/gh_mirrors/ti/tinyfish-cookbook cd tinyfish-cookbook/AABW_Vietnam_Hackathon_Samples/fareguard npm install npm run dev

无需任何密钥即可启动（使用内置种子数据）；在.env.local里加上TINYFISH_API_KEY后，首次加载会自动执行一次真实的代理扫描。其余 5 个案例运行方式类似，各项目的完整环境变量与部署清单见对应 README：

• fareguard/README.md
• finsight/README.md
• founder-mode/README.md
• market-pulse/README.md
• monai/README.md
• rateradar/README.md

💡 学习建议：先读 FareGuard 理解"定时扫描 + 只读看板"骨架，再看 RateRadar 的"安全边界"设计，最后动手改一个扫描脚本，你就掌握了 AI Web 代理的完整工程范式。

【免费下载链接】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