food402

Food402 是一款专为土耳其市场设计的 Trendyol GO 外卖订餐自动化技能，通过官方 API 实现从餐厅发现到 3D Secure 支付的全流程覆盖。

核心用法遵循严格的七步工作流：首先必须选择配送地址以确定服务范围，随后可浏览附近餐厅或搜索特定美食，查看菜单详情与定制选项后添加至购物车，最后通过 3D Secure 验证完成支付。该技能支持完整的地址管理，包括城市、区县、街道的层级选择，以及订单历史查询和购物车灵活管理。

显著优点在于其完整的业务闭环能力。不同于简单的 API 包装，Food402 实现了餐厅评分对比、菜品定制（配料增减、规格选择）、智能推荐等高级功能，并原生支持土耳其本地的 3D Secure 支付验证流程，确保交易安全。地址管理功能尤为细致，支持电梯可用性、楼层门牌号等本地化字段。

潜在局限性包括明显的地域限制——仅服务土耳其地区，且需要用户拥有 Trendyol GO 账号。作为 T3 级社区项目，非官方背书意味着 API 变更响应可能存在延迟。此外，新增地址时如遇 429 状态码需跳转官网完成 OTP 验证，一定程度上破坏了自动化体验。

适合目标群体包括在土耳其生活工作的中文用户、需要批量管理订餐的商务人士，以及希望将外卖订购集成到个人自动化工作流的开发者。对于偶尔订餐的普通用户，官方 App 可能更为便捷。

使用风险主要集中在凭证安全与网络依赖。虽然代码本身通过 A 级安全认证，但用户需妥善保管 TGO_EMAIL 和 TGO_PASSWORD 环境变量。所有操作依赖 Trendyol API 的稳定性，如遇 5xx 错误或支付网关故障可能导致订单中断。建议仅在可信网络环境下使用，并确认敏感操作前仔细核对订单金额与餐厅信息。

核心功能

Food402 是一款面向 Trendyol GO（TGO Yemek）外卖平台的命令行工具，完整覆盖了从地址管理、餐厅发现、菜单浏览、购物车操作到 3D Secure 支付的全流程。用户可通过纯 Bash 脚本实现无需打开 App 的自动化订餐体验。

核心用法流程：
1. 地址设置：调用 select_address 确定配送位置（必需前置步骤）
2. 餐厅发现：get_restaurants 按推荐/距离/评分排序，或 search_restaurants 关键词搜索（含产品价格）
3. 菜单浏览：get_restaurant_menu 获取分类菜单，get_product_details 查看配料排除与加料选项
4. 购物车管理：add_to_basket 添加商品（支持复杂 modifiers），get_basket 查看，remove_from_basket/clear_basket 清理
5. 支付结算：checkout_ready 验证购物车，place_order 完成 3D Secure 支付流程

显著优点：

• 功能完整：覆盖外卖平台全部核心功能，包括地址管理、历史订单查询、Google Reviews 评分对比
• 轻量无依赖：纯 Bash 实现，仅依赖系统标准工具（curl、jq、openssl），无第三方包供应链风险
• 安全设计：用户凭证通过环境变量读取，JWT Token 缓存于 /tmp 并带 60 秒过期缓冲，无硬编码密钥
• 官方 API：所有网络请求均指向 Trendyol 官方域名（api.tgoapis.com、payment.tgoapps.com），TLS 加密传输

潜在局限与风险：

• 地域限制：仅支持土耳其地区，需有效的 TGO 账号与土耳其本地地址
• 3D Secure 交互：支付环节需人工在浏览器完成银行验证，无法完全自动化
• T3 来源可信度：维护者为 GitHub 个人开发者（rersozlu），属社区项目级别，建议审查后使用
• 临时文件权限：Token 缓存文件未显式设置 600 权限，多用户环境存在读取风险
• 速率限制敏感：地址新增等操作触发 429 时需 OTP 验证，需引导用户至官网完成

适合人群：

• 在土耳其生活、工作的中文用户
• 习惯命令行效率、希望快速复购常订餐品的重度外卖用户
• 需要自动化脚本处理批量订餐或订单追踪的开发者

常规风险提醒：

• 妥善保管 TGO_EMAIL/TGO_PASSWORD 环境变量，避免提交至代码仓库
• 定期检查 /tmp/food402-token* 残留文件
• 关注上游仓库更新，及时同步安全修复