clifood

MIT License

API-first CLI for iFood built for AI agents. It uses your authenticated browser session to call iFood’s internal APIs directly (search, catalog, cart, discovery) and only opens pages for login/address setup and checkout review. No UI scraping is required.

What this is for:

• Find restaurants and items quickly
• Build carts and prep orders
• Hand off to checkout for a human confirmation (no auto-submit by default)

Quick start

bun install
# Optional: install Playwright's bundled browser
bunx playwright install chromium

# Run a quick restaurant search (API)
bun src/cli.ts restaurants --query "pizza" --limit 5 --json

Global install (local)

From the repo root:

bun install
bun run build

# Option 1: Bun link (recommended for local dev)
bun link
clifood restaurants --query "pizza" --limit 5

# Option 2: npm global install from local path
npm install -g .
clifood restaurants --query "pizza" --limit 5

Global install (GitHub via Bun)

Bun can install directly from GitHub:

bun add -g github:danizord/clifood
clifood restaurants --query "pizza" --limit 5

Use your existing logged-in browser (recommended)

Start Chrome with remote debugging enabled, then point the CLI to it:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.clifood/chrome-profile"

# Then run (direct or global)
bun src/cli.ts restaurants --query "japonesa" --cdp-url http://127.0.0.1:9222
clifood restaurants --query "japonesa" --cdp-url http://127.0.0.1:9222

This keeps your existing iFood login and address selection. All API calls are executed from your authenticated browser context to avoid bot blocks.

Commands

Open iFood (manual setup)

clifood open --wait

Use this to log in or set your delivery address in the connected browser profile.

Search restaurants

clifood restaurants --query "sushi" --limit 10

Exclude categories or names:

clifood restaurants --query "a" --exclude pizza --exclude hamburguer --exclude doces --limit 10

Shortcut:

clifood restaurants --query "a" --exclude-defaults --limit 10

Defaults cover pizza, burgers, and sweets (including lanches, açaí, sorvetes, bolos).

Top restaurants (discovery feed, no search term):

clifood restaurants --top --exclude-defaults --limit 10

Search items in a restaurant

clifood items --restaurant "Restaurante X" --query "temaki" --limit 10

You can also pass a full iFood restaurant URL with --restaurant.

Place an order

clifood order \
  --restaurant "Restaurante X" \
  --item "Temaki de salmão:2" \
  --item "Guioza" \
  --confirm

Safety: without --confirm, the CLI opens checkout but does not submit the order.

Configuration

Config lives at ~/.clifood/config.json. You can also override via CLI flags or environment variables.

bun src/cli.ts config show
bun src/cli.ts config set cdpUrl http://127.0.0.1:9222
bun src/cli.ts config set headless false

Supported keys: cdpUrl, profileDir, headless, slowMo, locale, timeoutMs.

Environment overrides:

• IFOOD_CDP_URL
• IFOOD_PROFILE_DIR
• IFOOD_HEADLESS
• IFOOD_SLOW_MO
• IFOOD_LOCALE
• IFOOD_TIMEOUT_MS

Notes

• The CLI is API-first and depends on a valid logged-in browser session.
• Some menu items require mandatory option choices; the CLI auto-selects minimum required options from the catalog data.
• Read docs/architecture.md for the exact API flow and data dependencies.
• Read docs/troubleshooting.md if you hit auth or anti-bot issues.