stats: jobs & cost of living theme (unemployment by age, vacancies, JOLTS, graduates, job quality, wages, price levels, housing), grad view cards, Beveridge curve; jobs collector (OECD SDMX, Big Mac index, derived series) + Eurostat/World Bank/FRED jobs series, stats-jobs.timer

2026-10-26 18:07:56 +00:00
parent f2f7bd0a19
commit b566a1244f
13 changed files with 1492 additions and 30 deletions
--- a/scripts/stats-fetch.ts
+++ b/scripts/stats-fetch.ts
@@ -17,6 +17,7 @@
 //   bun scripts/stats-fetch.ts elections [--force] [--only=kiesraad,cbs,mit]   A14
 //   bun scripts/stats-fetch.ts parties            CHES + V-Party + Party Facts (A15)
 //   bun scripts/stats-fetch.ts wikipolls|eurobarometer [--force]|whr|gtrends|gdelt   A16
+//   bun scripts/stats-fetch.ts jobs [--only=wages,quality,finding,grads,housing,prices,bigmac,jolts,pricelevel]
 //   bun scripts/stats-fetch.ts normalise-cbs     rebuild CBS chart series from the raw rows
 import { ensureMeta, sql } from './stats/common';
 import { cbs, normaliseCbs } from './stats/cbs';
@@ -43,6 +44,7 @@ import { whr } from './stats/whr';
 import { gtrends } from './stats/gtrends';
 import { gdelt } from './stats/gdelt';
 import { history } from './stats/history';
+import { jobs } from './stats/jobs';

 const [source, ...args] = process.argv.slice(2);
 const flag = (name: string) => args.includes(`--${name}`);
