Back to skills
extension
Category: OtherNo API key required

北京花粉监测

查询北京花粉实时监测和预报数据,生成包含区级浓度、站点趋势、总量预报与分类预报的结果。北京 16 个固定站点,每区一个,用区名指定。

personAuthor: ruochenlyuhubclawhub

查询北京公共花粉监测与预报数据。北京共 16 个固定监测站(每区一个),用区名指定查询目标。

使用场景

使用本 skill 当用户需要:

  • 某个区今天的花粉情况和建议(优先用 daily
  • 某个区当前监测和全市概况(用 report
  • 北京全市花粉概览(用 overview
  • 全部站点实时读数(用 stations
  • 单站点 24 小时历史趋势(用 history
  • 查询某个区的花粉预报(用 forecast
  • 每天固定时间发送某个区的晨报(用 daily
  • 结构化 JSON 用于下游自动化

不要使用本 skill:

  • 查询北京以外的花粉数据
  • 直接发送通知(本 skill 只负责查询,通知由调用方处理)

入口

./scripts/beijing-pollen-query.sh query --mode <mode> [options]

推荐工作流:默认晨报

用户说"查一下海淀今天花粉"或"每天给我发花粉情况"时,优先使用 daily 模式:

# 文本格式 — 适合直接展示给用户或推送通知
./scripts/beijing-pollen-query.sh query --mode daily --district 海淀 --format text

读取返回 JSON 的 .data.text 字段即为可读晨报。

# JSON 格式 — 适合程序进一步处理
./scripts/beijing-pollen-query.sh query --mode daily --district 海淀

daily 模式自动完成:当前监测 + 24h 相对变化 + 今天总量预报 + 明后天趋势 + 分类提示,不再强调北京其他区。

推荐工作流:即时查询

用户说"看一下海淀现在花粉高不高"时,使用 report 模式:

./scripts/beijing-pollen-query.sh query --mode report --district 海淀 --format text

report 模式自动完成:查询全市概览 → 定位目标站点 → 获取 24h 历史 → 汇总为即时简报。

推荐工作流:预报查询

用户说"看一下海淀明天花粉"或"海淀区花粉预报怎么样"时,使用 forecast 模式:

./scripts/beijing-pollen-query.sh query --mode forecast --district 海淀 --format text

forecast 模式返回:目标区总量等级预报 + 分类花粉预报 + 对应解释。

推荐工作流:定时晨报

用户说"每天早上 8 点发朝阳区今天花粉情况"时,优先使用 daily 模式:

./scripts/beijing-pollen-query.sh query --mode daily --district 朝阳 --format text

daily 模式自动完成:当前监测 + 24h 相对变化 + 今天总量预报 + 明后天趋势 + 分类提示,不再强调北京其他区。

模式选择

| 用户意图 | 模式 | 命令 | |---|---|---| | 某个区今天花粉情况 | daily | --mode daily --district 海淀 | | 某个区的即时监测简报 | report | --mode report --district 海淀 | | 全市概况 | overview | --mode overview | | 所有站点数据 | stations | --mode stations | | 某站点 24h 变化 | history | --mode history --district 朝阳 | | 某个区的花粉预报 | forecast | --mode forecast --district 海淀 | | 每日定时晨报 | daily | --mode daily --district 朝阳 |

参数

| 参数 | 说明 | 默认值 | |---|---|---| | --district | 区名,模糊匹配(海淀、海淀区均可) | — | | --station-id | 站点 ID(history 替代方式) | — | | --format | jsontext | json | | --limit | 热点站点数量 | 5 | | --timeout-ms | HTTP 超时(毫秒) | 8000 |

可用区名:东城、西城、朝阳、海淀、丰台、石景山、门头沟、房山、通州、顺义、昌平、大兴、怀柔、平谷、密云、延庆

输出约定

  • 始终输出 JSON
  • 成功时 ok: true,失败时 ok: false 并附非零退出码
  • text 格式将可读文本包裹在 {"data":{"text":"..."}}
  • 无效区名时会列出所有可用区名
  • 主结果对象包含 value_familymeaning,用于区分区级实时、站点观测、总量预报、分类预报的不同语义

详细 JSON 结构见 references/api-contract.md