Instacart 是一个面向开发者的集成工具，专为构建与 Instacart 平台深度对接的应用而设计。它通过标准化的 MCP（Model Context Protocol）和 REST API 接口，支持菜谱页、购物清单生成以及附近零售商查询等核心功能。该工具要求用户首先完成本地配置和环境设置，确保 API 密钥安全存储于环境变量中，避免在聊天界面直接暴露敏感信息。所有操作均基于预定义的集成规则，涵盖认证流程、请求格式、数据缓存策略及生产环境发布规范，旨在帮助开发者高效、合规地接入 Instacart 的开发者平台。 该工具的核心优势在于其清晰的架构分层与严格的运行约束。系统将关键上下文、用户交互逻辑和操作边界记录在 `~/instacart/` 目录下的多个 Markdown 文件中，包括记忆模板、端点映射、错误日志和上线审批状态。这种结构化的本地存储方式不仅便于调试和追踪问题，也确保了不同开发阶段的行为一致性。同时，工具明确区分了三种主要接入面：Developer Platform REST（用于创建可购物页面）、MCP（供智能体调用原生函数如创建菜谱或清单）以及 Instacart Connect（适用于品牌电商和履约场景），防止因误用接口导致认证失败或功能异常。 此外，Instacart 工具强调输入数据的标准化与匹配效率。例如，在提交商品项时，必须将品牌偏好放入 `brand_filters` 而非混杂于产品名称中，使用统一单位（如 `each` 表示单个计数），并优先采用 `product_ids` 或 `upcs` 中的一种以避免重复标识错误。地理定位方面，系统依赖邮政编码与国家代码进行零售商匹配，但明确指出并非所有地区都能保证完整的商品覆盖。整体而言，该工具适合已具备基础集成能力、希望快速实现 Instacart 内容嵌入或自动化购物流程的技术团队。
核心功能特点
- 支持通过 MCP 和 REST API 构建可购物菜谱页与智能体驱动的购物清单
- 提供本地记忆文件管理集成上下文、缓存链接和错误日志
- 严格遵循 Instacart 认证环境与权限模型，禁止在生产前使用未批准密钥
适用场景
Instacart 工具最适合需要与 Instacart 平台深度集成的技术场景，尤其是在开发面向消费者的购物体验时。典型应用包括为食谱网站自动生成带有购买链接的‘一键购’菜谱页，或将用户自定义食材列表转化为可在 Instacart 上直接下单的购物清单。这些功能依赖于准确的 API 调用和数据格式化，而该工具通过预设的请求模式和缓存机制显著降低了重复请求带来的资源浪费和链接失效风险。 另一个常见使用场景是零售合作伙伴希望在其自有平台展示附近 Instacart 合作门店的商品信息。此时可通过工具执行零售商查询接口，获取基于用户地理位置的有效 `retailer_key`，从而引导流量至最相关的门店页面。值得注意的是，此类操作需提前验证目标地区的商品覆盖范围，因为即使邮编有效，也可能存在部分品类缺失的情况。此外，对于内部测试或沙盒环境中的功能验证，开发者可利用本地存储的记忆文件快速复现问题现场，结合错误日志分析请求失败原因，提升调试效率。 该工具还适用于需要遵守 Instacart 品牌指南和市场发布规范的项目。在正式上线前，必须完成开发测试并通过官方审核流程，否则即使持有生产级 API 密钥也无法正常访问相关服务。因此，任何涉及公开宣传材料、UI 组件或营销文案的更新都应参照 `launch-notes.md` 中的约束条件进行审核，避免因违规使用 logo 或夸大功能描述而导致项目被拒。