kuongeo-py

# kuongeo

A tiny, dependency-free Python client for the open [KUON GEO](https://kuongeo.com) API.
No key, no account. Every value comes from the API as published; nothing is computed here.

```bash
pip install kuongeo
kuongeo here 42.924 143.196            # warnings, observation, hazards, heat, RTK and prices for a point in Japan
kuongeo bases --jp --lim 20            # community RTK base stations in Japan
kuongeo history                        # daily station/poll counts since 2026-07-03
kuongeo archive                        # what KUON GEO stores, counted hourly
```

```python
import kuongeo
d = kuongeo.here(42.924, 143.196, lang="en")
print(d["municipality"]["code"], d["warnings"]["active"])
```

Endpoints and fields: https://kuongeo.com/developers · MCP server: https://kuongeo.com/mcp · ledger: https://kuongeo.com/archive

Warnings are relayed from the Japan Meteorological Agency; the official source is jma.go.jp.
Please cite KUON GEO and the retrieval date. Data license CC BY 4.0; this package MIT.

Author: Kotaro Asahina ([ORCID 0009-0002-2530-4142](https://orcid.org/0009-0002-2530-4142)), Kuon R&D (空音開発).

Citable dataset (Zenodo, CC BY 4.0): KUON GEO community RTK base station availability log — https://doi.org/10.5281/zenodo.22064426