Skip to content

Repository files navigation

pag-extract

Kongressprogramme als Datei — statt 40 Browser-Tabs.

Liest das öffentliche Programm eines medizinischen Kongresses aus und schreibt es als Markdown, CSV oder JSON auf die Festplatte. Alle Sessions, Räume, Vorsitzende, Einzelvorträge und Referierende — in wenigen Sekunden.

English version →

▸ Kongress für Kinder- und Jugendmedizin (kkj2026)
▸ 4 congress day(s): 2026-11-18, 2026-11-19, 2026-11-20, 2026-11-21
▸ 144 sessions
▸ 666 talks
▸ written to programm.md

Wofür ist das gut?

Wer einen Kongress vorbereitet, klickt sich sonst durch den Online-Kalender: Tag für Tag, Raum für Raum, Vortrag für Vortrag. Das lässt sich weder durchsuchen noch ausdrucken, nicht mit Kolleginnen teilen und schon gar nicht von einer KI auswerten.

pag-extract holt das komplette Programm in eine Datei. Damit lässt sich dann:

  • das Programm nach Stichworten durchsuchen (Impfung, Neonatologie, …)
  • ein persönlicher Ablaufplan bauen
  • die Datei einer KI geben: „Welche Vorträge passen zu meinem Schwerpunkt?“
  • eine Referentenliste nach Excel exportieren

Funktioniert das für meinen Kongress?

Wenn die Programmseite so aussieht —

https://pag.virtual-meeting.org/MCON/kkj2026/de-DE/pag?...

— dann ja. Das ist die Plattform m-anage / VMX, auf der über 30 medizinische Fachgesellschaften ihre Kongresse betreiben, u. a.:

DGPPN · DGN · ERS · ESMO · EULAR · EHA · EASL · EADV · ESCRS · ESOT · EANM · Intercongress · KIT Group · MCON Mannheim · Congrex

Die vollständige Liste zeigt das Programm bei einem unbekannten Kongress selbst an.


Schnellstart (ohne Vorkenntnisse)

Der einfachste Weg: die KI machen lassen

Wer GitHub Copilot CLI, Claude Code, ChatGPT Codex, Cursor oder ein ähnliches Werkzeug nutzt, muss gar nichts installieren oder verstehen. Dieses Repository herunterladen, im Ordner die KI starten und schreiben:

Lies das Programm von https://pag.virtual-meeting.org/MCON/kkj2026/de-DE/pag aus und speichere es als programm.md

Die KI findet die Anleitung in AGENTS.md selbst und erledigt den Rest.

Warum das in jedem dieser Werkzeuge funktioniert

Das Repository enthält seine eigene Bedienungsanleitung in genau den Dateien, die diese Werkzeuge von sich aus lesen:

Datei Wird gelesen von
AGENTS.md GitHub Copilot, Codex, Cursor, Claude Code, Gemini CLI, Aider
.github/copilot-instructions.md GitHub Copilot (CLI, VS Code, Cloud-Agent)
CLAUDE.md Claude Code, GitHub Copilot CLI
.claude/skills/pag-extract/SKILL.md Claude Code und GitHub Copilot (CLI + VS Code) — alle durchsuchen .claude/skills

Es ist also keine Einrichtung nötig und keine Datei zu kopieren. Klonen genügt.

Mit GitHub Copilot CLI

Copilot CLI ist seit Februar 2026 allgemein verfügbar und in jedem Copilot-Tarif enthalten — auch im kostenlosen. Es ist ein vollwertiger Terminal-Agent, der Befehle ausführen kann; genau das braucht dieses Werkzeug.

# einmalig installieren (benötigt Node.js 22+)
npm install -g @github/copilot
# alternativ: brew install copilot

# Repository holen und Copilot darin starten
git clone https://github.com/Steffen025/pag-extract.git
cd pag-extract
copilot

Beim ersten Start /login eingeben und mit dem GitHub-Konto anmelden. Danach im Copilot-Fenster einfach schreiben:

Lies das Programm von https://pag.virtual-meeting.org/MCON/kkj2026/de-DE/pag aus und speichere es als programm.md

Copilot findet die Anleitung in .github/copilot-instructions.md und das fertige Skill unter .claude/skills/ von allein. Beim Ausführen von node einmal bestätigen — fertig.

⚠️ „Copilot“ gibt es dreimal — nur eines davon passt hier

Produkt Was es ist Funktioniert hier?
Microsoft Copilot Chat-Assistent in Windows, Edge, im Browser
Microsoft 365 Copilot in Word, Excel, Outlook, Teams
GitHub Copilot für Entwicklung — Editor und Terminal dieses

Eine Microsoft-365-Copilot-Lizenz enthält GitHub Copilot nicht. Das sind getrennt gekaufte Produkte, und auch das Microsoft-Konto überträgt keine Lizenz — GitHub Copilot meldet sich am GitHub-Konto an. Der Umweg lohnt sich aber nicht: der GitHub-Copilot-Free-Tarif kostet 0 € und genügt für alles hier.

Wo Microsoft 365 Copilot doch ins Spiel kommt: wenn das ganze Team fragen können soll → Aus dem Programm einen Agenten bauen.

Der manuelle Weg: ein Befehl

