开放数据查询服务

Aura

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.

Suomi | English | Svenska

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.

Kokeile minuutissa

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.

Mitä voit kysyä

Alla olevat vastaukset on haettu Aurasta 8.10.2026. Luvut ovat sellaisenaan lähteestä.

¹ 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:

Tekoälyagentille

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.

Ihmiselle

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.

Mistä data tulee

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.

Täydellinen luettelo: datasettikatalogi ja lähteiden tekniset tiedot.

Aura Pro

aura.futuai.fi ajaa Auran jatkokehitettyä versiota. Se liitetään samalla tavalla kuin avoin versio, ja siinä on lisäksi:

• Valmiit tunnusluvut: Yli 200 tunnuslukua kunnille, maakunnille ja hyvinvointialueille yhdellä kutsulla: väkiluku, työttömyysaste, asuntojen hinnat, sairastavuusindeksi. Työkalut get_facts, time_series ja compare_areas.
• Haku aineistojen sisältä: Indeksissä ovat tilastotaulujen luokitusarvot, paikkatietoaineistojen sarakenimet ja koodistojen käsitteet. Siksi luomutuottajat, maalajieroosio ja kulotus löytyvät, vaikka sana ei ole yhdessäkään otsikossa.
• Kysy millä kielellä tahansa: Vektorihaku yhdistää englannin- ja ruotsinkieliset kysymykset suomenkieliseen katalogiin.
• Rehelliset luvut: Kun kaksi tilastoa mittaa samaa eri tavalla, vastaus kertoo molemmat ja eron syyn.

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.

Sama tekniikka omalle datalle

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.

Laajenna: yhdistä avoimia aineistoja

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?"

1. Kiinteistön rajat: query_source hyväksyy alueeksi kiinteistötunnuksen (174-401-3-6). Rajat tulevat MML:n kiinteistörekisterikartasta.
2. Metsäkuviot: Metsäkeskuksen metsävarakuvioista tulevat kiinteistön kohdalta tukki- ja kuitupuun määrät, puulajit ja kehitysluokat.
3. Kantohinnat: Luken pystykaupan hinnat hinta-alueittain ja hakkuutavoittain.
4. Lasku: määrät kerrotaan hinnoilla, ja tuloksena on puuston hakkuuarvo euroina hehtaarilta. Jokaisen luvun lähde ja lisenssi kulkevat mukana.

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.

Aja itse

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ä.

Osallistu

• Rikasta aineistoja: kun agentti tutkii aineistoa, se voi tallentaa löydöksensä (enrich, save_session_findings). Rikastukset jaetaan pull requestina, ks. referenssi.
• Lisää lähde: uusi keräin on yleensä yksi tiedosto. Ohjeet ovat CONTRIBUTING.md:ssä.
• Kerro mitä puuttuu: avaa issue.

Lisää

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.

Tekijä

Auran on rakentanut Tero Rönkkö (tero@futuai.fi). Projektin on mahdollistanut Futuai Oy, joka tarjoaa julkisen palvelun ja sen ylläpidon, jotta kuka tahansa voi liittää Auran avustajaansa ilman omaa asennusta.

Lisenssi

MIT. Aineistojen lisenssit ovat julkaisijoiden omia, ja Aura kertoo ne jokaisen vastauksen mukana.