Docs

Machine Page Format (MPF)

Eine Seite für Menschen. Eine für Maschinen. Beide deklariert.

Machine Page Format (MPF) ist ein offenes Format, um neben einer HTML-Seite einen maschinenlesbaren Companion zu veröffentlichen. Der Companion trägt YAML-Frontmatter mit Deklarationen des Publishers über die Ressource, gefolgt von einem sauberen Markdown-Body. Er wird zur Build-Zeit aus demselben HTML erzeugt, das Menschen lesen.

MPF beantwortet eine enge Frage: Was muss ein Publisher offenlegen, damit eine Maschine eine öffentliche Seite identifizieren, entdecken und interpretieren kann, ohne Fakten zu raten, die der Publisher direkt hätte angeben können?

  • Scope: ein machine publishing contract — Identität, Repräsentation, Publisher-Deklarationen und Discovery, mit Processing Scope als einem Teil davon.
  • Beitrag: die deklarierte Beziehung zwischen einer menschlichen Seite und ihrer Maschinenrepräsentation.

Die menschliche Seite bleibt die kanonische Adresse. Die MPF-Datei ist ihr deklarierter Parallelpfad.

Status
Aktuelle Version 0.7 — Spezifikation 0.7
Vorherige Version 0.6 — Spezifikation 0.6
Referenzimplementierung mpf-build — git.esfi.eu/esfi/mpf
Verifizierte Emitter Implementierungsregister
Versionsrichtlinie Versionierung

Die Spezifikation beschreibt, was die Referenzimplementierung tatsächlich erzeugt. Ein Feldname gibt MPF keine Fähigkeit, die die Implementierung nicht besitzt.

Wie Sie diesen Abschnitt lesen

Seiten in diesem Abschnitt kennzeichnen jede Regel mit ihrem Status:

Marker Bedeutung
Spezifikation 0.7 In der veröffentlichten Spezifikation definiert. Konforme Producer und Consumer können sich darauf verlassen.
Referenzimplementierung Verhalten von mpf-build, das die Spezifikation noch nicht beschreibt. In der Praxis stabil, aber noch nicht normativ.
ESFI-Praxis Eine Deployment-Konvention auf ESFI-Sites, außerhalb von Builder und Spezifikation. Dokumentiert, damit andere sie reproduzieren können; für Konformität nicht erforderlich.

Ein Mechanismus wechselt nur durch eine neue Spezifikationsversion von Praxis in die Spezifikation.

Anatomie einer MPF-Datei

index.html   →   index.mpf
about/index.html   →   about/index.mpf
---
mpf: '0.7'
title: Example page
url: https://example.org/about/
mpf-url: https://example.org/about/index.mpf
organization: Example Publisher
domain: example.org
lang: en
updated: 2026-09-21
author: Example Publisher
provenance: human
source-hash: 3f1c…
toc:
  - level: 1
    text: About
    id: about
spec-origin: example.org
content-origin: example.org
content-id: example:page:about
content-parity:
  html: true
  human-visible-source: true
  hidden-sections: false
index: true
companion-scope:
  cite: true
  summarize: true
  train: false
  index: true
  relay: false
mpf-id: 9a0b…
---

# About {#about}

Clean Markdown body of the page…

Example Publisher — https://example.org

Das Frontmatter wird in stabiler Reihenfolge serialisiert. mpf-id ist ein SHA-256-Digest des vollständigen Dokuments, bevor mpf-id selbst eingefügt wird; source-hash ist ein SHA-256-Digest des rohen Quell-HTML. Details: Spezifikation 0.7.

Was die Deklarationen abdecken

Gruppe Felder Was ein Leser erfährt
Identität url, mpf-url, content-id, lang, language-variants Welche logische Ressource dies ist, wo beide Repräsentationen liegen und welche Dateien äquivalente Sprachversionen sind
Publisher organization, domain, author, spec-origin, content-origin Wer hinter den Deklarationen steht
Provenienz provenance, confidence, c2pa-manifest Wie der Publisher Ursprung und Status des Inhalts beschreibt
Integrität source-hash, mpf-id, signature Ob das Paar abgedriftet ist, ob sich diese Datei verändert hat und ob der deklarierte Publisher sie signiert hat
Parität content-parity Wie der Maschinen-Body sich zu dem verhält, was ein Mensch sieht
Processing Scope companion-scope Was der Publisher beabsichtigt, dass eine Maschine mit dem Inhalt tut
Lifecycle updated, valid-until, review-after, supersedes, superseded-by Ob die Ressource aktuell ist und was sie ersetzt
Struktur toc, section, parent, related, summary, content-type Wie die Seite organisiert ist und zu anderen Seiten steht
Publisher an Leser companion-instruction, companion-footer, companion-contact, preferred-representation Nachricht des Publishers an den Maschinenleser, Signaturzeile und Kontakt
Indexierung index Ob die Seite in den Maschinenindizes der Site erscheint

