---
type: "Blog Post"
title: "OKF (Open Knowledge Format) nedir? Eksiksiz rehber | Roicool"
description: "OKF nedir, nasıl kurulur ve doğrulanır? Google Cloud'un açık bilgi formatını spesifikasyondan, roicool.com'un gerçek OKF çıktısı ve kaynaklarıyla anlatıyoruz."
url: "https://www.roicool.com/blog/okf-nedir"
lang: "tr"
dateModified: "2026-10-20"
author: "Mahmud Filoğlu"
resource: "https://www.roicool.com/blog/okf-nedir"
alternates:
  en: "https://www.roicool.com/en/blog/what-is-okf.md"
generated: { by: "process:roicool-cms", at: "2026-10-20T16:30:27.204Z" }
related:
  - { title: "Google AI Mode nedir? AI Overviews'tan farkı ve markalara etkisi", resource: "https://www.roicool.com/blog/google-ai-mode-nedir.md" }
  - { title: "ChatGPT markaları nasıl seçer? Önerilerin arkasındaki kaynaklar", resource: "https://www.roicool.com/blog/chatgpt-markalari-nasil-secer.md" }
  - { title: "AI görünürlüğü nasıl ölçülür? Yapay zekâ cevaplarında marka takibi", resource: "https://www.roicool.com/blog/ai-gorunurlugu-nasil-olculur.md" }
sources:
  - { id: "1", resource: "https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md", title: "GoogleCloudPlatform, Open Knowledge Format (OKF) v0.2, SPEC.md" }
  - { id: "2", resource: "https://github.com/GoogleCloudPlatform/open-knowledge-format", title: "GoogleCloudPlatform, open-knowledge-format deposu (README)" }
  - { id: "3", resource: "https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing", title: "Google Cloud Blog, Introducing the Open Knowledge Format (12 Haziran 2026)" }
  - { id: "4", resource: "https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf", title: "GoogleCloudPlatform, knowledge-catalog: okf klasörü (dondurulmuş 0.1 kopyası)" }
  - { id: "5", resource: "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f", title: "Andrej Karpathy, LLM Wiki (GitHub Gist)" }
  - { id: "6", resource: "https://llmstxt.org/", title: "llmstxt.org, The /llms.txt file, v2 (öneri)" }
  - { id: "7", resource: "https://llmstxt.org/changes.html", title: "llmstxt.org, Changes: v2 (Ağustos 2026)" }
  - { id: "8", resource: "https://developers.google.com/search/docs/appearance/ai-features", title: "Google Search Central, AI features and your website" }
  - { id: "9", resource: "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data", title: "Google Search Central, Introduction to structured data markup in Google Search" }
  - { id: "10", resource: "https://schema.org/", title: "Schema.org" }
  - { id: "11", resource: "https://www.rfc-editor.org/rfc/rfc8288", title: "IETF, RFC 8288: Web Linking" }
  - { id: "12", resource: "https://www.rfc-editor.org/rfc/rfc7763", title: "IETF, RFC 7763: The text/markdown Media Type" }
  - { id: "13", resource: "https://yaml.org/spec/1.2.2/", title: "YAML Ain't Markup Language, revision 1.2.2" }
  - { id: "14", resource: "https://www.batuhandurmaz.com/okf/", title: "Batuhan Durmaz, OKF Nedir? SEO ve Yapay Zekâ Görünürlüğü İçin Önemi (14 Temmuz 2026)" }
  - { id: "15", resource: "https://www.iana.org/assignments/link-relations/", title: "IANA, Link Relations registry" }
---

# OKF (Open Knowledge Format) nedir? Yapı, uygulama ve GEO için anlamı

OKF (Open Knowledge Format), bilgiyi YAML başlıklı Markdown dosyalarından oluşan bir klasör olarak temsil eden açık bir formattır. Google Cloud Haziran 2026'da 0.1 sürümünü duyurdu, güncel sürüm 0.2'dir. Her dosyada zorunlu tek alan type'tır. OKF bir sıralama faktörü değildir; Markdown sürümleri olan bir site için düşük maliyetle ajanların gezebileceği tipli bir bilgi paketi sunar.

- OKF, YAML başlıklı Markdown dosyalarından oluşan bir klasördür; her dosya bir kavramdır ve zorunlu tek alan type'tır.
- Güncel sürüm 0.2: kaynak, güven ve güncellik alanları (sources, generated, verified, status, stale\_after) ekledi.
- index.md ve log.md ayrılmış dosya adlarıdır; sürüm bilgisi yalnızca kök index.md'de durur.
- Spesifikasyon web keşfi tanımlamaz ve OKF okuduğunu belgeleyen bir yapay zekâ arama motoruna rastlamadık. Bugün bir GEO kaldıracı değil, ucuz bir hazırlıktır.
- Markdown ikizleri olan bir site, bunlara YAML başlığı ve klasör dizinleri ekleyerek geçerli bir OKF paketi yayımlayabilir.