@@ -124,12 +126,15 @@ try {
 		case 'history':
 			await history({ only: value('only'), job });
 			break;
+		case 'jobs':
+			await jobs({ only: value('only'), job });
+			break;
 		case 'gdelt':
 			await gdelt({ job, timespan: value('timespan') });
 			break;
 		default:
 			throw new Error(
-				`Unknown source "${source}" (cbs, eurostat, fred, bis, oecd, statcan, worldbank, imf, owid, energycharts, rijksfinancien, ustreasury, usaspending, eponline, cbscw, cwintl, elections, parties, wikipolls, eurobarometer, whr, gtrends, gdelt, history, normalise-cbs)`
+				`Unknown source "${source}" (cbs, eurostat, fred, bis, oecd, statcan, worldbank, imf, owid, energycharts, rijksfinancien, ustreasury, usaspending, eponline, cbscw, cwintl, elections, parties, wikipolls, eurobarometer, whr, gtrends, gdelt, history, jobs, normalise-cbs)`
 			);
 	}
 } finally {
--- a/scripts/stats/common.ts
+++ b/scripts/stats/common.ts
@@ -382,6 +382,14 @@ export const SOURCES = [
 		key_required: false,
 		attribution: 'Source: Pew Research Center (2025), via Our World in Data'
 	},
+	{
+		source_id: 'economist',
+		name: 'The Economist Big Mac index',
+		base_url: 'https://github.com/TheEconomist/big-mac-data',
+		licence: 'CC BY 4.0',
+		key_required: false,
+		attribution: 'Source: The Economist, Big Mac index (CC BY 4.0)'
+	},
 	{
 		source_id: 'history',
 		name: 'Curated history and culture notes',
@@ -397,6 +405,7 @@ export const REGIONS: { region_code: string; name: string; kind: string; parent:
 		{ region_code: 'WLD', name: 'World', kind: 'aggregate', parent: null },
 		{ region_code: 'EU27', name: 'European Union (27)', kind: 'aggregate', parent: 'WLD' },
 		{ region_code: 'EA', name: 'Euro area', kind: 'aggregate', parent: 'EU27' },
+		{ region_code: 'OECD', name: 'OECD members', kind: 'aggregate', parent: 'WLD' },
 		{ region_code: 'NLD', name: 'Netherlands', kind: 'country', parent: 'EU27' },
 		{ region_code: 'USA', name: 'United States', kind: 'country', parent: 'WLD' },
 		{ region_code: 'KOR', name: 'South Korea', kind: 'country', parent: 'WLD' },
--- a/scripts/stats/eurostat.ts
+++ b/scripts/stats/eurostat.ts
@@ -129,7 +129,103 @@ export const EUROSTAT_DATASETS: Dataset[] = [
 		theme: 'economy',
 		params: { unit: ['CP_MEUR', 'CLV_PCH_PRE'], na_item: 'B1GQ' }
 	},
-	{ code: 'demo_pjan', theme: 'countries', params: { sex: 'T', age: 'TOTAL', unit: 'NR' } }
+	{ code: 'demo_pjan', theme: 'countries', params: { sex: 'T', age: 'TOTAL', unit: 'NR' } },
+	// ── Jobs & cost of living (/stats/<place>/jobs) ──
+	{
+		code: 'une_rt_m',
+		theme: 'jobs',
+		params: { s_adj: 'SA', age: ['TOTAL', 'Y_LT25', 'Y25-74'], unit: 'PC_ACT', sex: 'T' },
+		geos: [...EU_GEOS, 'US', 'JP']
+	},
+	{
+		code: 'lfsa_urgan',
+		theme: 'jobs',
+		params: { unit: 'PC', sex: 'T', age: ['Y15-24', 'Y25-29', 'Y15-74'], citizen: 'TOTAL' }
+	},
+	{
+		code: 'jvs_q_nace2',
+		theme: 'jobs',
+		params: { s_adj: 'NSA', nace_r2: 'B-S', sizeclas: 'TOTAL', indic_em: 'JVR' }
+	},
+	{
+		// Employment rate of recent graduates (left education 1–3 years ago), 20–34.
+		code: 'edat_lfse_24',
+		theme: 'jobs',
+		params: { duration: 'Y1-3', isced11: ['ED3-8', 'ED5-8'], age: 'Y20-34', sex: 'T', unit: 'PC' }
+	},
+	{
+		// NEET rate: not employed, not in education or training.
+		code: 'edat_lfse_20',
+		theme: 'jobs',
+		params: {
+			sex: 'T',
+			age: ['Y15-29', 'Y15-24'],
+			training: 'NO_FE_NO_NFE',
+			wstatus: 'NEMP',
+			unit: 'PC'
+		}
+	},
+	{
+		code: 'lfsa_etpgan',
+		theme: 'jobs',
+		params: { unit: 'PC', sex: 'T', age: ['Y15-64', 'Y15-24', 'Y25-34'], citizen: 'TOTAL' }
+	},
+	{
+		code: 'lfsa_eppga',
+		theme: 'jobs',
+		params: { unit: 'PC', sex: 'T', age: ['Y15-64', 'Y15-24'] }
+	},
+	{
+		code: 'lfsa_ewhan2',
+		theme: 'jobs',
+		params: {
+			nace_r2: 'TOTAL',
+			wstatus: 'EMP',
+			worktime: ['TOTAL', 'FT'],
+			age: 'Y15-64',
+			sex: 'T',
+			unit: 'HR'
+		}
+	},
+	{
+		code: 'earn_mw_cur',
+		theme: 'jobs',
+		params: { currency: ['EUR', 'PPS'] },
+		geos: [...EU_GEOS, 'US']
+	},
+	{
+		// Price level indices (EU27 = 100): everything, food, alcohol & tobacco, housing, transport, restaurants.
+		code: 'prc_ppp_ind',
+		theme: 'jobs',
+		params: {
+			na_item: 'PLI_EU27_2020',
+			ppp_cat: ['GDP', 'A01', 'A0101', 'A0104', 'A0107', 'A0111']
+		},
+		geos: [...EU_GEOS, 'US', 'JP']
+	},
+	{
+		// Housing cost overburden: households spending > 40 % of disposable income on housing.
+		code: 'ilc_lvho07a',
+		theme: 'jobs',
+		params: { unit: 'PC', rskpovth: 'TOTAL', age: ['TOTAL', 'Y18-24', 'Y25-29'], sex: 'T' }
+	},
+	{
+		code: 'une_ltu_a',
+		theme: 'jobs',
+		params: { indic_em: 'LTU', age: 'Y15-74', sex: 'T', unit: 'PC_UNE' }
+	},
+	{
+		// Share of young adults still living with their parents.
+		code: 'ilc_lvps08',
+		theme: 'jobs',
+		params: { age: ['Y25-29', 'Y25-34'], sex: 'T', unit: 'PC' }
+	},
+	{
+		// Structure of earnings survey (every 4 years): mean and median earnings, firms with 10+ staff.
+		code: 'earn_ses_pub2s',
+		theme: 'jobs',
+		params: { sizeclas: 'GE10', sex: 'T', unit: ['EUR', 'PPS'] }
+	}
 ];

 type JsonStat = {
--- a/scripts/stats/fred.ts
+++ b/scripts/stats/fred.ts
@@ -185,6 +185,103 @@ export const FRED_SERIES: Fred[] = [
 		freq: 'Q',
 		region: 'USA',
 		theme: 'economy'
+	},
+	// Jobs & cost of living
+	{
+		id: 'LNS14024887',
+		title: 'US unemployment rate, 16–24',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'LNS14000036',
+		title: 'US unemployment rate, 20–24',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'JTSJOL',
+		title: 'US job openings (JOLTS)',
+		unit: 'Thousands',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'JTSJOR',
+		title: 'US job openings rate (JOLTS)',
+		unit: '% of jobs + openings',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'JTSHIR',
+		title: 'US hires rate (JOLTS)',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'JTSQUR',
+		title: 'US quits rate (JOLTS)',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'UNEMPLOY',
+		title: 'US unemployed persons',
+		unit: 'Thousands',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'LNS13025703',
+		title: 'US long-term unemployed (27+ weeks), share of unemployed',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'CGBD2534',
+		title: 'US unemployment rate, bachelor’s degree, 25–34',
+		unit: '%',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'LES1252881600Q',
+		title: 'US median usual weekly real earnings',
+		unit: '1982–84 CPI-adjusted USD',
+		freq: 'Q',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'LES1252881500Q',
+		title: 'US median usual weekly earnings, full-time',
+		unit: 'USD',
+		freq: 'Q',
+		region: 'USA',
+		theme: 'jobs'
+	},
+	{
+		id: 'FEDMINNFRWG',
+		title: 'US federal minimum wage',
+		unit: 'USD per hour',
+		freq: 'M',
+		region: 'USA',
+		theme: 'jobs'
 	}
 ];

--- a/scripts/stats/jobs.ts
+++ b/scripts/stats/jobs.ts
@@ -0,0 +1,498 @@
+// Jobs & cost of living (/stats/<place>/jobs), the parts that are not a plain Eurostat / World
+// Bank / FRED series list:
+//   - OECD Data Explorer SDMX (no key): average and minimum wages in USD PPP, hours, long hours,
+//     temporary-job shares, long-term unemployment, graduate employment and the tertiary
+//     earnings premium (Education at a Glance), house price-to-income / price-to-rent, monthly
+//     youth unemployment and comparative price levels (USA = 100). Series `oecd:jobs:<name>:<ISO3>`.
+//   - Derived from those: real wage growth (yearly change of the constant-price average wage) and
+//     an approximate median full-time wage (real minimum wage ÷ minimum-to-median ratio),
+//     `jobs:realwagegrowth:<ISO3>` and `jobs:medianwage:<ISO3>`.
+//   - The Economist Big Mac index (GitHub CSV, CC BY 4.0): `economist:bigmac:<ISO3>:<measure>`.
+//   - Derived from FRED: US job openings per unemployed person (JTSJOL / UNEMPLOY).
+//   - Derived from World Bank: price level of private consumption, USA = 100
+//     (PA.NUS.PRVT.PP ÷ PA.NUS.FCRF; WDI dropped PA.NUS.PPPC.RF), `jobs:pricelevel:<ISO3>`.
+// Numbeo is not used: it has no free API and its terms forbid scraping.
+import {
+	getText,
+	http,
+	log,
+	parsePeriod,
+	REGIONS,
+	run,
+	sql,
+	writeSeries,
+	type ObsRow,
+	type SeriesRow
+} from './common';
+
+const OECD = 'https://sdmx.oecd.org/public/rest/data';
+const CSV = { accept: 'application/vnd.sdmx.data+csv; charset=utf-8' };
+/** Countries and aggregates asked from OECD; non-members simply come back empty. */
+const AREAS = [
+	'NLD',
+	'USA',
+	'KOR',
+	'JPN',
+	'CAN',
+	'CHN',
+	'DEU',
+	'FRA',
+	'BEL',
+	'GBR',
+	'IND',
+	'BRA',
+	'EU27_2020',
+	'EA20',
+	'OECD'
+];
+const AREA_REGION: Record<string, string> = { EU27_2020: 'EU27', EA20: 'EA', OECD: 'OECD' };
+const areaRegion = (a: string) => AREA_REGION[a] ?? a;
+
+type OecdSpec = {
+	job: string;
+	/** Dataflow `agency,id,version`. */
+	flow: string;
+	/** Key after the area, e.g. `.WG.USD_PPP.A.Q.MEAN._Z` (the area list is prefixed). */
+	key: string;
+	start?: string;
+	/** Row → our series name (or null to skip). */
+	pick: (r: Record<string, string>) => string | null;
+	meta: Record<string, { title: string; unit: string }>;
+};
+
+const SPECS: OecdSpec[] = [
+	{
+		job: 'wages',
+		flow: 'OECD.ELS.SAE,DSD_EARNINGS@AV_AN_WAGE,1.0',
+		key: '.WG.USD_PPP.A.Q.MEAN._Z',
+		pick: () => 'avwage',
+		meta: {
+			avwage: {
+				title: 'Average annual wage, full-time equivalent (constant prices, USD PPP)',
+				unit: 'USD PPP'
+			}
+		}
+	},
+	{
+		job: 'wages',
+		flow: 'OECD.ELS.SAE,DSD_EARNINGS@RMW,1.0',
+		key: '.SM_WG.USD_PPP.A+H.Q._Z._Z',
+		pick: (r) => (r.PAY_PERIOD === 'A' ? 'minwage' : r.PAY_PERIOD === 'H' ? 'minwage_h' : null),
+		meta: {
+			minwage: { title: 'Real statutory minimum wage, yearly (USD PPP)', unit: 'USD PPP' },
+			minwage_h: { title: 'Real statutory minimum wage, hourly (USD PPP)', unit: 'USD PPP / h' }
+		}
+	},
+	{
+		job: 'wages',
+		flow: 'OECD.ELS.SAE,DSD_EARNINGS@MIN2AVE,1.0',
+		key: '.MR_WG_FT.PT_WG_A_SAL_FT._Z._Z.MEDIAN._Z',
+		pick: () => 'min2median',
+		meta: {
+			min2median: {
+				title: 'Minimum wage relative to the median full-time wage',
+				unit: '% of median'
+			}
+		}
+	},
+	{
+		job: 'quality',
+		flow: 'OECD.ELS.SAE,DSD_HW@DF_AVG_ANN_HRS_WKD,1.0',
+		key: '.HW.H_Y_PS._Z._Z.EMP.A.ACTUAL._T._Z.MEAN._Z._T',
+		pick: () => 'hours',
+		meta: { hours: { title: 'Average annual hours actually worked per worker', unit: 'hours' } }
+	},
+	{
+		job: 'quality',
+		flow: 'OECD.ELS.SAE,DSD_HW@DF_EMP_LNG_USL_WK_HRS,1.0',
+		key: '.SH_EMP_H.PT_WR_SEX_AGE_EMP_ST._T.Y15T64.EMP.W.USUAL._T._Z.OBS.H_GE50.MAIN',
+		pick: () => 'longhours',
+		meta: {
+			longhours: {
+				title: 'Employees and self-employed usually working 50+ hours a week',
+				unit: '% of employed'
+			}
+		}
+	},
+	{
+		job: 'quality',
+		flow: 'OECD.ELS.SAE,DSD_TEMP@DF_TEMP_I,1.0',
+		key: '.EMP_TEMP.PT_POP_SUB._T._T+Y15T24.ICSE93_1.A',
+		pick: (r) => (r.AGE === '_T' ? 'temp' : 'temp_youth'),
+		meta: {
+			temp: { title: 'Temporary employment, share of employees', unit: '% of employees' },
+			temp_youth: {
+				title: 'Temporary employment, share of employees aged 15–24',
+				unit: '% of employees'
+			}
+		}
+	},
+	{
+		job: 'finding',
+		flow: 'OECD.ELS.SAE,DSD_DUR@DF_DUR_I,1.0',
+		key: '.UNEMP.PT_POP_SUB._T._T.Y_GE1.A',
+		pick: () => 'ltu',
+		meta: {
+			ltu: { title: 'Long-term unemployment (1 year or more)', unit: '% of unemployed' }
+		}
+	},
+	{
+		job: 'finding',
+		flow: 'OECD.SDD.TPS,DSD_LFS@DF_IALFS_UNE_M,1.0',
+		key: '.UNE_LF_M.PT_LF_SUB._Z.Y._T.Y15T24+Y_GE25+Y_GE15._Z.M',
+		start: '1990-01',
+		pick: (r) =>
+			r.AGE === 'Y15T24'
+				? 'unemp_youth'
+				: r.AGE === 'Y_GE25'
+					? 'unemp_25plus'
+					: r.AGE === 'Y_GE15'
+						? 'unemp'
+						: null,
+		meta: {
+			unemp: { title: 'Unemployment rate, monthly (OECD harmonised)', unit: '%' },
+			unemp_youth: { title: 'Youth unemployment rate 15–24, monthly', unit: '%' },
+			unemp_25plus: { title: 'Unemployment rate 25+, monthly', unit: '%' }
+		}
+	},
+	{
+		job: 'grads',
+		flow: 'OECD.EDU.IMEP,DSD_EAG_LSO_EA@DF_LSO_NEAC_EMP,1.0',
+		key: '._T.Y25T34.ISCED11A_5T8._T.EMPLOYMENT._Z._T._Z.ED_NED.EMP._Z.PT_POP_SUB.OBS._Z.NEAC.A',
+		pick: () => 'grademp',
+		meta: {
+			grademp: {
+				title: 'Employment rate of tertiary-educated 25–34 year-olds',
+				unit: '% of age group'
+			}
+		}
+	},
+	{
+		job: 'grads',
+		flow: 'OECD.EDU.IMEP,DSD_EAG_LSO_EA@DF_LSO_EARN_REL_UPPER,1.0',
+		key: '._T.Y25T34.ISCED11A_5T8._T.EARN_RELATIVE._Z._T._Z.ED_NED.EMP._Z.PT_EARN_WR_ISCED11A_3.OBS.FT.EARNINGS.A',
+		pick: () => 'premium',
+		meta: {
+			premium: {
+				title:
+					'Earnings of tertiary-educated 25–34 year-olds (full-time), relative to upper secondary',
+				unit: 'upper secondary = 100'
+			}
+		}
+	},
+	{
+		job: 'housing',
+		flow: 'OECD.ECO.MPD,DSD_AN_HOUSE_PRICES@DF_HOUSE_PRICES,1.0',
+		key: '.Q.HPI_YDH_AVG+HPI_RPI_AVG+RPI.',
+		start: '1970-Q1',
+		pick: (r) =>
+			r.MEASURE === 'HPI_YDH_AVG'
+				? 'ptoi'
+				: r.MEASURE === 'HPI_RPI_AVG'
+					? 'ptor'
+					: r.MEASURE === 'RPI'
+						? 'rent'
+						: null,
+		meta: {
+			ptoi: {
+				title: 'House price-to-income ratio, vs its long-term average',
+				unit: 'long-term avg = 100'
+			},
+			ptor: {
+				title: 'House price-to-rent ratio, vs its long-term average',
+				unit: 'long-term avg = 100'
+			},
+			rent: { title: 'Rent price index', unit: 'Index 2015=100' }
+		}
+	},
+	{
+		job: 'prices',
+		flow: 'OECD.SDD.TPS,DSD_PPP_M@DF_PP_CPL_M,1.0',
+		key: '.M.CPL.IX..USA',
+		start: '2015-01',
+		pick: (r) => (r.COUNTERPART_AREA === 'USA' ? 'cpl' : null),
+		meta: {
+			cpl: {
+				title: 'Comparative price level of final consumption (USA = 100)',
+				unit: 'USA = 100'
+			}
+		}
+	}
+];
+
+function parseCsv(text: string): Record<string, string>[] {
+	const lines = text.trim().split(/\r?\n/);
+	const head = lines[0].split(',');
+	return lines.slice(1).map((l) => Object.fromEntries(l.split(',').map((v, i) => [head[i], v])));
+}
+
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+async function pullOecd(spec: OecdSpec): Promise<number> {
+	const url = `${OECD}/${spec.flow}/${AREAS.join('+')}${spec.key}?startPeriod=${spec.start ?? '1990'}`;
+	const res = await http(url, { headers: CSV });
+	const rows = parseCsv(await res.text());
+	const series = new Map<string, SeriesRow>();
+	const obs: ObsRow[] = [];
+	for (const r of rows) {
+		const name = spec.pick(r);
+		if (!name || r.OBS_VALUE === '' || r.OBS_VALUE == null) continue;
+		const value = Number(r.OBS_VALUE);
+		const p = parsePeriod(r.TIME_PERIOD ?? '');
+		if (!p || !Number.isFinite(value)) continue;
+		const region = areaRegion(r.REF_AREA);
+		const id = `oecd:jobs:${name}:${region}`;
+		if (!series.has(id)) {
+			const m = spec.meta[name];
+			series.set(id, {
+				series_id: id,
+				source_id: 'oecd',
+				source_code: `${spec.flow}/${r.REF_AREA}${spec.key}`,
+				title: m.title,
+				unit: m.unit,
+				freq: p.freq,
+				region_code: region,
+				theme: 'jobs',
+				meta: { url: 'https://data-explorer.oecd.org/', flow: spec.flow }
+			});
+		}
+		obs.push({ series_id: id, period: p.date, value, status: r.OBS_STATUS || null });
+	}
+	if (!obs.length) throw new Error(`no rows for ${spec.flow}`);
+	// One row per (series, period): SDMX can repeat a period with a different status.
+	const seen = new Set<string>();
+	const unique = obs.filter((o) => {
+		const k = `${o.series_id}|${o.period}`;
+		if (seen.has(k)) return false;
+		seen.add(k);
+		return true;
+	});
+	await writeSeries([...series.values()], unique);
+	log(`jobs oecd ${spec.flow.split(',')[1]}: ${unique.length} obs, ${series.size} series`);
+	return unique.length;
+}
+
+// ── Big Mac index ─────────────────────────────────────────────────────────────────────────
+const BIGMAC =
+	'https://raw.githubusercontent.com/TheEconomist/big-mac-data/master/output-data/big-mac-full-index.csv';
+const BIGMAC_REGION: Record<string, string> = { EUZ: 'EA' };
+
+async function bigmac(): Promise<number> {
+	const rows = parseCsv(await getText(BIGMAC));
+	const known = new Set(REGIONS.map((r) => r.region_code));
+	const measures: Record<string, { title: string; unit: string }> = {
+		dollar_price: { title: 'Big Mac price in US dollars', unit: 'US$' },
+		USD_raw: {
+			title: 'Big Mac index: local currency vs the US dollar (raw)',
+			unit: '% over/under-valued'
+		}
+	};
+	const series = new Map<string, SeriesRow>();
+	const obs: ObsRow[] = [];
+	for (const r of rows) {
+		const region = BIGMAC_REGION[r.iso_a3] ?? r.iso_a3;
+		if (!known.has(region) || !/^\d{4}-\d{2}-\d{2}$/.test(r.date)) continue;
+		for (const [m, meta] of Object.entries(measures)) {
+			const raw = Number(r[m]);
+			if (r[m] === '' || !Number.isFinite(raw)) continue;
+			const id = `economist:bigmac:${region}:${m}`;
+			if (!series.has(id))
+				series.set(id, {
+					series_id: id,
+					source_id: 'economist',
+					source_code: `big-mac-full-index/${r.iso_a3}/${m}`,
+					title: meta.title,
+					unit: meta.unit,
+					freq: 'S',
+					region_code: region,
+					theme: 'jobs',
+					meta: { url: 'https://github.com/TheEconomist/big-mac-data' }
+				});
+			obs.push({
+				series_id: id,
+				period: r.date,
+				value: m === 'USD_raw' ? Math.round(raw * 1000) / 10 : raw,
+				status: null
+			});
+		}
+	}
+	if (!obs.length) throw new Error('Big Mac CSV: no rows');
+	await writeSeries([...series.values()], obs);
+	log(`jobs bigmac: ${obs.length} obs, ${series.size} series`);
+	return obs.length;
+}
+
+// ── Derived: US openings per unemployed person ─────────────────────────────────────────────
+async function joltsRatio(): Promise<number> {
+	const rows = await sql<{ period: string; value: number }[]>`
+		select o.period::text as period, round((o.value / u.value)::numeric, 3)::float8 as value
+		from stats.obs o join stats.obs u on u.period = o.period and u.series_id = 'fred:UNEMPLOY'
+		where o.series_id = 'fred:JTSJOL' and u.value > 0 and o.value is not null
+		order by o.period`;
+	if (!rows.length) throw new Error('JOLTS ratio: run the fred collector first (JTSJOL, UNEMPLOY)');
+	const id = 'jobs:openings_per_unemployed:USA';
+	await writeSeries(
+		[
+			{
+				series_id: id,
+				source_id: 'fred',
+				source_code: 'JTSJOL/UNEMPLOY',
+				title: 'US job openings per unemployed person (JOLTS openings ÷ unemployed)',
+				unit: 'openings per unemployed',
+				freq: 'M',
+				region_code: 'USA',
+				theme: 'jobs',
+				meta: { url: 'https://fred.stlouisfed.org/series/JTSJOL', derived: 'JTSJOL / UNEMPLOY' }
+			}
+		],
+		rows.map((r) => ({ series_id: id, period: r.period, value: r.value, status: null }))
+	);
+	return rows.length;
+}
+
+// ── Derived: real wage growth and an approximate median wage ────────────────────────────────
+async function wageDerived(): Promise<number> {
+	const growth = await sql<{ region: string; period: string; value: number }[]>`
+		select s.region_code as region, o.period::text as period,
+			round((100 * (o.value / p.value - 1))::numeric, 2)::float8 as value
+		from stats.series s
+		join stats.obs o on o.series_id = s.series_id
+		join stats.obs p on p.series_id = s.series_id and p.period = o.period - interval '1 year'
+		where s.series_id like 'oecd:jobs:avwage:%' and p.value > 0 and o.value is not null
+		order by 1, 2`;
+	const median = await sql<{ region: string; period: string; value: number }[]>`
+		select s.region_code as region, o.period::text as period,
+			round((o.value / (r.value / 100))::numeric, 0)::float8 as value
+		from stats.series s
+		join stats.obs o on o.series_id = s.series_id
+		join stats.obs r on r.series_id = 'oecd:jobs:min2median:' || s.region_code and r.period = o.period
+		where s.series_id like 'oecd:jobs:minwage:%' and r.value > 0 and o.value is not null
+		order by 1, 2`;
+	const write = async (
+		rows: { region: string; period: string; value: number }[],
+		name: string,
+		title: string,
+		unit: string,
+		derived: string
+	) => {
+		const regions = [...new Set(rows.map((r) => r.region))];
+		await writeSeries(
+			regions.map((region) => ({
+				series_id: `jobs:${name}:${region}`,
+				source_id: 'oecd',
+				source_code: derived,
+				title,
+				unit,
+				freq: 'A',
+				region_code: region,
+				theme: 'jobs',
+				meta: { url: 'https://data-explorer.oecd.org/', derived }
+			})),
+			rows.map((r) => ({
+				series_id: `jobs:${name}:${r.region}`,
+				period: r.period,
+				value: r.value,
+				status: null
+			}))
+		);
+		return rows.length;
+	};
+	if (!growth.length) throw new Error('wage derived: run the wages job first');
+	return (
+		(await write(
+			growth,
+			'realwagegrowth',
+			'Real average wage growth (constant prices)',
+			'%',
+			'yoy(AV_AN_WAGE, constant prices)'
+		)) +
+		(await write(
+			median,
+			'medianwage',
+			'Median full-time wage, approx. (real minimum wage ÷ minimum-to-median ratio)',
+			'USD PPP',
+			'RMW / MIN2AVE(median)'
+		))
+	);
+}
+
+// ── Derived: price level (USA = 100) from the World Bank PPP and exchange rate ─────────────
+async function priceLevel(): Promise<number> {
+	const rows = await sql<{ region: string; period: string; value: number }[]>`
+		select p.region_code as region, o.period::text as period,
+			round((100 * o.value / x.value)::numeric, 1)::float8 as value
+		from stats.series p
+		join stats.obs o on o.series_id = p.series_id
+		join stats.obs x on x.period = o.period and x.series_id = 'wb:PA.NUS.FCRF:' || p.region_code
+		where p.series_id like 'wb:PA.NUS.PRVT.PP:%' and p.region_code is not null
+			and x.value > 0 and o.value is not null
+		order by 1, 2`;
+	if (!rows.length)
+		throw new Error('price level: run worldbank first (PA.NUS.PRVT.PP, PA.NUS.FCRF)');
+	const regions = [...new Set(rows.map((r) => r.region))];
+	await writeSeries(
+		regions.map((region) => ({
+			series_id: `jobs:pricelevel:${region}`,
+			source_id: 'worldbank',
+			source_code: 'PA.NUS.PRVT.PP/PA.NUS.FCRF',
+			title: 'Price level of household consumption (PPP ÷ exchange rate, USA = 100)',
+			unit: 'USA = 100',
+			freq: 'A',
+			region_code: region,
+			theme: 'jobs',
+			meta: {
+				url: 'https://data.worldbank.org/indicator/PA.NUS.PRVT.PP',
+				derived: '100 × PA.NUS.PRVT.PP / PA.NUS.FCRF'
+			}
+		})),
+		rows.map((r) => ({
+			series_id: `jobs:pricelevel:${r.region}`,
+			period: r.period,
+			value: r.value,
+			status: null
+		}))
+	);
+	return rows.length;
+}
+
+export async function jobs(opts: { only?: string; job: string }) {
+	await run('oecd', `jobs:${opts.job}`, async (note) => {
+		const want = (j: string) => !opts.only || opts.only.split(',').includes(j);
+		let total = 0;
+		for (const spec of SPECS) {
+			if (!want(spec.job)) continue;
+			try {
+				total += await pullOecd(spec);
+			} catch (error) {
+				note(`${spec.flow}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			await sleep(3200); // OECD: ≤ 20 requests a minute
+		}
+		if (want('bigmac'))
+			try {
+				total += await bigmac();
+			} catch (error) {
+				note(`bigmac: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		if (want('jolts'))
+			try {
+				total += await joltsRatio();
+			} catch (error) {
+				note(`jolts: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		if (want('wages') || want('derived'))
+			try {
+				total += await wageDerived();
+			} catch (error) {
+				note(`wage derived: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		if (want('pricelevel'))
+			try {
+				total += await priceLevel();
+			} catch (error) {
+				note(`pricelevel: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		if (!total) throw new Error('nothing loaded');
+		return total;
+	});
+}
--- a/scripts/stats/worldbank.ts
+++ b/scripts/stats/worldbank.ts
@@ -102,6 +102,43 @@ export const WB_INDICATORS: { id: string; title: string; unit: string; theme: st
 		title: 'Renewable electricity output',
 		unit: '% of electricity',
 		theme: 'energy'
+	},
+	// Jobs & cost of living (modelled ILO estimates; cover China and most others).
+	{
+		id: 'SL.UEM.1524.ZS',
+		title: 'Youth unemployment, 15–24 (ILO modelled)',
+		unit: '%',
+		theme: 'jobs'
+	},
+	{
+		id: 'SL.UEM.NEET.ZS',
+		title: 'Youth not in education, employment or training (NEET)',
+		unit: '% of youth',
+		theme: 'jobs'
+	},
+	{
+		id: 'SL.UEM.ADVN.ZS',
+		title: 'Unemployment with advanced education',
+		unit: '% of labour force with advanced education',
+		theme: 'jobs'
+	},
+	{
+		id: 'SL.TLF.PART.ZS',
+		title: 'Part-time employment',
+		unit: '% of total employment',
+		theme: 'jobs'
+	},
+	{
+		id: 'PA.NUS.FCRF',
+		title: 'Official exchange rate',
+		unit: 'LCU per US$, period average',
+		theme: 'jobs'
+	},
+	{
+		id: 'PA.NUS.PRVT.PP',
+		title: 'PPP conversion factor, private consumption',
+		unit: 'LCU per international $',
+		theme: 'jobs'
 	}
 ];