FreePublished on GitHub

API Catalog

Reference guide for connecting popular APIs to Home Assistant via Node-RED, YAML, or custom integrations. Covers authentication, endpoints, and complete working examples for: energy APIs (Tibber, Nordpool), weather (SMHI, OpenWeatherMap, yr.no), transport (SL, Trafikverket, Resrobot), smart home clouds (Shelly, Tuya, Philips Hue, IKEA), and global APIs (OpenAI, Spotify, Google Calendar, Telegram, GitHub). Use this skill whenever the user mentions a specific external service, API, or data source they want to connect to Home Assistant - even if they don't say "API".

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home

Works withTelegram Google Calendar GitHub OpenAI

See how to install

Files included (6)

SKILL.md4.6 KB
references/energy-apis.md8.5 KB
references/global-apis.md15.9 KB
references/smarthome-apis.md11.9 KB
references/transport-apis.md9.4 KB
references/weather-apis.md10.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

API Catalog for Home Assistant

Reference skill for connecting external APIs and services to Home Assistant.

Overview

This skill covers authentication patterns and working code examples for connecting popular APIs to Home Assistant via three methods:

Node-RED - HTTP request node flows (fastest to get running)
HA YAML - rest sensor and rest_command (good for simple polling)
Custom integration - Full HACS-publishable Python component (use ha-integration skill)

The Iron Law

CREDENTIALS IN SECRETS - NEVER HARDCODED IN FLOWS OR YAML

API keys belong in Node-RED credentials, ESPHome secrets.yaml, or HA secrets.yaml. Never paste real tokens into chat, flows that get exported, or YAML committed to git.

How to Use This Skill

User mentions an API or service by name
Read the relevant reference file for auth setup and endpoints
Generate working code for the user's chosen method (Node-RED / YAML / integration)
Include credential setup instructions

Reference Files

Category	File	APIs Covered
Energy & electricity	`references/energy-apis.md`	Tibber, Nordpool, Energi Data Service
Weather	`references/weather-apis.md`	SMHI, OpenWeatherMap, yr.no, Tomorrow.io
Transport	`references/transport-apis.md`	SL, Trafikverket, Resrobot, Entur (NO)
Smart home clouds	`references/smarthome-apis.md`	Shelly Cloud, Tuya IoT, Philips Hue, IKEA Dirigera
Global / other	`references/global-apis.md`	OpenAI, Spotify, Google Calendar, Telegram, GitHub

Authentication Patterns at a Glance

Pattern	How it works	Examples
API key in header	`Authorization: Bearer {key}` or `X-API-Key: {key}`	Tibber, OpenAI
API key in URL	`?appid={key}` appended to URL	OpenWeatherMap
OAuth2	Get access token first, refresh periodically	Spotify, Google
Local token	One-time press-button auth on device	Philips Hue
No auth	Public API, no credentials needed	SMHI, yr.no, Nordpool
Basic auth	Username + password Base64-encoded	Some local devices

Output Methods

For each API, generate code for the method the user needs:

Node-RED: http request node + function node to parse + api-call-service to push to HA HA YAML: rest sensor platform or rest_command under configuration.yaml Full integration: Use ha-integration skill with the polling-integration template

Common Patterns

Node-RED: API key in header

{
  "type": "http request",
  "method": "GET",
  "url": "https://api.example.com/data",
  "headers": {"Authorization": "Bearer {{env.API_KEY}}"},
  "ret": "obj"
}

Node-RED: GraphQL (Tibber-style)

{
  "type": "http request",
  "method": "POST",
  "url": "https://api.tibber.com/v1-beta/gql",
  "headers": {
    "Authorization": "Bearer {{env.TIBBER_TOKEN}}",
    "Content-Type": "application/json"
  },
  "payload": "{\"query\": \"{ viewer { homes { currentSubscription { priceInfo { current { total } } } } } }\"}",
  "ret": "obj"
}

HA YAML: REST sensor

rest:
  - scan_interval: 300
    resource: https://api.example.com/current
    headers:
      Authorization: !secret example_api_key
    sensor:
      - name: "Example Value"
        value_template: "{{ value_json.data.value }}"
        unit_of_measurement: "°C"

