OMIE Energy

OMIE Energy (Portugal / Spain)

When to use

Use when the user asks about:

• Current or upcoming electricity spot prices in Portugal or Spain
• Iberian OMIE day-ahead marginal prices
• Cheapest time to run a load (dishwasher, laundry, EV charging)
• Portugal vs Spain price comparison
• Device actions based on price thresholds

Setup

Install Python dependencies once:

python3 -m pip install -r requirements.txt

No API credentials are required — OMIE publishes day-ahead marginal prices publicly.

Optional default area (PT or ES):

export OMIE_AREA="PT"

You can also copy .env.example to .env:

cp .env.example .env

Alternatively, for shareable/persistent configuration, create: ~/.config/omie-energy/config.json

cp config.json.example ~/.config/omie-energy/config.json

Configuration precedence:

1. environment variables (OMIE_*)
2. ~/.config/omie-energy/config.json
3. default area PT

Run

Use the wrapper from the skill directory:

bash run.sh prices

Commands

1) Fetch current and upcoming hourly day-ahead prices

Portugal (default):

bash run.sh prices --hours 36

Spain:

bash run.sh prices --area ES --hours 36

Custom date window:

bash run.sh prices --area PT --start 2026-06-01 --end 2026-06-07 --hours 48

2) Find optimal time for appliance or EV charging

Estimate hours from kwh / power-kw, then find cheapest contiguous block:

bash run.sh optimize \
  --area PT \
  --kwh 28 \
  --power-kw 11 \
  --window-start "2026-06-20T18:00:00+01:00" \
  --window-end "2026-06-21T08:00:00+01:00"

For fixed duration instead of kWh:

bash run.sh optimize --area PT --duration-hours 2

3) Compare Portugal vs Spain prices

bash run.sh compare --hours 24

4) Control smart-home devices by price threshold

Thresholds use EUR/kWh (divide OMIE EUR/MWh by 1000).

Dry-run:

bash run.sh control \
  --area PT \
  --price-below 0.10 \
  --on-command "ha service call switch.turn_on --entity_id switch.ev_charger" \
  --off-command "ha service call switch.turn_off --entity_id switch.ev_charger"

Execute commands:

bash run.sh control \
  --area PT \
  --price-above 0.20 \
  --on-command "ha service call switch.turn_on --entity_id switch.boiler" \
  --off-command "ha service call switch.turn_off --entity_id switch.boiler" \
  --execute

Notes

• Data source: OMIE (Iberian electricity market operator) via the OMIEData Python package.
• Concepts: PRICE_PT (Portugal), PRICE_SP (Spain).
• Prices are day-ahead marginal market prices in EUR/MWh; the CLI also shows EUR/kWh.
• Timestamps use Iberian local time (Europe/Lisbon).
• OMIE can expose H25 on daylight-saving transition days.
• Tomorrow's prices are typically published in the afternoon; if upcoming hours look short, widen --start/--end.
• optimize and control use EUR/kWh internally for threshold compatibility with other energy skills.
• Start with dry-run control mode and verify commands before --execute.

Safety

• No secrets required, but keep .env local if you use it for preferences.
• Keep --execute off until threshold logic is verified in dry-run.
• Treat --on-command and --off-command as trusted input only (they run as shell commands).

Publisher Checklist (ClawHub)

• Include: SKILL.md, run.sh, omie_energy.py, requirements.txt, .env.example, config.json.example, .gitignore
• Exclude: .env, __pycache__/, local logs, temporary files
• Validate from a clean shell:
  • python3 -m pip install -r requirements.txt
  • bash run.sh prices --area PT --hours 6
  • bash run.sh prices --area ES --hours 6
  • bash run.sh compare --hours 6
  • bash run.sh optimize --area PT --duration-hours 2
  • bash run.sh control --area PT --price-below 0.10 --on-command "echo on" --off-command "echo off"