| name | pp-grubhub |
| description | Every Grubhub restaurant search, plus a sortable delivery-fee comparison board, a cross-restaurant deal radar Trigger phrases: `find restaurants near me on grubhub`, `compare grubhub delivery fees`, `who near me has a poke bowl`, `grubhub deals near`, `what should I order on grubhub`, `use grubhub`, `run grubhub`. |
| author | Vincent Colombo |
| license | Apache-2.0 |
| argument-hint | <command> [args] | install cli|mcp |
| allowed-tools | Read Bash |
| metadata | {"openclaw":{"requires":{"bins":["grubhub-pp-cli"]},"install":[{"kind":"go","bins":["grubhub-pp-cli"],"module":"github.com/mvanhorn/printing-press-library/library/commerce/grubhub/cmd/grubhub-pp-cli"}]}} |
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:
- 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
- Verify:
grubhub-pp-cli --version
- 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.4 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.
Auth Setup
Grubhub has no public API key. grubhub-pp-cli authenticates exactly like the website: it scrapes a fresh anonymous client id from grubhub.com and mints a short-lived bearer token automatically on first use, caching it locally. You don't set anything. For the raw restaurants endpoint commands you can optionally run grubhub-pp-cli auth login (still credential-free) or set GRUBHUB_TOKEN. Logged-in features like order history are not supported in this version.
Run grubhub-pp-cli doctor to verify setup.
Agent Mode
Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.
-
Pipeable — JSON on stdout, errors on stderr
-
Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
grubhub-pp-cli restaurants get mock-value --agent --select id,name,status
-
Previewable — --dry-run shows the request without sending
-
Offline-friendly — sync/search commands can use the local SQLite store when available
-
Non-interactive — never prompts, every input is a flag
-
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests
Response envelope
Commands that read from the local store or the API wrap output in a provenance envelope:
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
grubhub-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
grubhub-pp-cli feedback --stdin < notes.txt
grubhub-pp-cli feedback list --json --limit 10
Entries are stored locally at ~/.local/share/grubhub-pp-cli/feedback.jsonl. They are never POSTed unless GRUBHUB_FEEDBACK_ENDPOINT is set AND either --send is passed or GRUBHUB_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
Output Delivery
Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
| Sink | Effect |
|---|
stdout | Default; write to stdout only |
file:<path> | Atomically write output to <path> (tmp + rename) |
webhook:<url> | POST the output body to the URL (application/json or application/x-ndjson when --compact) |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
Named Profiles
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
grubhub-pp-cli profile save briefing --json
grubhub-pp-cli --profile briefing restaurants get mock-value
grubhub-pp-cli profile list --json
grubhub-pp-cli profile show briefing
grubhub-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or --help → show grubhub-pp-cli --help output
- Starts with
install → ends with mcp → MCP installation; otherwise → see Prerequisites above
- Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
- Install the MCP server:
go install github.com/mvanhorn/printing-press-library/library/commerce/grubhub/cmd/grubhub-pp-mcp@latest
- Register with Claude Code:
claude mcp add grubhub-pp-mcp -- grubhub-pp-mcp
- Verify:
claude mcp list
Direct Use
- Check if installed:
which grubhub-pp-cli
If not found, offer to install (see Prerequisites at the top of this skill).
- Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agent flag:
grubhub-pp-cli <command> [subcommand] [args] --agent
- If ambiguous, drill into subcommand help:
grubhub-pp-cli <command> --help.