Strategic Energy Infrastructure Map
Live: https://strategicenergymap.org · About & methods: https://strategicenergymap.org/about.html
A free, ad-free map of the world's oil and gas infrastructure — pipelines, fields, refineries, LNG terminals, ports, shipping routes and chokepoints — and what is happening to them now. A scheduled research agent keeps it current, with a source behind every claim.
What it does
- ~170 facilities across Europe, the Middle East, Asia and the Americas, each with capacity details and geopolitical context.
- Live chokepoint traffic from IMF PortWatch, loaded in the browser and compared with the pre-crisis baseline.
- Sourced daily updates: an event feed and facility status (reduced, disrupted, offline, damaged, closed), each linked to its sources with a confidence label.
- Pump prices: weekly petrol and diesel prices for the US (national and regional), all EU member states and the UK, from official statistics.
- What-if mode: close one or more chokepoints to see cut routes, usable bypass capacity (adjusted for facilities currently impaired), stranded assets, the net oil shortfall and the most exposed importers.
- Embeddable: add
?embed=1 (and optionally ®ion=europe|mideast|asia|americas) for a map-only view. The About page has a ready-made iframe snippet with a copy button (strategicenergymap.org/embed, which redirects to about.html#embed).
How it's built
No framework and no dependencies. The map is a static page that renders JSON; a small build script (scripts/build.mjs) also generates ~150 crawlable answer pages from the same data: one per chokepoint, major facility and pump-price series, plus hubs, an events archive, an RSS feed, sitemap.xml and robots.txt.
index.html, styles.css, app.js the map (Leaflet 1.9.4); renders everything from data/
about.html about & methods page, changelog
data/infrastructure.json facilities, pipelines, routes, chokepoints (stable kebab-case ids)
data/status.json facilities not operating normally
data/events.json dated, sourced event feed + situation summary
data/market.json benchmark prices
data/fuel.json pump prices (written by scripts/update_fuel.py)
data/scenarios.json what-if baselines, bypass capacity, exposure
data/changelog.json public changelog
scripts/update_fuel.py pulls EIA, EU Weekly Oil Bulletin, UK DESNZ and ECB FX (Python stdlib only)
scripts/validate.mjs schema, reference and sourcing checks for data/
agent/UPDATE_AGENT.md instructions for the daily update agent
agent/EDITOR.md instructions for the weekly editor agent
agent/BRIEF.md this week's approved brief (written by the editor, merged by a human)
scripts/metrics.mjs weekly growth metrics → metrics/<week-ending>.json
agent/SCHEMA.md data contract
Hosted on Vercel from main. Visits are counted with Vercel Web Analytics (no cookies).
The update agent
A Claude Code cloud routine runs every morning and follows agent/UPDATE_AGENT.md. It:
- refreshes pump prices from the official feeds,
- researches energy-relevant developments since its last run,
- updates events, facility status, prices and the changelog,
- runs
scripts/validate.mjs, then
- publishes routine changes to
main and opens a pull request for anything needing human review: new facilities, critical events, chokepoint status changes, corrections.
Sourcing rule. Governments that are parties to the conflicts on the map (the US, Israel, Iran, the Houthis, Russia and Ukraine) are treated alike. Their statements count as fact only when they can be independently verified; otherwise they are attributed and marked unverified. Ship transits and flows through contested waters come only from independent trackers. If there's no independent figure, the map shows none. The validator enforces part of this automatically.
Social posts
The agent also drafts short posts in data/social.json, checked by the validator (length, sourcing, no unverified
claims). A GitHub Action (.github/workflows/social.yml) posts them to X and Bluesky with repository secrets and
records what went out in data/social-log.json. Drafts tied to review items only post once a human merges them.
Set "enabled": false to pause everything. Weekly chart images are rendered from dist/social/*.html.
The weekly editor
Every Monday a GitHub Action (.github/workflows/metrics.yml) collects last week's numbers into
metrics/<week-ending>.json: search queries and clicks (Google Search Console, Bing), followers and engagement per post
(Bluesky, X), pages, daily runs and pull requests waiting. Its read-only keys are repository secrets. Vercel visits are
copied by hand into metrics/vercel.json, because Vercel's analytics API isn't available for this project.
A second cloud routine then follows agent/EDITOR.md: it reads the metrics and the week's activity
and opens a "Brief: week of …" pull request with what worked, one to three priorities, at most two build assignments,
notes for the daily agent and the experiments under way. Nothing in it takes effect until a human merges it. The daily
agent then follows the brief's notes within its own rules.
Run locally
fetch() doesn't work from file://, so serve the folder:
node scripts/build.mjs && python3 -m http.server 8765 -d dist
Then open http://localhost:8765. After editing anything in data/:
node scripts/validate.mjs
Refresh pump prices:
python3 scripts/update_fuel.py
Link-preview image
og.png is rendered from tools/og-card.html (copied into dist/tools/ by the local build) with headless Chrome while the local server is serving dist/:
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless=new --user-data-dir="$(mktemp -d)" --hide-scrollbars --window-size=1200,630 --virtual-time-budget=12000 --screenshot="$PWD/og.png" http://localhost:8765/tools/og-card.html
Data and attribution
Basemap © Esri, HERE, Garmin, © OpenStreetMap contributors. Ship transits: IMF PortWatch. Pump prices: US EIA, European Commission Weekly Oil Bulletin, UK DESNZ, ECB reference rates. Hormuz baselines: IEA (Kpler data). Every event and status links its own sources.
Found an error? Open an issue.
Built by Courtney Wilson.