Pre-Output Checklist

Credentials use !secret (YAML), Node-RED credentials, or env vars - never hardcoded
Rate limits respected (include scan_interval or flow timer accordingly)
Error handling included (Node-RED catch node or YAML timeout)
For OAuth2: refresh token flow explained
Attribution: which API endpoint, what data it returns

Integration

Pairs with:

node-red skill - for flow JSON implementation
ha-yaml skill - for YAML sensor and automation using the fetched data
ha-integration skill - for building a full HACS-publishable Python integration

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

aurora

Free

Aurora Smart Home orchestrator — routing layer for all smart home skills. Use this skill when the user asks ANY smart home question and you need to decide which skill to invoke, or when a task spans multiple skills (e.g., "build a sensor that shows on a dashboard and triggers automations"). Invoke aurora FIRST before reaching for a specific skill — it will route to the right specialist(s) and recommend the correct Claude model to keep token usage efficient. Trigger on: smart home, Home Assistant, ESPHome, automation, IoT, dashboard, ESP32, Node-RED, or any request about controlling or monitoring devices at home.

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

ESPHome

Free

ESPHome device configuration, firmware, and IoT product development. Covers ESP32, ESP32-S3, ESP32-C3, ESP32-C6, ESP32-H2, ESP32-P4, ESP8266, RP2040, RP2350, nRF52, LibreTiny, Shelly, Sonoff, Tuya, BLE proxy, Matter firmware, Thread, Zigbee, GPIO, sensor YAML, LVGL displays, LED strips, voice assistant hardware, device flashing, Arduino conversion, alarm_control_panel, lock, valve, media_player, microphone, speaker, audio DAC, event entities, datetime entities, Z-Wave proxy, MIPI DSI displays, and DLMS smart meters. Also covers designing new ESPHome-based products: hardware selection, component sourcing, PCB design (KiCad), enclosures, 3D printing, CE/FCC certification, BOM optimization, and manufacturing from prototype to production scale.

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

HA Dashboard Design

Free

Beautiful, copy-paste-ready Home Assistant dashboard designs with complete CSS themes, card-mod styles, and button-card templates. Nine distinct visual styles: Glassmorphism, Dark Minimal, Material You, Nordic, Neon/Cyberpunk, Warm Home, Soft Pastel, Luxury Gold, and Retro Terminal. Use this skill whenever the user wants to make their dashboard look good, asks about card styling, CSS for Home Assistant, card-mod, button-card templates, Lovelace themes, dashboard aesthetics, or wants a specific visual style - even if they don't use the words "design" or "CSS".

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

HA Integration Dev

Free

Home Assistant custom integration development in Python. Covers custom_components, DataUpdateCoordinator, config_flow, OAuth2, conversation agent, HACS publishing, device registry, entity platforms, services, repair issues, diagnostics, Bluetooth integrations, and multi-coordinator patterns.

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

Home Assistant YAML

Free

Home Assistant YAML configuration and automation. The most common skill for general HA questions. Covers automations, blueprints, scripts, scenes, template sensors, Lovelace dashboards, Mushroom cards, packages, helpers, presence detection, voice Assist, calendar automation, Jinja2 templates, notification patterns, energy monitoring, Matter devices, automation debugging and traces, dashboard sections view, and trigger-based template entities.

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

Node-RED

Free

Node-RED visual automation flows for Home Assistant. Covers visual automation, flow JSON, trigger-state, api-call-service, function nodes, context storage, timer patterns, error handling, and node-red-contrib-home-assistant-websocket nodes. Use when user mentions "Node-RED", "flow", "visual automation", or "node-redflöde".

The English summary is being prepared. Showing the original description.

tonylofgren/aurora-smart-home106Updated Oct 5, 2026

See all skills by tonylofgren

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/tonylofgren/aurora-smart-home --skill API Catalog

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/tonylofgren/aurora-smart-home/tree/main/api-catalog

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/API Catalog/ for Claude Code, or ~/.agents/skills/API Catalog/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: tonylofgren/aurora-smart-home
Stars: 106
Forks: 5
Category: Development
License: MIT
Original language: English
Last updated: Oct 5, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.