Eugen Ullrich / OKF Hub
/docs/quickstart/

Schnellstart: OKF in fünf Minuten

Am Ende dieser Seite haben Sie ein gültiges OKF-Bundle gebaut, es in den Hub geladen und Ihre erste Frage daran gestellt. Kein SDK, kein Build-Schritt. Ein Texteditor genügt.

Wenn Sie erst einmal nur zuschauen wollen: Melden Sie sich im Hub mit Google an und laden Sie die Demo-Datenbank. Die Demo zählt nicht gegen Ihr Upload-Limit. Wer eigenes Wissen mitbringt, liest weiter.

Schritt 1: Ein Konzept schreiben

Ein Konzept ist eine Markdown-Datei mit einem kleinen YAML-Kopf. Legen Sie eine Datei crawl-budget.md an:

---
type: Guide
title: Crawl-Budget bei großen Websites
description: Wie Google das Crawl-Budget verteilt und woran man Verschwendung erkennt.
tags: [crawl-budget, technical-seo, indexierung]
---

# Was Crawl-Budget bedeutet

Crawl-Budget ist die Zahl der URLs, die Google in einem Zeitraum
auf einer Domain abruft …

# Woran man Verschwendung erkennt

Endlose Parameter-URLs, Session-IDs und Filterkombinationen …

Nur type ist Pflicht. Die drei anderen Felder kosten Sie zehn Sekunden und verbessern Suche, Graph und Retrieval spürbar. Die vollständige Feldreferenz steht im Frontmatter-Schema.

Wissen wird interessant, sobald Konzepte aufeinander verweisen. Legen Sie logfile-analyse.md an und verlinken Sie das erste Konzept bundle-relativ mit führendem /:

---
type: Guide
title: Logfile-Analyse für Crawl-Steuerung
description: Aus Server-Logs ablesen, was Google wirklich crawlt.
tags: [logfiles, crawl-budget, technical-seo]
---

# Ziel

Server-Logs zeigen das echte Crawl-Verhalten, nicht das vermutete.
Das ergänzt die Sicht aus [Crawl-Budget](/crawl-budget.md).

Beide Dateien teilen die Tags crawl-budget und technical-seo. Diese gemeinsamen Tags erzeugen später die Ähnlichkeitskante im Knowledge Graph, der Link erzeugt die gerichtete Kante.

Schritt 3: Als Bundle verpacken

Ein Bundle ist schlicht ein Ordner. Legen Sie beide Dateien hinein und packen Sie ihn als Zip:

mein-wissen/
├── crawl-budget.md
└── logfile-analyse.md
zip -r mein-wissen.zip mein-wissen/

Das war das ganze „Format". Optional können Sie eine index.md als Übersicht und eine log.md als Änderungshistorie ergänzen – beide sind reservierte Dateinamen mit fester Struktur, beschrieben in der Spezifikation.

Schritt 4: In den Hub laden

Melden Sie sich im Hub mit Google an, klicken Sie auf „OKF hochladen" und wählen Sie „Fertiges OKF-Bundle". Erlaubt sind .zip, .md und .json, maximal 20 MB pro Datei. Laden Sie mein-wissen.zip.

Der Hub liest die Markdown-Dateien, legt zwei Konzepte an und baut einen semantischen Suchindex. Systemdateien und die Sammeldateien README.md, INDEX.md, okf.md werden dabei absichtlich übersprungen.

Schritt 5: Fragen und Quellen prüfen

Öffnen Sie den AI RAG Assistant, wählen Sie Ihre neue Quelle und ein Modell und stellen Sie eine konkrete Frage: „Woran erkenne ich verschwendetes Crawl-Budget, und wie hilft die Logfile-Analyse dabei?" Der Assistent zieht die relevanten Konzepte, antwortet nur aus ihnen und nummeriert die verwendeten Quellen. Ein Klick auf eine Quellennummer öffnet den zugehörigen OKF-Auszug im Reader.

Prüfen Sie die Quellen, bevor Sie eine Antwort verwenden. RAG senkt unbelegte Aussagen, verhindert sie aber nicht vollständig.

Was jetzt hilft

Drei kleine Gewohnheiten machen jedes weitere Bundle besser. Schreiben Sie Beschreibungen, die für sich stehen – die Suche gewichtet Titel und Beschreibung stärker als den Fließtext. Halten Sie Tags konsistent, sonst zersplittern die Ähnlichkeitskanten. Und teilen Sie große Themen in mehrere Konzepte, statt ein Konzept auf 5000 Wörter aufzublähen; kleinere, verlinkte Einheiten liefern beim Retrieval präzisere Treffer.

Weiter im Thema

Sie haben schon Wissen in Notion, Obsidian, Logseq oder Confluence? Die Migrationsseite überführt Exporte direkt in OKF. Wer Bundles automatisiert erzeugen und prüfen will, findet den Weg unter CLI und CI/CD. Fertige Prompts für die Anreicherung stehen unter Prompt-Vorlagen.