Voraussetzung ist Node.js (Version 18 oder neuer) oder Bun. Beides ist ein kostenloser Download.

# Repository holen
git clone https://github.com/Steffen025/pag-extract.git
cd pag-extract

# Programm auslesen
node pag-extract.mjs https://pag.virtual-meeting.org/MCON/kkj2026/de-DE/pag --out programm.md

Fertig. Die Datei programm.md liegt jetzt im Ordner.


Die wichtigsten Varianten

# Komplettes Programm inklusive aller Einzelvorträge und Referierenden
node pag-extract.mjs MCON/kkj2026 --talks --out programm.md

# Nur ein einzelner Kongresstag
node pag-extract.mjs MCON/kkj2026 --day 2026-11-19 --out dienstag.md

# Als Tabelle für Excel / Numbers / Google Sheets
node pag-extract.mjs MCON/kkj2026 --talks --format csv --out programm.csv

# Ohne Industriesymposien — nur das wissenschaftliche Programm
node pag-extract.mjs MCON/kkj2026 --no-sponsor --out programm.md

# Als Rohdaten für eigene Weiterverarbeitung
node pag-extract.mjs MCON/kkj2026 --talks --format json --out programm.json

Statt der langen URL genügt auch die Kurzform INSTANZ/KÜRZEL — beides steht in der Adresszeile des Browsers: .../MCON/kkj2026/de-DE/pag wird zu MCON/kkj2026.

Alle Optionen

Option Wirkung
--talks zusätzlich alle Einzelvorträge mit Referierenden und Keywords
--day YYYY-MM-DD nur dieser Kongresstag
--no-sponsor Industrie-/Sponsorensessions weglassen
--format md|json|csv Ausgabeformat (Standard: md)
--out DATEI in Datei schreiben statt auf den Bildschirm
--lang de-DE Sprache der Programmdaten
--help Hilfe anzeigen

Selbst so etwas bauen

Dieses Werkzeug ist nicht vom Kongressveranstalter — es ist aus dem öffentlichen Programm rekonstruiert worden, in etwa einer Stunde, größtenteils von einer KI.

Wie das geht, und wie sich dasselbe Verfahren auf jede andere Website anwenden lässt, steht Schritt für Schritt in:

📖 Anleitung: Websites selbst „aufschlüsseln“

Inklusive fertigem Prompt zum Kopieren. Technische Vorkenntnisse sind nicht nötig.

Für ein ganzes Team statt für eine Person

Soll nicht eine Person eine Datei erzeugen, sondern das ganze Team in Teams fragen können — „Welche Sitzungen laufen Donnerstagvormittag zum Thema Impfen?“ — dann übernimmt Microsoft Copilot Studio die Verteilung. Die dafür nötige OpenAPI-Spezifikation liegt fertig und live geprüft bei: docs/openapi/congress-programme.swagger.json.

📖 Aus dem Programm einen Agenten bauen — Schritt für Schritt, inklusive der einen Stelle, an der man ohne Hinweis hängen bleibt.


Was das Werkzeug tut — und was nicht

Es ruft ausschließlich die Adressen auf, die die Programmseite selbst aufruft, bevor sich irgendjemand anmeldet. Es ist kein Screen-Scraper: es liest keine Bildschirminhalte aus, sondern die offenen Datenschnittstellen dahinter.

  • ✅ Nur öffentliche Programmdaten — dieselben, die jeder Besucher im Browser sieht
  • ✅ Kein Konto, kein Login, kein Passwort
  • ❌ Keine Inhalte hinter dem Login (Vortragsvideos, Teilnehmerdaten, Abstracts im Volltext)
  • ❌ Keine Kontaktdaten — die Schnittstelle gibt vor dem Login weder E-Mail noch Anschrift heraus

Bei Personen (Vorsitz, Referierende) liefert die Plattform Name, akademischen Titel sowie Stadt und Land — genau das, was ohnehin im veröffentlichten Programm steht.

Bitte fair bleiben: Das Werkzeug macht pro Kongresstag eine Handvoll Anfragen. Es ist nicht dafür gedacht, im Minutentakt zu laufen. Für die Kongressvorbereitung reicht ein Aufruf.


Wenn etwas nicht klappt

Meldung Bedeutung
unknown congress instance "..." Die Organisation fehlt in der Liste — siehe docs/API.md, Abschnitt Adding a new organisation
the congress "..." was not found Kürzel prüfen; es steht in der Adresszeile hinter der Instanz
401 Der öffentliche Lesezugang der Plattform hat sich geändert — siehe docs/API.md, Abschnitt Recovering the credential
no congress day "..." Das Programm nennt die verfügbaren Tage in der Fehlermeldung

Sonst gern ein Issue aufmachen.


Technische Details

Die vollständige Beschreibung der Schnittstellen — Endpunkte, Parameter, Datenfelder, Stabilitätsrisiken — steht in docs/API.md.

Lizenz

MIT — frei verwendbar, auch kommerziell.

Nicht verbunden mit m-anage, VMX oder einem Kongressveranstalter.

About

Kongressprogramme als Datei statt 40 Browser-Tabs — liest das öffentliche Programm jedes m-anage/VMX-Kongresses als Markdown, CSV oder JSON. Zero dependencies, nutzbar aus Claude Code, Codex & Co.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages