核心用法
weather-pollen 是一款轻量化的天气与花粉数据查询 Skill,通过调用 Open-Meteo 和 Pollen.com 的免费 API,为用户提供当前天气状况、天气预报及花粉浓度信息。用户可通过 weather_report 工具获取数据,支持通过环境变量 WEATHER_LAT、WEATHER_LON 和 WEATHER_LOCATION 自定义查询位置,默认配置为美国德克萨斯州安娜市。该 Skill 无需申请 API Key,开箱即用,特别适合需要快速集成天气数据的场景。
显著优点
首先,成本优势显著,完全依赖免费公开的 API 接口,无需支付费用或申请密钥即可使用。其次,代码安全性高,通过 BSS 安全认证 A 级评级,采用 TypeScript 开发,使用 zod 库进行严格的输入参数验证,无 eval、exec 等危险函数,无动态代码加载行为。第三,隐私保护到位,不收集用户个人信息,不向第三方上传本地文件,所有网络请求均指向可信的公共数据服务。第四,配置灵活,支持通过环境变量自定义地理位置,满足不同用户的本地化需求。
潜在缺点或局限性
该 Skill 存在外部依赖风险,完全依赖 Open-Meteo 和 Pollen.com 的服务可用性,若 API 服务中断或限制访问,功能将受到影响。代码层面存在硬编码问题,花粉数据查询使用了固定的 ZIP 代码(75409),虽可通过配置调整位置显示名称,但实际数据获取仍受限于硬编码区域。依赖管理方面,zod 库使用了宽松的版本范围(^4.3.5),可能存在依赖漂移风险。此外,作为个人开发者项目(T3 来源),长期维护更新存在一定不确定性。
适合的目标群体
主要适合过敏性鼻炎患者、哮喘患者等需要关注花粉浓度的人群,帮助其规划户外活动。同时适合户外运动爱好者、旅游规划者获取目的地天气信息。对于开发者而言,这也是学习 TypeScript Skill 开发的优质示例代码。由于无需复杂配置,普通用户也可直接用于日常天气查询。
使用风险
网络依赖风险:必须保持网络连接才能获取数据,完全离线环境无法使用。API 稳定性风险:免费 API 可能存在请求频率限制或服务的变更。数据准确性风险:花粉数据依赖硬编码 ZIP 代码区域,若用户未正确配置环境变量,显示位置与实际数据可能不匹配。依赖安全风险:尽管 zod 是可信库,但宽松版本号可能导致自动更新引入不兼容变更。建议商业生产环境使用前锁定依赖版本并监控 API 服务状态。