OKF (Open Knowledge Format), bilgiyi YAML başlıklı Markdown dosyalarından oluşan bir klasör olarak temsil eden açık bir formattır 1 . Google Cloud, formatın 0.1 sürümünü 12 Haziran 2026'da duyurdu; güncel sürüm 0.2'dir ve kendi GitHub deposunda Apache 2.0 lisansıyla yayımlanıyor 3 2 . Her dosya bir "kavramdır" (concept) ve zorunlu tek alanı `type`'tır 1 . OKF bir sıralama faktörü değildir. Ama sayfalarının Markdown sürümlerini zaten üreten bir site, çok düşük bir maliyetle yapay zekâ ajanlarının okuyup gezebileceği tipli bir bilgi paketi yayımlayabilir. Bu rehber formatı birincil kaynaklardan anlatıyor ve örnek olarak roicool.com'un kendi OKF çıktısını kullanıyor.

## OKF nedir?

OKF, Google Cloud'un Data Cloud ekibinin yazdığı, satıcıdan bağımsız bir bilgi temsil formatıdır. Duyuru yazısı OKF'i "LLM-wiki desenini taşınabilir, birlikte çalışabilir bir formata dönüştüren açık bir spesifikasyon" olarak tanımlıyor 3 . Spesifikasyonun kendi cümlesiyle format "kasıtlı olarak minimaldir": YAML başlıklı Markdown dosyalarından oluşan bir klasör. Şema kaydı, merkezi bir otorite ya da zorunlu bir araç yoktur 1 .

Format üç temel kavram üzerine kurulu 1 :

- **Paket (bundle):** kendi içinde bütün, hiyerarşik bir bilgi belgeleri koleksiyonu. Dağıtım birimidir.
- **Kavram (concept):** paketteki tek bir bilgi birimi, tek bir Markdown belgesi. Bir tabloyu, bir API'yi, bir metriği ya da bir iş sürecini anlatabilir.
- **Kavram kimliği:** dosyanın paket içindeki yolu, `.md` uzantısı olmadan.

| Tarih | Gelişme | Kaynak |
| --- | --- | --- |
| 12 Haziran 2026 | Google Cloud Blog'da OKF 0.1 duyuruldu; spesifikasyon knowledge-catalog deposunun içinde yayımlandı | 3 |
| Ağustos 2026 | OKF kendi deposuna (GoogleCloudPlatform/open-knowledge-format) taşındı; eski kopya donduruldu | 2 4 |
| Ekim 2026 itibarıyla | Güncel sürüm 0.2: kaynak, güven ve yaşam döngüsü alanları; saat dilimli zaman damgaları | 1 |

Depoda spesifikasyonun yanında BigQuery veri setlerinden OKF paketi üreten bir referans ajan, paketi etkileşimli bir grafik olarak gösteren bir görselleştirici ve GA4, Stack Overflow, Bitcoin ve Acme Retail örnek paketleri bulunuyor. README bu ajanı açıkça bir "kavram kanıtı" (proof of concept) olarak tanımlıyor; asıl katkı formatın kendisi 2 .

## OKF neden ortaya çıktı?

OKF'in çözmeye çalıştığı sorun web araması değil, kurum içi bağlamdır. Google'ın duyurusuna göre yapay zekâ ajanlarının ihtiyaç duyduğu bilgi büyük ölçüde kurum içidir: bir tablonun şeması, bir metriğin şirketteki anlamı, bir olayın çözüm kılavuzu. Bu bilgi metadata kataloglarına, wikilere, kod yorumlarına ve birkaç kıdemli mühendisin aklına dağılmış durumda 3 .

Çıkış noktası Andrej Karpathy'nin "LLM Wiki" notudur. Karpathy, bir dil modelinin kaynakları okuyup birbirine bağlı Markdown dosyalarından oluşan kalıcı bir wikiyi kendisinin yazıp güncel tuttuğu bir düzen anlatıyor 5 . Google'ın tespiti şu: bu desen Obsidian kasalarında, AGENTS.md benzeri dosyalarda ve "kod olarak metadata" depolarında tekrar tekrar ortaya çıkıyor, ama her biri kendine özgü. Hangi alanların zorunlu olduğu ya da hangi dosya adının ne anlama geldiği konusunda ortak bir cevap yok 3 . OKF bu ortak cevabı vermeye çalışıyor.

Spesifikasyon 0.2'de bir adım daha atıyor. Bilgi artık çoğu zaman ajanlar tarafından yazılıp güncelleniyor; okuyan tarafın beş sorusu var: bu neye dayanıyor, ne kadar güvenebilirim, hâlâ doğru mu, güncel sürüm mü, bu sayı söylendiği gibi mi üretildi 1 ? 0.2'nin yeni alanları bu soruları başlık bloğunda cevaplanabilir kılıyor.

## OKF, GEO ve yapay zekâ görünürlüğü için neden önemli?

Dürüst cevap: bugün doğrudan bir görünürlük kazancı yok, ama bir hazırlık değeri var. Bunu üç gerçekten çıkarıyoruz.

**1. OKF bir web standardı olarak yazılmadı.** Spesifikasyon depolama, sunum ve sorgulama altyapısı tanımlamayı açıkça hedef dışı bırakıyor 1 . Bir HTTP yolu, bir keşif dosyası ya da llms.txt ve schema.org'a bir atıf içermiyor. Örnek paketler web siteleri değil, veri setleri 2 .

