Pp Grubhub

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/grubhub/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Grubhub — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the grubhub-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install grubhub --cli-only

2. Verify: grubhub-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/commerce/grubhub/cmd/grubhub-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

grubhub-pp-cli browses Grubhub's marketplace from the command line: search restaurants by street address, browse full menus, and compare delivery fees, minimums, and ETAs across the whole neighborhood at once with compare. It caches restaurants and menus in a local SQLite store so dish can full-text-search menu items across nearby restaurants and deals can rank every active offer in one sweep. No API key required — it mints an anonymous Grubhub token for you.

When to Use This CLI

Use grubhub-pp-cli when a user wants to find, compare, or order-research food delivery near an address: cheapest or fastest restaurant, a specific dish across the neighborhood, or the best current deal. It is ideal for agents that need deterministic JSON about restaurants, fees, menus, and offers without scraping the Grubhub web app. The local cache makes repeated comparisons over the same location fast and offline.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to place an order or manage a cart — it is read-only marketplace browsing.
• Do not use this CLI for order history or account/rewards data — logged-in features require a real Grubhub account login that this version does not support.
• Do not use this CLI for DoorDash, Uber Eats, or other delivery services — it only covers Grubhub/Seamless.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• compare — See delivery fee, minimum, ETA, rating, and distance for every nearby restaurant side by side, sorted however you want.

  Reach for this when a user wants the cheapest or fastest option across the whole neighborhood, not one restaurant at a time.

  grubhub-pp-cli compare "350 5th Ave, New York, NY" --sort eta --agent

• dish — Find which nearby restaurants carry a specific dish, with price, by full-text searching cached menus across the neighborhood.

  Reach for this when the user names a dish, not a restaurant: 'who near me has a poke bowl under $15'.

  grubhub-pp-cli dish "350 5th Ave, New York, NY" "poke bowl" --max-price 15 --agent

Deal hunting

• deals — Rank every nearby restaurant currently running an offer, coupon, or promo code in one sweep.

  Reach for this when the deal should pick the restaurant, not the other way around.

  grubhub-pp-cli deals "350 5th Ave, New York, NY" --agent

• pick — Get one recommended restaurant from a transparent score over fee, rating, active deals, and ETA.

  Reach for this when the user wants a single 'just pick one' answer with a visible score breakdown.

  grubhub-pp-cli pick "350 5th Ave, New York, NY" --weight-deal 2 --agent

Command Reference

Primary (address-based, zero setup — auto-geocode + anonymous token)

• grubhub-pp-cli near <address> — Search restaurants near a street address (filters: --cuisine, --pickup, --sort, --open-now, --limit)
• grubhub-pp-cli compare <address> — Sortable delivery fee/minimum/ETA/rating board (filters: --sort, --max-fee, --max-min, --eta-under)
• grubhub-pp-cli dish <address> <query> — Find which nearby restaurants carry a dish (--max-price, --diet, --max-scan-restaurants; --data-source local for cached)
• grubhub-pp-cli deals <address> — Rank nearby restaurants by active offers/coupons (--sort value|count)
• grubhub-pp-cli pick <address> — One recommended restaurant from a transparent score (--weight-fee/-eta/-rating/-deal)
• grubhub-pp-cli menu <restaurant-id> — Browse a restaurant's full menu (--category, --popular, --limit)
• grubhub-pp-cli item <restaurant-id> <item-id> — Show a menu item's modifiers and prices
• grubhub-pp-cli geocode <address> — Resolve a street address to coordinates

Raw API surface (hidden; needs auth login or GRUBHUB_TOKEN; takes POINT(lng lat))

• grubhub-pp-cli restaurants search — Raw restaurant search by location
• grubhub-pp-cli restaurants get <id> — Raw restaurant details + full menu
• grubhub-pp-cli restaurants menu-item <id> <item-id> — Raw menu item detail

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

grubhub-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Cheapest fast delivery near an address

grubhub-pp-cli compare "350 5th Ave, New York, NY" --sort fee --eta-under 30 --agent

Comparison board filtered to sub-30-minute ETAs, cheapest delivery first, as agent JSON.

Find a dish across the neighborhood

grubhub-pp-cli dish "1 Infinite Loop, Cupertino, CA" "burrito" --max-price 12

Full-text search of cached menus for burritos under $12 at any nearby restaurant.

Pull a full menu as compact JSON for an agent

grubhub-pp-cli menu 1414955 --agent --select menu_category_list.menu_item_list.name,menu_category_list.menu_item_list.price

Restaurant menus are deeply nested; --select narrows the payload to item names and prices so agents don't burn context on the full blob.

Let the deal pick the restaurant

grubhub-pp-cli deals "350 5th Ave, New York, NY" --sort value

Ranks every nearby restaurant running an offer by value in one sweep.