OpenAQ
OpenAQ 是一个非营利平台，把各国政府监测网络、研究团队和空气传感器厂商公开发布的空气质量实测数据汇集到一个开放 API 里。通过 ScholarMuse，agent 给出经纬度和日期范围，就能拿到 25 公里内最近的监测站，以及每个站所测污染物的日均值、最小值和最大值。
对应的 ScholarMuse 工具：get_air_quality。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 OpenAQ 的数据字段。
get_air_quality
每个监测站一条记录，由近到远，每次最多三个站。序列放在 measurements 里：每个污染物传感器一项，各带自己的 observations。
- name
- 站点名称；OpenAQ 有记录时附 locality（所在地）
- country
- 两位国家代码
- latitude, longitude
- 站点位置
- distanceKm
- 与所查坐标的距离（公里）
- provider
- 数据所经的监测网络或服务，如 London Air Quality Network
- owner
- OpenAQ 登记的站点所有者
- referenceGrade
- 标准监测仪器为 true，空气传感器为 false
- licenses
- 该站点附带的许可名称，可能为空
- licenseAttribution
- 按该许可应署名的对象（如有）
- firstMeasurement, lastMeasurement
- OpenAQ 中该站最早和最新一次读数的时间（UTC）
- start, end
- 所请求的日期范围
- measurements[].pollutant
- pm25、pm10、no2、o3、so2 或 co
- measurements[].units
- 传感器给出的单位，如 µg/m³
- measurements[].sensorId
- OpenAQ 传感器编号
- measurements[].statistic
- 固定为 daily mean（日均值）
- measurements[].observations
- 每行包含 date、value（日均值）、min、max 和 coveragePercent
覆盖范围
- 向 OpenAQ 上报数据的固定站点。2026 年 10 月 13 日，OpenAQ 的 API 中列有 159 个国家和 173 个数据提供方。能查到什么取决于当地有没有站点：许多城市很密集，许多乡村和偏远地区则没有。
- 六种污染物：PM2.5、PM10、NO2、O3、SO2 和 CO。可以全部查询，也可以只指定需要的几种。
- 在你设定的半径内（默认和上限都是 25 公里），取测量所查污染物的最近三个站点，优先选择在所查时段内仍在上报的站点。
- 日均值，附当天的最小值、最大值和读数完整率，日期范围最长 366 天。不给日期时返回最近 7 天。
限制
- 只有实测数据。不提供预报、模式或卫星估算值，也不计算空气质量指数（AQI），站点之间不做插值：25 公里内没有站点时，结果为空。
- 只有日均值，没有逐小时读数。不包含移动监测设备，也不包含 OpenAQ 的其他参数，如黑碳、PM1、温度和湿度。
- 数值按站点上报的原样返回，不做质量控制。标准监测仪器和低成本传感器会同时出现（见 referenceGrade），负浓度之类的异常读数也不会剔除。使用某一天的数据前，请先看 coveragePercent。
- 列出的站点在所查时段内可能没有任何观测值，比如它是之后才开始上报的，或者中间有缺测。
- 单位由各传感器给出。请逐条序列查看单位，不要默认同一种污染物只有一种单位。
- 每次只能查一个点。一次调用要对每个污染物传感器各发一次上游请求，大约每秒一次，所以六种污染物全查可能需要 15 秒以上。
ScholarMuse 怎么访问 OpenAQ
连接器直接调用 api.openaq.org/v3 的 OpenAQ API，在 X-API-Key 请求头里带上 ScholarMuse 自己的 API key：先用 /locations 找到坐标周围的站点，再对每个污染物传感器请求 /sensors/{id}/days。没有配置 key 时，这个工具不会出现在工具列表里。
站点列表最长缓存 6 小时，日均值最长缓存 1 小时，所以最近一天的数据可能比 OpenAQ 晚这么久。
API key：上游 API 需要 key，ScholarMuse 用自己的 key，你不用申请。
许可与署名
许可：Varies by data provider (many CC BY 4.0); see each station
Air quality data from OpenAQ (openaq.org) and the original monitoring agencies listed with each station.
每条记录带的是该站点自己的许可（例如英国 Open Government Licence 或 CC BY 4.0），署名一行写的是该站点的许可持有方或数据提供方，后接“via OpenAQ (openaq.org)”。站点没有列出许可时，使用上面这条许可说明。 在论文里引用时，请按 OpenAQ 自己的引用要求来写。