**2. Arama motorları ek dosya istemiyor.** Google, AI Overviews ve AI Mode'da görünmek için yeni makine okunur dosyalar, yapay zekâ metin dosyaları ya da işaretleme oluşturmanız gerekmediğini yazıyor 8 . Ekim 2026 itibarıyla ChatGPT, Gemini, Perplexity ya da Google'ın yapay zekâ özellikleri için web sitelerindeki OKF paketlerini okuduğunu söyleyen bir belgeye rastlamadık.

**3. Ajanlar Markdown okuyor ve OKF bunu düzenli hale getiriyor.** llms.txt önerisi, ajanların artık web sitelerini rutin olarak kullandığını ve sayfaların temiz Markdown sürümlerinin `.md` uzantılı adreslerde sunulmasını öneriyor 6 . OKF bu Markdown sürümlerine üç şey ekler: bir `type` alanı, kavramlar arası bağlantılardan oluşan bir grafik ve kaynak ile güncellik bilgisi 1 . Google ayrıca Knowledge Catalog ürününü OKF içe alabilecek şekilde güncellediğini açıkladı 3 . Yani formatı okuyan gerçek bir tüketici var, ama şimdilik kurum içi veri dünyasında.

Bu yüzden OKF'i şöyle konumluyoruz: zaten Markdown sürümleri üreten bir site için birkaç saatlik ek iş, ajan çağına hazırlık. Görünürlük için önceliği almamalı. Önce sayfa içeriği, [schema.org](https://www.roicool.com/sozluk/schema-org) işaretlemesi, tarayıcı erişimi ve üçüncü taraf kaynaklar gelir; bunların listesi [GEO kontrol listemizde](https://www.roicool.com/blog/geo-kontrol-listesi). OKF'i SEO açısından ele alan bir Türkçe yazı da OKF'in schema işaretlemesinin yerini almadığını, onu tamamladığını vurguluyor 14 . Bu noktada aynı görüşteyiz.

## OKF paketinin yapısı

Bir OKF paketi, Markdown dosyalarından oluşan bir klasör ağacıdır. Klasör yapısı alandan bağımsızdır; kavramları üretici istediği gibi düzenler 1 .

```
paket/
  index.md          # isteğe bağlı: klasör dizini
  log.md            # isteğe bağlı: değişiklik kaydı
  kavram.md         # kökte bir kavram
  alt-klasor/
    index.md
    kavram.md
```

**Ayrılmış dosya adları.** `index.md` (klasör dizini) ve `log.md` (değişiklik kaydı) hiyerarşinin her seviyesinde ayrılmıştır ve kavram dosyası olarak kullanılamaz 1 . Paket bir git deposu (önerilen), bir tarball ya da zip arşivi veya daha büyük bir deponun alt klasörü olarak dağıtılabilir 1 .

**Kavram dosyası.** Her kavram iki parçalı bir UTF-8 Markdown dosyasıdır: `---` satırları arasında bir YAML başlık bloğu ve serbest bir Markdown gövdesi 1 . YAML'ın kendisi ayrı bir spesifikasyondur; güncel 1.2.2 revizyonu YAML'ı JSON'un katı bir üst kümesi yapmayı hedefliyor 13 . Bu yüzden JSON tırnaklı bir metin, geçerli bir YAML değeridir.

| Alan | Durum | Ne işe yarar |
| --- | --- | --- |
| `type` | zorunlu | Kavramın türü ("Service", "Metric", "Playbook"). Merkezi bir liste yoktur; tüketiciler bilmedikleri türü genel kavram gibi okur. |
| `title` | önerilen | Görünen ad; yoksa dosya adından türetilebilir. |
| `description` | önerilen | Tek cümlelik özet; index.md üreticileri ve önizlemeler kullanır. |
| `resource` | önerilen | Kavramın anlattığı varlığın benzersiz adresi (URI). |
| `tags` | önerilen | Kısa etiketler listesi. |
| diğer anahtarlar | serbest | Üretici istediği alanı ekleyebilir; tüketici bilmediği alanı reddedemez. |

Tablodaki kurallar spesifikasyonun 4.1 bölümünden 1 . Gövde için zorunlu bir bölüm yok; ama `# Schema`, `# Examples` ve `# Computation` başlıklarının geleneksel anlamı var ve yapısal Markdown (başlık, liste, tablo, kod bloğu) düz metne tercih ediliyor 1 .

**0.2'nin yeni alan aileleri.** Hepsi isteğe bağlı; yoklukları da bir anlam taşır 1 .

| Aile | Alanlar | Ne söyler |
| --- | --- | --- |
| Kaynak (provenance) | `sources` (her girişte zorunlu `resource`; isteğe bağlı `id`, `title`, `author`, `usage_count`, `last_modified`) | Kavram neye dayanıyor? Gövdedeki tek bir iddia, etiketi `sources` içindeki `id` olan bir Markdown dipnotuyla kaynağa bağlanır. |
| Güven | `generated: { by, at }`, `verified: [{ by, at }]` | Kim yazdı, kim doğruladı? `verified` yoksa kavram "doğrulanmamış", yalnızca makineler doğruladıysa "makine onaylı", bir `human:` aktörü doğruladıysa "insan incelemeli" sayılır. |
| Yaşam döngüsü | `status` (draft, stable, deprecated), `stale_after` | Hâlâ geçerli mi? `status` yoksa `stable` kabul edilir. |
| Hesaplama | `runtime`, `parameters`, `computation`, `executor`, `attester` | Yalnızca `type: Attested Computation` için: bir sayının onaylı yolla hesaplandığını doğrulamak. |