Pflichtfelder, optionale Felder und Generierungsregeln: Spezifikation 0.7. Konfiguration und Seiten-Overrides: Implementierung.

Discovery in einem Absatz

Eine Maschine sollte die MPF-Repräsentation finden, bevor sie HTML interpretiert. Der Builder schreibt llms.txt mit einem MPF-Abschnitt (Version, Spezifikationszeiger, Indexpfad) und llms.mpf, einen MPF-Index aller indexierten Seiten; jede Seite trägt ihren Companion am selben Pfad mit .mpf anstelle von .html (Spezifikation 0.7). ESFI-Sites veröffentlichen zusätzlich einen DNS-TXT-Eintrag und eine /.well-known/mpf-Deklaration (ESFI-Praxis). Vollständige Referenz: Veröffentlichung und Discovery.

Deklarationen, keine Urteile

Jedes MPF-Feld wird entweder aus der Quelle erzeugt oder vom Publisher deklariert. Keines davon ist unabhängige Verifikation.

  • provenance: human sagt, wie der Publisher den Ursprung beschreibt. Es beweist ihn nicht.
  • confidence sagt die Einschätzung des Publishers. Es ist keine Validierung.
  • companion-scope sagt die beabsichtigte Verarbeitung. Es ist kein technisches Schloss und ersetzt nicht geltendes Recht.
  • source-hash zeigt, ob das Paar abgedriftet ist. Es beweist nicht, dass der Inhalt wahr ist.
  • Eine Signatur zeigt, dass ein bestimmter Schlüssel eine bestimmte Datei signiert hat. Sie zeigt nicht, dass die Aussagen darin korrekt sind.

Ein konsumierendes System sollte diese Unterscheidungen in seinem eigenen Datenmodell behalten und jedes Signal danach beurteilen, was es tatsächlich feststellt.

Beziehung zu anderen Standards

MPF arbeitet neben anderen Ansätzen im selben Raum. Es ersetzt keinen davon.

Standard Was er behandelt
robots.txt Präferenzen für Crawler-Zugriff
llms.txt Leichtgewichtiger Einstiegspunkt für Sprachmodelle; MPF erweitert das llms.txt der Site um einen MPF-Abschnitt
TDMRep W3C-Community-Group-Protokoll für den EU-Vorbehalt zu Text- und Data-Mining
RSL Lizenzbedingungen des Publishers für AI-Nutzung
AIPREF (IETF) Vokabular für AI-Nutzungspräferenzen; Arbeit bei der IETF
C2PA Kryptografische Content-Provenienz und Credentials; eine MPF-Datei kann mit c2pa-manifest auf ein C2PA-Manifest zeigen

Was MPF nicht behauptet

  • Kein Wahrheitssystem. Deklarationen sind Deklarationen; Verifikation braucht unabhängige Evidenz.
  • Kein Rechtsinstrument. train: false zeichnet eine erklärte Position auf, keinen Vertrag und kein Schloss. Die Rechtswirkung hängt vom geltenden Recht ab.
  • Kein Durchsetzungsmechanismus. Kein Feld wird vom Format erzwungen.
  • Kein Ersatz für HTML. Die menschliche Seite bleibt kanonisch.
  • Kein Gatekeeper. MPF zu veröffentlichen und zu lesen erfordert keinen ESFI-Dienst, keine Registrierung und keine Erlaubnis.

Weiter

  • Warum MPF existiert und der Brief, mit dem die Arbeit begann: companion.esfi.eu
  • ESFIs Position zum zugrunde liegenden Problem: AI-Readiness
  • Was Companion auf ESFI-Sites bedeutet: Glossar