Suomalaisen avoimen datan discovery- ja ymmärryspalvelu — MCP-server tekoälyille, avoin web-palvelu ihmisille
翻譯準備中
開發工具Python · HTMLGitHub @trotor自行安裝營運者未確認
試用過了嗎? 點一下就好,不需要登入。
尚未偵測到更新。GitHub 發布版本後會顯示在這裡。
個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
安裝型專案無需部署網域也可驗證。個人儲存庫可透過 GitHub 登入驗證,組織儲存庫可使用上方的儲存庫驗證檔案。
正在載入完整 README。 以下為已儲存的摘錄。
Kysy Suomen avoimelta datalta. Aura kokoaa Suomen avoimen datan yhteen hakemistoon ja hakee vastaukset suoraan julkaisijan rajapinnasta, lähde ja lisenssi mukana. Käytä sitä selaimella tai liitä se tekoälyavustajaasi. 13 300+ aineistoa, 32 000+ resurssia, 46 lähdettä, noin 400 julkaisijaa. Tilastokeskus, THL, Luke, SYKE, Ilmatieteen laitos, Digitraffic, MML, Väylävirasto, eduskunta, Finlex, Vipunen, Kelasto, PRH, 36 kunnan karttapalvelut ja kymmenet muut. Julkinen palvelu osoitteessa aura.futuai.fi ei vaadi tunnuksia eikä asennusta. Claude Codessa:檢視完整 README ↗
Kysy Suomen avoimelta datalta. Aura kokoaa Suomen avoimen datan yhteen hakemistoon ja hakee vastaukset suoraan julkaisijan rajapinnasta, lähde ja lisenssi mukana. Käytä sitä selaimella tai liitä se tekoälyavustajaasi.
13 300+ aineistoa, 32 000+ resurssia, 46 lähdettä, noin 400 julkaisijaa. Tilastokeskus, THL, Luke, SYKE, Ilmatieteen laitos, Digitraffic, MML, Väylävirasto, eduskunta, Finlex, Vipunen, Kelasto, PRH, 36 kunnan karttapalvelut ja kymmenet muut.
Julkinen palvelu osoitteessa aura.futuai.fi ei vaadi tunnuksia eikä asennusta. Claude Codessa:
claude mcp add --transport http aura https://aura.futuai.fi/mcp
Claude Desktopissa, Cursorissa ja muissa MCP-asiakkaissa:
{
"mcpServers": {
"aura": { "type": "http", "url": "https://aura.futuai.fi/mcp" }
}
}
Kysy sitten avustajalta suomeksi, ruotsiksi tai englanniksi. Asiakaskohtaiset ohjeet ovat käyttöönotto-ohjeessa.
Alla olevat vastaukset on haettu Aurasta 8.10.2026. Luvut ovat sellaisenaan lähteestä.
| Kysymys | Aura vastaa | Lähde |
|---|---|---|
| Mikä on Kuopion työttömyysaste? | 12,4 % vuonna 2024. Lisäksi huomautus, että TEM:n työnvälitystilasto antaa 11,1 %, koska se mittaa eri asiaa. | Tilastokeskus 115x |
| Paljonko Kuopio on kasvanut kymmenessä vuodessa? | 116 921 → 126 572 asukasta (2015–2025), +8,3 % | Tilastokeskus 11ra |
| Hur hög är arbetslösheten i Vasa? | 8,8 % vuonna 2024. Vasa tunnistetaan Vaasaksi. | Tilastokeskus 115x |
| Kuusi suurinta kaupunkia väkiluvun mukaan | Helsinki 694 392, Espoo 325 716, Tampere 263 337, Vantaa 252 956, Oulu 217 469, Turku 209 633 (2025) | Tilastokeskus 11ra |
| air quality Helsinki | Ilmatieteen laitoksen ENFUSER-ilmanlaatuennuste ja HSY:n tunneittaiset ilmanlaatuindeksit | FMI, HRI |
| Missä tilastossa ovat eläinsuojelurikoksista tuomitut? | Taulu 126q, eläintenpitokiellot. Sana ei ole otsikossa, vaan taulun luokitusarvoissa. ¹ | Tilastokeskus |
| Moneltako IC147 saapuu Kuopioon tänään? | Agentti löytää Digitrafficin rata-API:n ja hakee aikataulun reaaliajassa. | Digitraffic |
¹ Haku aineistojen sisältä toimii Aura Prossa.
Tältä se näyttää Claudessa. Avustaja tekee kolme kutsua ja kertoo, mistä luvut tulevat ja miksi kaksi tilastoa antaa eri tuloksen:
Aura on tehty agentin käyttöön, ei vain selattavaksi.
Julkisessa profiilissa on viisi aikomustason työkalua, ja agentti etenee niillä kuten tietopalvelun ammattilainen: find_data etsii, inspect_dataset kertoo mitä aineistossa on, ja query_source hakee rivit lähteestä. Lisäksi area_snapshot tunnistaa alueen ja find_related etsii samankaltaisia aineistoja.
Jokainen vastaus on strukturoitu ja noudattaa julkaistua outputSchemaa, joten agentin ei tarvitse jäsentää vapaata tekstiä. Lukujen mukana tulevat lähde, kyselyn täsmällinen URL, lisenssi ja hakuaika (provenance). Vastaus ehdottaa seuraavia kutsuja (next_actions), ja virheessä on koodi, vihje ja korjattu kutsu (error.hint, error.suggested_call).
Alueen voi antaa monella tavalla: Tampere, Tampereella, Tammerfors, 837, KU837, Pirkanmaa, 33100. Lakkautettu kunta tulkitaan seuraajakseen (Nastola → Lahti).
Paikkatietoaineistoissa alueeksi kelpaa myös kiinteistötunnus (174-401-3-6): query_source rajaa haun kiinteistön palstoihin, esimerkiksi Metsäkeskuksen metsävarakuviot tilalta. Kiinteistörajat ladataan omaan Auraan kunnittain komennolla aura parcels <kunta> ilman API-avainta (referenssi).
query_source osaa PxWebin, WFS:n, Ilmatieteen laitoksen tallennetut kyselyt, ODatan, CSV:n ja JSONin. PxWebissä aika ymmärtää arvot uusin ja 2020-2024.
Ohjeteksti on alle 1 500 merkkiä, joten Aura ei syö agentin kontekstia. Koneluettava kuvaus palvelusta on osoitteessa /llms.txt.
Selaimella näkee saman hakemiston: haku suodattimineen, aineistosivut resursseineen, taulukoiden ja karttatasojen esikatselu sekä kartta aineistojen alueellisesta jakaumasta.
Avainsanoista pääsee selaamaan aiheittain: jokainen avainsana vie avainsanasivulle, jolla ovat sen aineistot sekä liittyvät aiheet (samoissa aineistoissa esiintyvät sanat) ja samankaltaiset sanat (sama perusmuoto tai yhdyssanan osa).
Aura palvelee myös julkaisijaa. Laatuprofiili (/mcp/laatu) kertoo julkaisijan omista aineistoista, mistä puuttuu kuvaus, avainsanat, päivitystiheys tai lisenssi ja mitkä linkit eivät toimi.
Aura kerää lähteistä metatiedot, ei itse dataa. Jokaiselle lähteelle on oma keräin (CKAN, PxWeb, WFS, OData, OpenAPI, GTFS tai lähteen oma rajapinta). Hakemisto on SQLite-kanta, jossa suomen kielen haku ymmärtää taivutusmuodot ja yhdyssanojen osat. Kun agentti tarvitsee rivejä, query_source hakee ne suoraan julkaisijalta, joten luvut ovat aina lähteen tuoreimpia.
| Teema | Lähteitä |
|---|---|
| Tilastot | Tilastokeskus (StatFin ja paikkatiedot), THL Sotkanet, Luke, Vipunen, Kelasto, Traficomin tilastot, Valtiokonttori, Kirjastot.fi |
| Ympäristö ja luonto | SYKE, Metsäkeskus, Luke, GTK, Lajitietokeskus, STUK, SMEAR |
| Sää ja liikenne | Ilmatieteen laitos, Digitraffic, Digitransit, Finap, Traficom, Finavia, Väylävirasto |
| Paikkatieto | MML, Paikkatietoikkuna, Paituli, Overture Maps, Lipas, taustakartat, 36 kunnan karttapalvelut |
| Yhteiskunta | Eduskunta, Finlex, vaalitulokset, vaalirahoitus, puolueohjelmat (Pohtiva), PRH, palvelutietovaranto |
| Katalogit | avoindata.fi, HRI, Suomi.fi-koodistot ja -sanastot |
Täydellinen luettelo: datasettikatalogi ja lähteiden tekniset tiedot.
aura.futuai.fi ajaa Auran jatkokehitettyä versiota. Se liitetään samalla tavalla kuin avoin versio, ja siinä on lisäksi:
get_facts, time_series ja compare_areas.Palvelua ylläpitää Futuai Oy. Pro-kerroksen koodi ei ole tässä repositoriossa. Kaikki tässä repositoriossa oleva on MIT-lisensoitua ja toimii itsenäisesti.
Aura ei ole sidottu avoimeen dataan. Sama rakenne toimii myös organisaation omille tietokannoille, rajapinnoille ja paikkatietopalveluille: keräin lähdettä kohden, yksi metatietohakemisto, suomea ymmärtävä haku ja MCP-työkalut, jotka kertovat jokaisen luvun lähteen. Silloin tekoälyavustaja löytää organisaation oman datan samalla tavalla kuin se nyt löytää Tilastokeskuksen taulun.
Valmiita keräimiä on CKAN-, PxWeb-, WFS-, WMS-, ArcGIS-, OData-, OpenAPI- ja GTFS-lähteille, ja uusi lähde on yleensä yksi tiedosto (ohje). Laatuprofiili kertoo samalla, mistä aineistoista puuttuu kuvaus, lisenssi tai toimiva linkki. Koodi on MIT-lisensoitua, ja kysymykset ja ideat ovat tervetulleita GitHubissa.
Auran työkalut palauttavat rivejä, lähteitä ja lisenssejä. Niiden päälle voi rakentaa vastauksia, joita mikään yksittäinen aineisto ei anna. Esimerkki: "Paljonko kiinteistön puusto on arvoltaan tämän hetken kantohinnoilla?"
query_source hyväksyy alueeksi kiinteistötunnuksen (174-401-3-6). Rajat tulevat MML:n kiinteistörekisterikartasta.Kaikki neljä ovat avointa dataa (CC BY 4.0). Aura kertoo myös, mikä ei ole: toteutuneet kauppahinnat ja metsätilan arviointitaulukot. Haku "metsän hinta" ohjaa niiden lähteisiin. Tällä hetkellä laskun tekee tekoälyavustaja. Saman voi rakentaa omaksi työkaluksi tai Auran laajennuspisteisiin (aura.extensions, ks. referenssi). Samalla kaavalla voi yhdistää muitakin aineistoja: kiinteistöön kaavat, suojelualueet ja pohjavesialueet, tai kuntaan tilastot ja palvelupisteet.
Tietokanta tulee repositorion mukana (Git LFS), joten aineistot ovat käytössä heti kloonauksen jälkeen.
git clone https://github.com/trotor/aura.git
cd aura
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
claude # Claude Code käynnistää Auran repon .mcp.json:sta
aura serve --http # tai MCP + web osoitteessa http://127.0.0.1:8000
Oma instanssi on täysi versio: kanta on kirjoitettavissa ja kaikki työkalut, myös keruu ja rikastus, ovat käytössä. Asennus muihin asiakkaisiin, komentorivi, työkaluprofiilit ja rajausaineistot ovat teknisessä referenssissä.
enrich, save_session_findings). Rikastukset jaetaan pull requestina, ks. referenssi.Tekninen referenssi | Käyttöönotto | Datasettikatalogi | Lähteet | Formaatit | Mitä uutta | Muutosloki
Aura on kyntöaura, joka kääntää maan alle jääneen pintaan, ja valon kehä, joka tekee näkyväksi sen mikä muuten jää piiloon.
Auran on rakentanut Tero Rönkkö ([email protected]). Projektin on mahdollistanut Futuai Oy, joka tarjoaa julkisen palvelun ja sen ylläpidon, jotta kuka tahansa voi liittää Auran avustajaansa ilman omaa asennusta.
MIT. Aineistojen lisenssit ovat julkaisijoiden omia, ja Aura kertoo ne jokaisen vastauksen mukana.