**Aktör kuralı.** `generated.by` ve `verified[].by` alanları üç biçimden birini kullanır: araçlar ve ajanlar için `<üretici>/<sürüm>`, insanlar için `human:<id>`, otomatik süreçler için `process:<id>` 1 . Güven sınıflandırması `human:` önekine baktığı için, elle yazılmış ya da insan onaylı içerik bu öneki kullanmak zorundadır 1 .

**Zaman damgaları.** OKF'teki her zaman değeri, açık bir saat dilimi farkı taşıyan ISO 8601 tarih-saatidir: `2026-06-30T14:00:00Z` gibi 1 . Yalnızca tarih (`2026-06-30`) yazmak, farklı saat dilimlerinde farklı anlara denk geldiği için geçerli değil.

**index.md.** Her klasörde bulunabilir ve ajanın dosyaları açmadan neyin olduğunu görmesini sağlar ("kademeli açılım"). Gövde, başlık altında `* [Başlık](göreli-adres) - kısa açıklama` satırlarından oluşur. index.md başlık bloğu taşımaz; tek istisna, paketin hedeflediği sürümü bildiren kök index.md'deki `okf_version` alanıdır 1 .

**Bağlantılar.** Kavramlar standart Markdown bağlantılarıyla birbirine bağlanır. Paket köküne göre mutlak yol (`/tablolar/musteriler.md`) önerilen biçimdir, göreli yol da geçerlidir. Hedefi olmayan bir bağlantı hatalı sayılmaz; henüz yazılmamış bir bilgiyi gösterebilir 1 .

## Gerçek bir örnek: roicool.com'un OKF çıktısı

roicool.com'daki her sayfanın bir Markdown ikizi var: sayfanın adresine `.md` eklenen bir dosya. OKF paketi bu ikizlerden üretiliyor ve `/okf/` klasöründe yayımlanıyor. Paketin kök dizini `/okf/index.md`, İngilizce dizin `/okf/en/index.md`. Aşağıdaki iki blok, sitenin kod tabanındaki üreticinin (Next.js uygulamasında `lib/markdown`) çıktısıdır; uzun listeler kısaltıldı.

Kök dizin, `/okf/index.md`:

```
---
okf_version: "0.2"
---

# Roicool

> Roicool, dinamik ve hedef odaklı markalar için dijitalde sürdürülebilir büyüme sağlar.

# Sayfalar

* [Ana sayfa](home.md)

# Bölümler

* [Hizmetler](hizmetler/index.md)

# Diller

* [English](en/index.md)
```

Bir kavram, `/okf/hizmetler/geo-ajansi.md` (kısaltılmış):

```
---
type: "Service"
title: "GEO Ajansı"
description: "Roicool, markaların ChatGPT, Gemini, Perplexity ve Google AI Overviews cevaplarında kaynak gösterilmesini ve önerilmesini sağlayan bir GEO (Generative Engine Optimization) ajansıdır."
url: "https://www.roicool.com/hizmetler/geo-ajansi"
lang: "tr"
dateModified: "2026-10-16"
resource: "https://www.roicool.com/hizmetler/geo-ajansi"
alternates:
  en: "https://www.roicool.com/en/services/geo-agency.md"
generated: { by: "process:roicool-cms", at: "2026-10-16T09:30:00.000Z" }
related:
  - { title: "AI görünürlük analizi", resource: "https://www.roicool.com/hizmetler/ai-gorunurluk-analizi.md" }
  - { title: "GEO uyumlu içerik", resource: "https://www.roicool.com/hizmetler/geo-uyumlu-icerik.md" }
---

# GEO Ajansı Roicool: Yapay Zekâ Cevaplarında Önerilen Marka Olun

Roicool, markaların ChatGPT, Gemini, Perplexity ve Google AI Overviews cevaplarında kaynak gösterilmesini ve önerilmesini sağlayan bir GEO (Generative Engine Optimization) ajansıdır.

## Hizmetler
…
```

Bu örnekte spesifikasyonun hangi kuralının nerede karşılandığı:

| Satır | OKF karşılığı |
| --- | --- |
| `okf_version: "0.2"` yalnızca kök index.md'de | 8. ve 12. bölüm: index.md'de izin verilen tek başlık alanı 1 |
| `* [Ana sayfa](home.md)` | 8. bölüm: dizin girdisi biçimi 1 |
| `home.md` | ana sayfanın ikizi `/index.md` olduğu halde pakette `home.md`: index.md ayrılmış bir ad 1 |
| `type: "Service"` | 4.1: zorunlu tek alan 1 |
| `resource` | 4.1: kavramın anlattığı varlık, burada sayfanın kanonik HTML adresi 1 |
| `generated.by: "process:roicool-cms"` | 5.2 ve 7: dosyayı CMS dışa aktarımı yazdı, bir ajan değil 1 |
| `generated.at` | 5: saat dilimi farkı (`Z`) olan ISO 8601 tarih-saati 1 |
| `url`, `lang`, `dateModified`, `alternates`, `related` | üretici alanları; 4.1 bilinmeyen anahtarların reddedilemeyeceğini söylüyor 1 |

