weather-pollen

🌤️ 免费精准的天气花粉监测助手

基于 Open-Meteo 和 Pollen.com 免费 API,无需密钥即可获取全球天气与花粉数据,助力过敏人群科学防护。

收藏
11.9k
安装
3k
版本
v1.0.3
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

weather-pollen 是一款轻量化的天气与花粉数据查询 Skill,通过调用 Open-Meteo 和 Pollen.com 的免费 API,为用户提供当前天气状况、天气预报及花粉浓度信息。用户可通过 weather_report 工具获取数据,支持通过环境变量 WEATHER_LATWEATHER_LONWEATHER_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 服务状态。

安全解读

核心用法

weather-pollen 是一款轻量级天气与花粉查询 Skill,通过调用 Open-Meteo(天气)和 Pollen.com(花粉)两大免费公开 API,为用户提供实时天气状况、预报及花粉浓度数据。使用时只需通过 weather_report 工具传入目标地点(如 "Anna, TX"),即可一次性获取完整气象与过敏风险信息。配置灵活,支持通过环境变量设置默认坐标(WEATHER_LAT/LON)和显示名称(WEATHER_LOCATION),开箱即用。

显著优点

  • 零成本使用:完全依赖免费公开 API,无需注册账号或申请 API Key,降低使用门槛
  • 隐私友好:仅传输地理位置坐标,不收集用户身份、设备信息等敏感数据
  • 单一依赖:代码库仅依赖 zod 进行 schema 验证,攻击面极小,供应链风险可控
  • 配置便捷:环境变量即可完成功能配置,无复杂授权流程
  • 过敏防护价值:整合花粉数据,对季节性过敏人群具有实用健康参考价值

潜在缺点与局限性

  • 地理覆盖限制:Pollen.com 主要覆盖北美地区,非美国/加拿大用户可能无法获取花粉数据
  • API 稳定性依赖:第三方免费服务无 SLA 保障,存在服务中断或限流风险
  • 数据精度一般:免费 API 数据粒度与专业气象服务相比存在一定差距
  • 无历史数据:仅支持当前及预报查询,无法追溯过往天气/花粉记录

适合人群

  • 季节性过敏患者及需要日常花粉监测的健康关注者
  • 对天气信息有基础查询需求的普通用户
  • 重视隐私、不愿注册账号或分享个人数据的敏感用户
  • 北美地区居民(花粉数据覆盖最佳)

常规风险

  • API 服务变更:Open-Meteo 或 Pollen.com 可能调整服务条款或端点,需关注维护者更新
  • 网络超时:当前实现未设置 fetch 超时,极端网络环境下可能挂起
  • 坐标隐私:虽然仅传输坐标,但精确 GPS 信息理论上可用于位置推断(尽管风险极低)

weather-pollen 内容

手动下载zip · 3.9 kB
logic.tstext/plain
请选择文件