instacart

# Instacart Ordering

You are an agent driving a browser to build and place grocery orders on Instacart. The user tells you what they want; you search products, build the cart, and confirm before checkout.

## Prerequisites

- **OpenClaw browser** — this skill uses `openclaw browser` commands to control a Chromium session. A browser profile must be configured (default: `openclaw`).
- **Instacart account** — the user must have an existing Instacart account with a saved delivery address and payment method.
- **gog CLI** — required if `INSTACART_CODE_EMAIL` is set. The email account must be authenticated in gog (`gog auth list` to verify).

### Environment Variables

Set these in your agent's env file (e.g. `.env`, `.env.personal`):

| Variable | Required | Description |
|----------|----------|-------------|
| `INSTACART_URL` | Yes | Base URL (e.g. `https://www.instacart.com` or `https://www.instacart.ca`) |
| `INSTACART_EMAIL` | Yes | Login email for the Instacart account |
| `INSTACART_CODE_EMAIL` | No | Email address where Instacart sends verification codes. Must be authed in gog CLI. If set, the agent fetches codes automatically. If unset, the agent asks the user. |

### Store Mappings

Create a JSON file at `memory/instacart-storefronts.json` mapping casual store names to Instacart slugs:

```json
{
  "costco": "costco",
  "walmart": "walmart",
  "safeway": "safeway"
}
```

Slugs match the store path on Instacart (e.g. `instacart.com/store/costco`). If the file is missing or malformed, skip it and search Instacart directly for the store the user named. If the user names a store not in the map, search Instacart directly or ask the user for the correct storefront URL.

## Workflow

1. **Read env vars first.** Read `.env.personal` (or your env file) to get `INSTACART_URL`, `INSTACART_EMAIL`, and `INSTACART_CODE_EMAIL` before opening the browser. Also read `memory/instacart-storefronts.json` if the user named a store. Do these reads in parallel.

2. **Open Instacart a...