# Grubhub

> Grubhub

- Skill: `spike-faye-lei/grubhub` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/grubhub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/grubhub/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/grubhub

---

# Grubhub

## Overview
Grubhub is a food delivery platform (archetype: Food Delivery). Search restaurants, browse menus with prices, and check delivery time/fee estimates.

Responses are **adapter-trimmed** (camelCase, prices in USD dollars). Fields are clean and ready to use.

## Workflows

### Find restaurants and browse menu
1. `searchRestaurants(latitude, longitude, searchTerm)` → `restaurants[]` with `restaurantId`, `name`, ratings, fees
2. `getMenu(restaurantId)` → `categories[].items[]` with names and prices

### Check delivery details
1. `searchRestaurants(latitude, longitude)` → `restaurants[].restaurantId`
2. `getDeliveryEstimate(restaurantId)` → open/hours, delivery fee, pickup estimate, minimum order

## Operations

| Operation | Intent | Key Input | Top-level Shape | Notes |
|-----------|--------|-----------|-----------------|-------|
| searchRestaurants | find restaurants near a location | latitude, longitude, searchTerm? | `{ totalResults, restaurants[] }` | paginated via `pageNum`/`pageSize` |
| getMenu | browse restaurant menu | restaurantId ← searchRestaurants | `{ restaurantName, categories[] }` | items in `categories[].items[]` |
| getDeliveryEstimate | check delivery time and fees | restaurantId ← searchRestaurants | `{ open, openDelivery, deliveryFee, orderMinimum, … }` | money in USD; ranges in minutes |

## Field Reference

### searchRestaurants — `restaurants[]`
- `restaurantId` — unique ID (use with getMenu and getDeliveryEstimate)
- `name` — restaurant name
- `rating` — average rating (0-5 scale, null if too few)
- `ratingCount` — number of ratings
- `priceRating` — price tier (1-4, dollar signs)
- `cuisines` — array of cuisine strings
- `logo` — logo URL (nullable)
- `deliveryFee` — delivery fee in USD
- `deliveryEstimateMin` / `deliveryEstimateMax` — delivery time range in minutes (nullable)
- `address` — street address (nullable)
- `distance` — miles from delivery location (nullable)
- `totalResults` — total matching restaurants (top level)

### getMenu — `categories[]`
- `restaurantName` — restaurant name (top level)
- `categories[].name` — category name (e.g. "Appetizers", "Pizza")
- `categories[].items[].itemId` — menu item ID
- `categories[].items[].name` — item name
- `categories[].items[].description` — item description (nullable)
- `categories[].items[].price` — price in USD
- `categories[].items[].popular` — popular flag

### getDeliveryEstimate
- `restaurantId` — restaurant ID
- `open` / `openDelivery` / `openPickup` — availability flags
- `deliveryEstimateMin` / `deliveryEstimateMax` — delivery time range in minutes
- `pickupEstimateMin` / `pickupEstimateMax` — pickup time range in minutes (nullable)
- `deliveryFee` — delivery fee in USD
- `orderMinimum` — minimum order in USD
- `salesTax` — sales tax rate (e.g. 8.875 for 8.875%)

## Quick Start

```bash
# Search for pizza near Midtown Manhattan
openweb grubhub exec searchRestaurants '{"latitude": 40.7484, "longitude": -73.9857, "searchTerm": "pizza"}'

# Get a restaurant's menu
openweb grubhub exec getMenu '{"restaurantId": "64436"}'

# Check delivery estimate
openweb grubhub exec getDeliveryEstimate '{"restaurantId": "64436"}'
```