Blog yazılarında bir alan daha var: `sources`. Yazının numaralı "Kaynaklar" listesi başlığa `- { id: "1", resource: "…", title: "…" }` girdileri olarak yazılıyor. Böylece metindeki " 1 ." işareti ile `id: "1"` aynı kaynağı gösteriyor 1 .

## OKF adım adım nasıl uygulanır?

Bir web sitesi için en kısa yol, OKF'i ayrı bir içerik olarak yazmak değil, mevcut içerikten üretmektir. Aşağıdaki sıra bizim izlediğimiz yol.

1. **Kapsamı belirleyin.** Pakete yalnızca yayımlanmış ve dizine eklenebilir sayfalar girsin. Taslaklar, noindex sayfalar, örnek veri taşıyan sayfalar ve iç notlar dışarıda kalsın. En pratik kaynak site haritasıdır.
2. **Her sayfa için temiz bir Markdown sürümü üretin.** Menü, alt bilgi ve çerez bandı olmadan; başlık, tanım, bölümler, tablolar ve SSS ile. llms.txt önerisinin `.md` uzantısı kuralı bu sürümler için iyi bir adres düzenidir 6 .
3. **Bir `type` sözlüğü yazın.** CMS koleksiyonlarını türlere eşleyin: hizmet, sektör, vaka çalışması, blog yazısı, sözlük terimi. Türler serbest metindir, ama sitenin içinde her tür tek bir yazımla geçmeli 1 .
4. **Başlık bloğunu doldurun.** `type` ilk satırda, ardından `title`, `description` ve `resource`. Sayfanın kanonik adresi iyi bir `resource` değeridir 1 .
5. **Kaynak ve güncelliği ekleyin.** `generated: { by, at }` ile dosyayı kimin ürettiğini ve içeriğin son anlamlı değişikliğini; kaynaklı içerikte `sources` ile dayanakları yazın. Doğrulama tarihi kaydetmiyorsanız `verified` yazmayın 1 .
6. **Paket yollarını kurun.** Paketi ayrı bir kökte (`/okf/` gibi) yayımlayın ve `index.md` adını alan bir sayfa varsa yeniden adlandırın. Ayrılmış ad kuralı her klasör için geçerlidir 1 .
7. **Her klasöre index.md üretin.** Başlık altında `* [Başlık](göreli-adres) - açıklama` satırları; açıklama, kavramın `description` alanından gelsin 1 .
8. **Kök dizine sürümü yazın.** Yalnızca kök index.md'nin başına `okf_version: "0.2"` 1 .
9. **Keşif ekleyin.** Spesifikasyon keşif tanımlamadığı için bunu web'in kendi araçlarıyla yapın: llms.txt'den paket dizinine bir bağlantı, sayfa `<head>`'inde bir `<link>` öğesi ve [robots.txt](https://www.roicool.com/sozluk/robots-txt) içinde bir izin satırı. llms.txt'nin 2. sürümü Markdown sürümleri için `rel="alternate" type="text/markdown"` ve llms.txt için `rel="describedby"` ilişkilerini, `<link>` öğesi ya da HTTP `Link:` başlığı olarak öneriyor 6 7 . HTTP `Link:` başlığının sözdizimi RFC 8288'de 11 , Markdown'ın `text/markdown` medya türü RFC 7763'te tanımlı 12 .
10. **Doğrulayın ve tekrarlayın.** Her içerik yayınından sonra paketi baştan sona gezen bir kontrol çalıştırın (aşağıdaki bölüm).

## OKF, llms.txt, schema.org ve Markdown ikizleri: farkları

Dördü de "yapay zekâya içeriğinizi anlatmak" başlığı altında anılıyor, ama farklı katmanlarda çalışıyor.

|  | Schema.org / JSON-LD | Markdown ikizi | llms.txt | OKF |
| --- | --- | --- | --- | --- |
| Ne | HTML içinde yapılandırılmış veri sözlüğü | Sayfanın temiz Markdown sürümü | Sitenin kökünde ajanlar için giriş ve bağlantı listesi | Tipli Markdown kavramlarından oluşan paket |
| Kim tanımlıyor | Schema.org topluluğu 10 | llms.txt önerisi 6 | llms.txt önerisi 6 | Google Cloud, açık spesifikasyon 1 |
| Statüsü | Google belgeliyor ve kullanıyor 9 | Öneri | Öneri 6 | 0.2 sürümünde açık spesifikasyon 1 |
| Nerede durur | Sayfanın içinde | Sayfanın adresi + `.md` | `/llms.txt` | Spesifikasyon yer belirlemez; bizde `/okf/` |
| Asıl okuyucu | Arama motorları | Ajanlar, sohbet asistanları | Ajanlar | Ajanlar, katalog araçları |
| Ek bilgi | Varlık türleri ve ilişkileri | Yok | Kısa açıklamalar | `type`, kaynak, güven, güncellik, kavram grafiği |

