ERCOT Large Load Monitor

Monitor official ERCOT large-load integration reports, monthly updates, Batch Zero milestones, and data-center load modeling documents.

What It Does

• Scans public ERCOT source pages for PDFs and other published documents.
• Parses ERCOT Monthly and large-load update PDFs for deterministic metrics.
• Emits agent-ready JSON records with source URLs, parsed metrics, milestones, status deltas, and dedupe keys.
• Uses named key-value-store state to avoid recharging for the same event in monitor mode.

Default Sources

• ERCOT Presentations and Helpful Resources: https://www.ercot.com/news/presentations
• ERCOT Large Load Integration: https://www.ercot.com/services/rq/large-load-integration
• ERCOT Large Load Working Group: https://www.ercot.com/committees/tac/llwg
• ERCOT Large Load Modeling: https://www.ercot.com/about/grit/large-load-modeling

Parsed Metrics

The actor extracts numeric fields when they appear in official ERCOT PDFs:

• total_queue_mw
• no_studies_mw
• under_ercot_review_mw
• section_9_5_requirements_met_mw
• observed_energized_mw
• approved_to_energize_mw
• approved_not_operational_mw
• observed_non_simultaneous_peak_mw
• observed_simultaneous_peak_mw
• new_lli_submissions
• new_lli_mw
• data_center_share_percent

Missing fields are returned as null, not 0.

Inputs

• includeMonthlyReports: parse ERCOT Monthly PDFs.
• includeLargeLoadDocuments: include Large Load Integration and Large Load Working Group documents.
• includeModelingDocuments: include Large Load Modeling documents.
• includeHearingDecks: include large-load hearing and TAC decks from the presentations page.
• emitDocumentUpdates: emit lower-priced metadata events for newly discovered documents.
• emitStatusDeltas: compare the latest two parsed metric documents and emit changed fields.
• maxDocuments: cap normalized documents per run. Default 20.
• maxPdfDownloads: cap PDF downloads and parsing per run. Default 6.
• maxEvents: cap emitted events per run. Default 10.
• stateStoreName: named state store for dedupe. Use __RUN_DEFAULT__ for isolated demos.
• sourcePages: optional override list of ERCOT public pages.
• extraDocumentUrls: optional direct ERCOT document URLs.

Output Example

{
    "event_type": "ercot_large_load_monthly_update",
    "market": "ERCOT",
    "region": "Texas",
    "source_system": "ERCOT",
    "document_title": "ERCOT Monthly April 2026",
    "document_kind": "monthly_report",
    "document_date": "2026-05-13",
    "document_url": "https://www.ercot.com/files/docs/2026/05/13/ERCOT-Monthly-April-2026-FINAL.pdf",
    "metrics": {
        "total_queue_mw": 445800,
        "no_studies_mw": 321000,
        "under_ercot_review_mw": 93700,
        "section_9_5_requirements_met_mw": 22000,
        "observed_energized_mw": 5900,
        "approved_to_energize_mw": null,
        "approved_not_operational_mw": 3200
    },
    "changed_fields": [],
    "summary": "total queue: 445,800 MW; no studies: 321,000 MW; under ERCOT review: 93,700 MW",
    "dedupe_key": "ercot:monthly:https://www.ercot.com/files/docs/2026/05/13/ERCOT-Monthly-April-2026-FINAL.pdf"
}

Pay-Per-Event Pricing

• ercot_large_load_monthly_update: $0.04, primary event.
• ercot_large_load_status_delta: $0.05, primary event.
• ercot_large_load_document_update: $0.02, secondary event.

Maintenance

Run locally:

npm run build
npm test
npm run lint
npm run canary

The live canary checks that ERCOT's presentations page still exposes monthly reports and that the April 2026 monthly PDF still parses to exact known large-load metrics.

Scope Notes

• v0.1 uses public ERCOT pages and public ERCOT documents only.
• v0.1 parses PDFs. DOCX/XLSX links are surfaced as document updates but not parsed for metrics.
• The actor is not affiliated with, endorsed by, or sponsored by ERCOT.
• Parsed values are source-document facts for monitoring workflows, not regulatory, legal, engineering, or investment advice.