breweries

🍺 精酿啤酒厂智能发现助手

基于 Open Brewery DB 的啤酒厂查询工具,无需认证即可按名称、地点、类型搜索全球精酿酒厂信息。

收藏
8.5k
安装
2.4k
版本
v1.0.0
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

该 Skill 为 AI Agent 提供了一个便捷的啤酒厂信息查询接口,通过调用 Open Brewery DB 公共 API,支持多种搜索维度。用户可以通过名称搜索特定酒厂(breweries search "name"),按城市(breweries city "city")或州/省(breweries state "state")浏览当地酿造场所,也可按 brewery 类型筛选,包括微型酒厂(micro)、纳米酒厂(nano)、地区级酒厂(regional)、酿酒餐厅(brewpub)等10种分类。此外还支持随机推荐功能(breweries random [count]),适合寻求探索体验的用户。Skill 设计为 CLI 形式,Agent 可直接调用相应命令获取结构化结果。

显著优点在于零门槛使用——无需注册账号或申请 API 密钥,即开即用。数据覆盖全面,包含美国及其他地区的精酿啤酒厂信息,分类细致到可以区分微型酿造与合同酿造等不同业态。查询方式灵活,支持模糊搜索和地理维度筛选,结果以清晰的 emoji 标识和结构化文本呈现,便于 Agent 直接理解或展示给用户。对于旅行规划、本地探索或特定品牌查找场景都非常适用。

潜在缺点包括:作为 T3 级个人开发者作品,长期维护稳定性存在不确定性。数据完全依赖 Open Brewery DB,该数据源更新频率和准确性不受本 Skill 控制,且存在单点故障风险——若外部 API 服务中断或变更接口,功能将立即失效。此外,Skill 本身为纯文档型,实际执行依赖宿主环境的 bash/curl/jq 工具,在某些受限环境中可能无法运行。返回结果限制为最多10条,大数据量场景下需要多次查询。

适合的目标群体主要为精酿啤酒爱好者、旅行者、本地生活探索者,以及需要推荐特定类型饮酒场所(如 Brewpub)的用户。也适用于啤酒行业从业者进行市场调研或竞品分析。对于开发旅行类、生活方式类 AI 应用的开发者,该 Skill 提供了即插即用的啤酒厂数据接口。

使用风险方面,首要考虑网络依赖性,必须保持与 api.openbrewerydb.org 的连接。其次,数据源不包含实时营业状态、库存信息或用户评价,仅提供基础档案信息,不适合用于实时到店决策。由于来源为个人开发者,安全更新和功能迭代可能不及时。此外,虽然 Skill 本身无恶意代码,但实际使用时需注意调用环境的安全性,避免在不受信任的上下文中执行任意 CLI 命令。

安全解读

核心用法

breweries是一款面向AI智能体的轻量级CLI工具,旨在帮助用户快速查找全球精酿啤酒厂信息。该Skill完全基于纯Markdown文档实现,通过封装Open Brewery DB公开API提供查询能力,无需任何API密钥或账户注册即可使用。

支持多维度的查询方式:

  • 名称搜索breweries search "Sierra Nevada" — 模糊匹配啤酒厂名称
  • 城市定位breweries city "Portland" — 查找特定城市的啤酒厂
  • 州级筛选breweries state "Oregon" — 支持全称或缩写
  • 类型过滤breweries type brewpub — 涵盖10种专业分类(micro/nano/regional/brewpub/large/planning/bar/contract/proprietor/closed)
  • 随机发现breweries random 3 — 获取指定数量的随机推荐

输出格式简洁直观,包含啤酒厂名称、地理位置、类型标识及官网链接,并以啤酒emoji增强可读性。

显著优点

1. 零门槛接入:无需认证、无API Key、无账户注册,开箱即用
2. 轻量无依赖:纯文档型Skill,无本地可执行代码,仅依赖系统标准工具curl/jq

3. 开源透明:MIT协议,代码完全公开,API端点明确可查

4. 分类专业:10种精细化的啤酒厂类型划分,满足从精酿爱好者到行业研究的多层次需求

5. 隐私友好:不收集任何用户敏感信息,查询参数仅包含公开的地理位置和名称数据

潜在缺点与局限性

1. 外部服务依赖:核心功能完全依赖Open Brewery DB API的可用性,无SLA保障,存在服务中断或数据变更风险
2. 结果数量限制:单次查询最多返回10条结果,大规模数据获取需多次调用

3. 无高级筛选:不支持按营业时间、评分、酒款种类等维度进行精细化筛选

4. 数据覆盖盲区:主要覆盖北美市场,其他地区数据完整性有限

5. 静态数据局限:API数据更新频率未知,可能无法反映最新的开业/关闭状态

适合人群

  • 精酿啤酒爱好者:探索本地或旅行目的地的特色啤酒厂
  • 旅行规划者:将啤酒厂游览纳入行程安排的自助游用户
  • 行业研究人员:获取啤酒厂基础分布数据的轻量调研工具
  • AI智能体开发者:需要为助手集成本地生活服务能力的场景

常规风险

  • 服务可用性风险:第三方API可能因维护、限流或下线导致功能失效
  • 数据准确性风险:依赖社区维护的公开数据库,信息可能存在滞后或错误
  • 系统环境依赖:目标系统需预装curl和jq,在精简环境(如某些容器镜像)中可能无法运行
  • 无响应校验:当前实现缺少JSON Schema验证,API格式变更可能导致解析失败

breweries 内容

手动下载zip · 2.3 kB
README.mdtext/markdown
请选择文件