**Schema.org ve JSON-LD.** Schema.org, web sayfalarında ve ötesinde yapılandırılmış veri şemaları oluşturan ortak bir topluluk çalışmasıdır; sözlüğü RDFa, Microdata ve JSON-LD ile kullanılabilir 10 . Google, yapılandırılmış veri için mümkünse JSON-LD'yi öneriyor 9 . Bu katman sayfanın içinde kalır ve arama motorunun sayfayı anlamasına hizmet eder. OKF bunun yerini almaz.

**Markdown ikizi.** Sayfanın tasarımsız metin sürümüdür. llms.txt önerisi bu sürümlerin sayfayla aynı adreste `.md` uzantısıyla sunulmasını öneriyor 6 . OKF kavramı, başlık bloğu eklenmiş bir Markdown ikizidir. Bu yüzden ikizleri olan bir site OKF'e en yakın sitedir.

**llms.txt.** Ajanların siteyi kullanması için kökte duran bir Markdown dosyası; kısa bir giriş ve ayrıntılı Markdown dosyalarına bağlantılar içerir 6 . llms.txt kendini bir öneri olarak tanımlıyor; 2. sürümü Ağustos 2026'da yayımlandı 7 . OKF'in kök index.md'si llms.txt'ye benzer bir iş görür, ama her klasörde tekrarlanır ve her girdinin arkasında tipli bir kavram vardır.

Sıralama önerimiz: önce schema.org ve sayfa içeriği, sonra Markdown ikizleri ve llms.txt, en son OKF. Her katman bir öncekinin üzerine kurulur.

## OKF nasıl doğrulanır?

OKF'in uyumluluk kuralı kısadır. Bir paket şu üç koşulu sağlıyorsa 0.2 ile uyumludur 1 :

1. Ayrılmış adlar dışındaki her `.md` dosyası ayrıştırılabilir bir YAML başlık bloğu içerir.
2. Her başlık bloğunda boş olmayan bir `type` alanı vardır.
3. `index.md` ve `log.md` varsa 8. ve 9. bölümdeki yapıya uyar.

Tüketiciler esnek olmak zorundadır: eksik isteğe bağlı alanlar, bilinmeyen `type` değerleri, bilinmeyen anahtarlar, kırık bağlantılar ve eksik index.md dosyaları yüzünden bir paket reddedilemez 1 . Bu esneklik üreticiye bir hata payı tanımaz; hatalar sessizce kalır. Biz bu yüzden şunları ayrıca kontrol ediyoruz:

| Kontrol | Neden |
| --- | --- |
| Her adres 200 ve `text/markdown` dönüyor mu? | Kırık bağlantı geçerli, ama bir ajan için ölü uç |
| Kök dışındaki index.md'lerde başlık bloğu yok mu? | 8. bölüm |
| Kök index.md'nin başlığı tam olarak `okf_version: "0.2"` mi? | 12. bölüm |
| `generated` varsa `by` dolu mu, `at` saat dilimli ISO 8601 mi? | 5. ve 5.2. bölüm |
| Her `sources` girdisinde `resource` var mı? | 5.1. bölüm |
| Her kavram kendi klasörünün index.md'sinde listeleniyor mu? | Kademeli açılım; spesifikasyon zorunlu tutmuyor |

Bu kontrolleri, `/okf/index.md`'den başlayıp her bağlantıyı izleyen küçük bir Python betiğiyle yapıyoruz. YAML'ı ayrıştırmak için herhangi bir YAML 1.2 ayrıştırıcısı yeter 13 . Paketi görsel olarak denetlemek için OKF deposundaki referans görselleştirici de kullanılabilir: yerel bir paket klasöründen tek dosyalık etkileşimli bir grafik üretir 2 . Kopuk kavramlar ve yanlış türler grafikte hemen görünür.

## Sık yapılan hatalar

- **Bir kavrama `index.md` adını vermek.** En sık rastlanan tuzak bu: web sitelerinde ana sayfanın Markdown sürümü genellikle `/index.md`'dir, ama OKF'te bu ad klasör dizinine ayrılmış 6 1 . Biz ana sayfaları pakette `home.md` olarak yayımlıyoruz.
- **Alt klasör index.md'lerine başlık bloğu koymak.** Başlık bloğu yalnızca kök index.md'de ve yalnızca `okf_version` için serbest 1 .
- **Yalnızca tarih yazmak.** `stale_after: 2026-12-31` geçersiz; `2026-12-31T00:00:00Z` geçerli 1 .
- **Kaynakları gövdede bırakmak.** 0.1'deki `# Citations` gövde listesinin yerini 0.2'de `sources` aldı 1 .
- **Doğrulanmamış içeriğe `verified` yazmak.** Güven sınıfı bu alandan türetiliyor; gerçek bir doğrulama olayı ve tarihi yoksa alanı hiç yazmayın 1 .
- **Aynı türü iki farklı yazmak.** "WebPage" ve "Web Page" bir tüketici için iki ayrı türdür. Kendi denetimimizde bu hatayı bir sayfada bulup düzelttik.
- **Sitenin bir kısmını unutmak.** Pakete yalnızca CMS kayıtlarını alıp koddan üretilen sayfaları atlamak kolaydır. Denetimimizde ücretsiz araçlarımızın ve marka kitimizin pakette olmadığını, bu sayfalara giden bağlantıların da başlık bloklarından düştüğünü bulduk.
- **Taslakları ve noindex sayfaları pakete almak.** Paket, HTML'de yayımlanmayan bir bilgiyi yayımlamamalı.
- **OKF'i bir sıralama sihri olarak satmak.** Google yapay zekâ özellikleri için ek dosya gerekmediğini açıkça yazıyor 8 . OKF'i görünürlük vaadiyle satan bir teklife şüpheyle yaklaşın.

