breweries

# Brewery Lookup CLI for AI agents to find breweries for their humans. "What breweries are in Portland?" — now your agent can answer. Uses Open Brewery DB. No account or API key needed. ## Usage ``` "Find breweries named Sierra Nevada" "What breweries are in San Diego?" "Show me breweries in Oregon" "Find me a random brewery" "What brewpubs are there?" ``` ## Commands | Action | Command | |--------|---------| | Search by name | `breweries search "name"` | | Find by city | `breweries city "city name"` | | Find by state | `breweries state "state"` | | Find by type | `breweries type <type>` | | Random | `breweries random [count]` | ### Brewery Types - `micro` — Most craft breweries - `nano` — Very small breweries - `regional` — Regional craft breweries - `brewpub` — Brewery with restaurant/bar - `large` — Large national breweries - `planning` — Breweries in planning - `bar` — Bars that brew on premises - `contract` — Contract brewing - `proprietor` — Alternating proprietor - `closed` — Closed breweries ### Examples ```bash breweries search "stone brewing" # Find breweries by name breweries city "portland" # Find breweries in Portland breweries state oregon # Find breweries in Oregon breweries type brewpub # Find all brewpubs breweries random 3 # Get 3 random breweries ``` ## Output ``` 🍺 Sierra Nevada Brewing Co. — Chico, California, Regional Brewery https://sierranevada.com ``` ## Notes - Uses Open Brewery DB API v1 (api.openbrewerydb.org) - No authentication required - No rate limiting documented - Returns up to 10 results per query - State names can be full name or abbreviation --- ## Agent Implementation Notes **Script location:** `{skill_folder}/breweries` (wrapper) → `scripts/breweries` **When user asks about breweries:** 1. Run `./breweries search "name"` to find by name 2. Run `./breweries city "city"` for location-based search 3. Run `./breweries state "state"` for state-wide search 4. Run `./breweries type brewpub` for specific types 5. Run `./breweries random` for discovery/recommendations **Common patterns:** - "Find me a brewery in [city]" → `breweries city "[city]"` - "What breweries are in [state]?" → `breweries state "[state]"` - "Search for [name] brewery" → `breweries search "[name]"` - "Surprise me with a brewery" → `breweries random` - "Where can I get craft beer in [city]?" → `breweries city "[city]"` or `breweries type micro` **Don't use for:** Bars without brewing, liquor stores, wine/spirits.