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

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.