## Vaka: roicool.com'un OKF uygulaması

roicool.com'u yeniden kurarken her sayfa için bir Markdown ikizi zaten planlıyorduk. OKF 0.2 yayımlandığında karar basitti: ikizlere başlık bloğu ve klasör dizinleri ekleyip siteyi geçerli bir OKF paketi olarak da yayımlamak. Ayrı bir içerik yazılmadı; paket her istekte CMS'teki yayımlanmış içerikten üretiliyor.

**Ne yayımlıyoruz?**

| Adres | İçerik |
| --- | --- |
| `/okf/index.md` | Türkçe kök dizin, `okf_version: "0.2"` |
| `/okf/en/index.md` | İngilizce dizin |
| `/okf/<klasör>/index.md` | Her klasörün dizini, site haritasındaki yayımlanmış sayfalardan |
| `/okf/<sayfa>.md` | Her sayfanın ikizi, kavram olarak |
| `/okf/home.md`, `/okf/en/home.md` | Ana sayfalar (index.md ayrılmış ad) |

**Hangi türleri kullanıyoruz?** CMS koleksiyonları türlere eşleniyor: Home Page, Service, Sector, Case Study, Project, Blog Post, Blog Category, Person, Glossary Term, Comparison, E-book, Podcast Episode, Job Posting, Press Mention, Partnership, Legal Page, Pricing Page, Collection Page (liste sayfaları) ve Tool (ücretsiz araçlar). Sitenin içinde her tür tek bir yazımla geçiyor.

**Ajanlar paketi nasıl buluyor?** Spesifikasyon keşif tanımlamadığı için üç yerde işaret bırakıyoruz. Her sayfanın `<head>`'inde `<link rel="index" type="text/markdown" href="/okf/index.md">` var; `index`, IANA bağlantı ilişkileri kaydında tanımlı bir ilişki 15 . llms.txt'nin isteğe bağlı bölümünde paketin dizinine bir satır var. robots.txt'de `/okf/` için açık bir izin ve dizin adresi yer alıyor. Sayfaların Markdown sürümleri ayrıca `rel="alternate" type="text/markdown"` ile işaretli 6 .

**Bilerek yazmadığımız alanlar.** `verified` yazmıyoruz, çünkü CMS bir inceleme tarihi tutmuyor ve güven sınıfı bu alandan türetiliyor 1 . `stale_after` ve `log.md` de yok: içerik her istekte yayımlanmış sürümden üretildiği için ikisi de şimdilik bilgi eklemiyor.

**Denetimden çıkanlar (19 Ekim 2026).** Paketi spesifikasyonun güncel sürümüne karşı yeniden denetledik. Format uyumluydu. İki hata bulup düzelttik: koddan üretilen sayfalar (araçlar, marka kiti) pakette yoktu ve bu sayfalara giden bağlantılar başlık bloklarından düşüyordu; bir sayfa da türünü diğerlerinden farklı yazıyordu. Blog yazılarına `sources` alanını ekledik ve doğrulama betiğine zaman damgası ile kaynak kontrollerini koyduk. Sıradaki adımlar arasında llms.txt 2. sürümünün `describedby` önerisi 7 ve paketin dışa aktarılabilir bir arşivi var.

