InfraNode mit JavaScript: infranode-sdk

Tutorial: offene Daten deutscher Großstädte mit dem keylosen TypeScript-Paket infranode-sdk abrufen, in Node und im Browser, plus fertiges Vercel-AI-SDK-Tool und ein Starter-Template für Cursor.

Installation

npm install infranode-sdk

Erste Abfrage

Eine Instanz, dann jeden Endpunkt per Methode oder generisch über record(slug, endpunkt). Die Fachdaten liegen unter payload, die Quellenangabe unter attribution.

import { InfraNode } from "infranode-sdk";

const api = new InfraNode();

const rec = await api.weather("berlin");
console.log(rec.payload.temperature_c, "degC");
console.log("Quelle:", rec.attribution.text);   // Attribution immer anzeigen

// Jeder Endpunkt per Name
const fuel = await api.record("hamburg", "fuel-prices");
const cities = await api.cities();               // alle 84 Städte

Jeder Datensatz trägt seine eigene attribution (Quelle und Lizenz-URL). Die Open-Data-Lizenzen verlangen die Nennung, zeige sie also deinen Nutzern an. Fehler werfen InfraNodeError.

Als KI-Agenten-Tool: Vercel AI SDK

npm install infranode-sdk ai zod

import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import { infranodeTools } from "infranode-sdk/ai";

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools: infranodeTools(),
  maxSteps: 5,
  prompt: "Wie ist Wetter und Strompreis in München gerade?",
});

infranodeTools() liefert infranode_get_city_data(city, dataset) und infranode_list_cities(). Spricht deine Laufzeit MCP, nutze stattdessen den InfraNode-MCP-Server.

Starter-Template für Cursor

Schnellster Einstieg: das fertige Dashboard-Template. Es zeigt Wetter, Luftqualität, Strompreis und Ladepunkte für alle 84 Städte und bringt eine vorkonfigurierte .cursor/mcp.json mit, damit der InfraNode-MCP-Server in Cursor sofort verfügbar ist.

git clone https://github.com/street1983nk/infranode-weather-starter.git
cd infranode-weather-starter
npm install && npm run dev

Weiterführend

Quellcode und Issues: github.com/street1983nk/infranode-js. Template: infranode-weather-starter.

Häufige Fragen

Läuft das auch im Browser?

Ja. Der Client nutzt das native fetch und läuft in Node 18 oder neuer sowie im Browser. Die API erlaubt CORS für beliebige Origins.

Brauche ich einen API-Schlüssel?

Nein. infranode-sdk spricht die keylose, kostenlose InfraNode-API an. Kein Key, keine Registrierung.

Wie binde ich es in einen KI-Agenten ein?

Über den Unterpfad infranode-sdk/ai. infranodeTools() liefert fertige Vercel-AI-SDK-Tools, die du in generateText oder streamText übergibst. ai und zod sind optionale Peer-Abhängigkeiten.