Weather Pollen

核心用法

weather-pollen 技能通过调用 Open-Meteo 和 Pollen.com 两大免费 API，提供指定位置的天气与花粉报告。用户需通过环境变量配置经纬度坐标（默认 Anna, TX），技能返回当前天气状况、预报信息及花粉过敏指数。

主要功能：

• 天气查询：温度、湿度、风速、降水概率、紫外线指数等
• 花粉数据：草类、树木、杂草等多类型花粉浓度等级
• 灵活配置：通过 WEATHER_LAT、WEATHER_LON、WEATHER_LOCATION 自定义位置

显著优点

1. 零成本使用：完全依赖免费 API，无需注册或 API 密钥
2. 隐私友好：不收集用户位置数据，坐标由用户主动配置
3. 开源生态：Open-Meteo 为知名开源气象项目，数据覆盖全球
4. 轻量依赖：仅需 curl，无复杂运行时要求

潜在缺点与局限性

1. 位置配置门槛：需手动查找并设置经纬度，对普通用户不够直观
2. 坐标硬编码风险：默认位置固定于美国德州，未配置则返回错误数据
3. API 可靠性：免费服务存在速率限制或宕机可能，无 SLA 保障
4. 花粉覆盖局限：Pollen.com 数据主要覆盖北美地区，其他区域可能缺失
5. 功能单一：不支持历史数据、极端天气预警或逐小时预报

适合人群

• 北美地区过敏症患者需日常花粉监测
• 开发者构建轻量级天气应用原型
• 注重隐私、不愿共享位置数据的用户
• 预算有限的个人项目或非营利组织

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据准确性 | 免费 API 数据精度低于商业气象服务 |

| 服务中断 | 依赖第三方免费服务，存在单点故障 |

| 配置错误 | 经纬度误配导致查询结果与实际位置不符 |

| 区域限制 | 非北美用户可能无法获取有效花粉数据 |

核心用法

weather-pollen 是一款轻量级天气与花粉数据查询 Skill，通过调用 Open-Meteo（天气）和 Pollen.com（花粉指数）两大免费 API，为用户提供当前天气状况、预报及花粉浓度报告。

基本调用方式：

• 通过 weather_report 工具查询指定位置数据
• 位置通过环境变量配置：WEATHER_LAT（纬度）、WEATHER_LON（经度）、WEATHER_LOCATION（显示名称）
• 支持可选参数 includePollen 控制是否返回花粉数据

配置示例：

export WEATHER_LAT=39.9042
export WEATHER_LON=116.4074
export WEATHER_LOCATION="Beijing, China"

显著优点

1. 零成本使用：两大核心 API 均为免费服务，无需注册获取 API 密钥，降低了使用门槛。
2. 数据权威：Open-Meteo 为开源气象数据服务，Pollen.com 由 IQVIA 运营，数据质量有保障。
3. 功能聚焦：代码结构清晰，仅执行声明的功能，无冗余逻辑或隐藏行为。
4. 安全通信：所有外部 API 均通过 HTTPS/TLS 加密传输，符合现代安全标准。
5. 输入验证：使用 Zod 对参数进行校验，降低注入攻击风险。

潜在缺点与局限性

1. 硬编码默认值：代码中硬编码了美国德克萨斯州安娜市（Anna, TX）的坐标和 ZIP 码作为默认值，用户未配置环境变量时可能意外泄露该位置信息。
2. API 依赖风险：Pollen.com 采用 session cookie 认证机制，若服务变更可能导致功能中断；且该服务主要覆盖美国地区，国际用户可能无法获取花粉数据。
3. T3 来源可信度：开发者 thesethrose 为个人账号，Skill 通过社区平台发布，长期维护稳定性需观察。
4. 无内置重试机制：外部 API 临时不可用时缺乏指数退避重试策略。
5. Telegram 推送依赖：若配置了 Telegram Bot，需妥善管理 bot token 安全。

适合人群

• 过敏症患者：需要每日关注花粉浓度以安排户外活动
• 户外爱好者：规划运动、旅行时参考天气与空气质量
• 智能家居用户：希望自动化获取天气报告并推送至消息渠道
• 开发者：作为调用公共 API 的轻量级示例代码参考

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 位置信息泄露 | 低 | 未配置环境变量时默认发送 Anna, TX 坐标至外部 API |

| 配置管理不当 | 低 | .env 文件方式存在意外提交版本控制风险 |

| API 服务中断 | 中 | 免费服务无 SLA 保障，Pollen.com 可能因会话机制变更失效 |

| 速率限制 | 低 | 高频调用可能触发 API 限制，建议添加缓存机制 |