Markanızın yapay zekâ cevaplarındaki yerini görmek isterseniz [AI görünürlük analizi](https://www.roicool.com/hizmetler/ai-gorunurluk-analizi) dört platformda temel çizgiyi çıkarır. Sayfalarınızın yapay zekâ tarafından alıntılanabilir biçimde yazılması için [GEO uyumlu içerik](https://www.roicool.com/hizmetler/geo-uyumlu-icerik), teknik katmanı da içeren sürekli çalışma için [GEO ajansı](https://www.roicool.com/hizmetler/geo-ajansi) sayfamıza bakabilirsiniz.

## Kaynaklar

1. [GoogleCloudPlatform, Open Knowledge Format (OKF) v0.2, SPEC.md](https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md), 2026
2. [GoogleCloudPlatform, open-knowledge-format deposu (README)](https://github.com/GoogleCloudPlatform/open-knowledge-format), 2026
3. [Google Cloud Blog, Introducing the Open Knowledge Format (12 Haziran 2026)](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing), 2026
4. [GoogleCloudPlatform, knowledge-catalog: okf klasörü (dondurulmuş 0.1 kopyası)](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf), 2026
5. [Andrej Karpathy, LLM Wiki (GitHub Gist)](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f), 2026
6. [llmstxt.org, The /llms.txt file, v2 (öneri)](https://llmstxt.org/), 2026
7. [llmstxt.org, Changes: v2 (Ağustos 2026)](https://llmstxt.org/changes.html), 2026
8. [Google Search Central, AI features and your website](https://developers.google.com/search/docs/appearance/ai-features), 2026
9. [Google Search Central, Introduction to structured data markup in Google Search](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data), 2026
10. [Schema.org](https://schema.org/), 2026
11. [IETF, RFC 8288: Web Linking](https://www.rfc-editor.org/rfc/rfc8288), 2017
12. [IETF, RFC 7763: The text/markdown Media Type](https://www.rfc-editor.org/rfc/rfc7763), 2016
13. [YAML Ain't Markup Language, revision 1.2.2](https://yaml.org/spec/1.2.2/), 2021
14. [Batuhan Durmaz, OKF Nedir? SEO ve Yapay Zekâ Görünürlüğü İçin Önemi (14 Temmuz 2026)](https://www.batuhandurmaz.com/okf/), 2026
15. [IANA, Link Relations registry](https://www.iana.org/assignments/link-relations/), 2026

## SSS

### OKF, Google'da ya da yapay zekâ cevaplarında sıralama faktörü mü?

Hayır. OKF, bilgi kataloglarındaki bilgiyi Markdown ve YAML ile taşımak için yazılmış açık bir formattır; arama motorları için bir sinyal olarak tanımlanmadı. Google, AI Overviews ve AI Mode'da görünmek için yeni makine okunur dosyalar ya da yapay zekâ metin dosyaları gerekmediğini yazıyor. Ekim 2026 itibarıyla web sitelerindeki OKF paketlerini okuduğunu belgeleyen bir yapay zekâ arama motoruna rastlamadık.

### OKF, llms.txt'nin yerini alır mı?

Hayır, ikisi farklı işler yapar. llms.txt, sitenin kökünde ajanlara kısa bir giriş ve bağlantı listesi sunan bir öneridir. OKF ise her bilgi biriminin tipli bir Markdown dosyası olduğu, klasör dizinleriyle gezilen bir paket tanımlar. İkisi birlikte kullanılabilir: llms.txt'den OKF paketinin dizinine bağlantı vermek, ajanın paketi bulmasını kolaylaştırır.

### Schema.org işaretlemesi varken OKF'e gerek var mı?

Schema.org işaretlemesi HTML sayfasının içinde durur ve arama motorlarına sayfanın ne olduğunu anlatır; Google bunu belgeliyor ve kullanıyor. OKF sayfadan bağımsız bir Markdown paketidir ve ajanların okuyup gezebileceği bilgiyi taşır. Biri diğerinin yerini almaz. Önce schema.org ve içerik, sonra Markdown sürümler, en son OKF sırası çoğu site için doğrudur.

### Küçük bir şirket sitesi OKF yayınlamalı mı?

Siteniz zaten sayfalarının Markdown sürümlerini üretiyorsa, bunlara YAML başlığı ve klasör dizinleri eklemek ucuzdur ve paketi geçerli bir OKF paketine çevirir. Sıfırdan ayrı bir OKF içeriği yazmak ise bugün görünürlük getirmez; o emeği önce sayfa içeriğine, schema.org işaretlemesine ve üçüncü taraf kaynaklara harcayın.

### OKF paketini robots.txt'de engellemeli miyim?

Paketin içindeki bilgi zaten HTML sayfalarınızda herkese açıksa engellemenin bir faydası yoktur. Paket yalnızca yayımlanmış ve dizine eklenebilir sayfaları içermeli; taslaklar, noindex sayfalar ve iç notlar pakete girmemeli. robots.txt bir güvenlik önlemi değildir, gizli kalması gereken bilgi pakete hiç konmamalıdır.

### OKF'in hangi sürümü güncel ve lisansı ne?

Ekim 2026 itibarıyla güncel sürüm 0.2'dir. Spesifikasyon GoogleCloudPlatform/open-knowledge-format deposunda Apache 2.0 lisansıyla yayımlanıyor. Haziran 2026'da duyurulan 0.1 sürümünün knowledge-catalog deposundaki kopyası artık güncellenmiyor.

Sayfa yolu: [Ana sayfa](https://www.roicool.com) › [Blog](https://www.roicool.com/blog) › [Yapay zekâ](https://www.roicool.com/blog/kategori/geo) › OKF (Open Knowledge Format) nedir? Yapı, uygulama ve GEO için anlamı

İlgili sayfalar:

- [Google AI Mode nedir? AI Overviews'tan farkı ve markalara etkisi](https://www.roicool.com/blog/google-ai-mode-nedir)
- [ChatGPT markaları nasıl seçer? Önerilerin arkasındaki kaynaklar](https://www.roicool.com/blog/chatgpt-markalari-nasil-secer)
- [AI görünürlüğü nasıl ölçülür? Yapay zekâ cevaplarında marka takibi](https://www.roicool.com/blog/ai-gorunurlugu-nasil-olculur)

Kaynak: https://www.roicool.com/blog/okf-nedir · Son güncelleme: 2026-10-20