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
code
"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
code
🍺 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
Platform note: If your human is on Windows, they'll need WSL, Git Bash, or Cygwin to run this skill.
Script location: {skill_folder}/breweries (wrapper) → scripts/breweries
When user asks about breweries:
- •Run
./breweries search "name"to find by name - •Run
./breweries city "city"for location-based search - •Run
./breweries state "state"for state-wide search - •Run
./breweries type brewpubfor specific types - •Run
./breweries randomfor 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]"orbreweries type micro
Don't use for: Bars without brewing, liquor stores, wine/spirits.