katman-mcp 0.1.0

package/dist/tools/method/data/anatomy.js

@@ -0,0 +1,141 @@
+export const ANATOMY_INTRO = {
+    en: "A page is written for two readers at once: Google and the assistant. The invoice example below is invented; its structure is the same as the sample site's situation pages. Blocks tagged SEO are for the search engine, GEO blocks are for the assistant to quote you. Most serve both.",
+    tr: "Bir sayfa iki okuyucuya birden yazılır: Google’a ve asistana. Aşağıdaki fatura örneği uydurmadır; yapı, örnek sitenin durum sayfalarıyla aynı. SEO etiketli bloklar arama motoru için, GEO etiketliler asistanın sizi alıntılaması için. Çoğu ikisine birden yarıyor.",
+};
+export const ANATOMY = [
+    {
+        n: 1,
+        tags: ["SEO", "GEO"],
+        name: { en: "<title> · meta description · canonical · og:image", tr: "<title> · meta description · canonical · og:image" },
+        example: { en: "yoursite.com/import-pdf-invoices", tr: "siteniz.com/faturami-muhasebeye-aktar" },
+        rule: {
+            en: "Title: the situation first, then the brand, about 60 characters. Meta description: the sentence you want the assistant to say; Google mostly builds the snippet from the page text, so the same sentence must also be in block 3.",
+            tr: "Title önce durum, sonra marka, yaklaşık 60 karakter. Meta açıklama asistanın söylemesini istediğiniz cümle; Google snippet’i çoğunlukla sayfa metninden kurar, bu yüzden aynı cümle 3. blokta da olmalı.",
+        },
+    },
+    {
+        n: 2,
+        tags: ["SEO", "GEO"],
+        name: { en: "H1", tr: "H1" },
+        example: { en: "I type my invoices in by hand and it takes hours", tr: "Faturalarımı elle giriyorum, saatlerimi alıyor" },
+        rule: { en: "The H1 is the customer's own sentence. The URL uses the same words.", tr: "H1 müşterinin kendi cümlesi. Adres de aynı kelimelerle." },
+    },
+    {
+        n: 3,
+        tags: ["GEO"],
+        name: { en: "The first 1–3 sentences", tr: "İlk 1–3 cümle" },
+        example: {
+            en: "Upload your invoice. We move the line items into your accounting software in 30 seconds and flag the ones that don't match. Your document is never stored.",
+            tr: "Faturanı yükle. Kalemleri 30 saniyede muhasebe programına aktarırız, eşleşmeyenleri işaretleriz. Belgen saklanmaz.",
+        },
+        rule: {
+            en: "The most important block. The assistant takes a sentence for its answer from here: short, concrete, understandable on its own. ChatGPT repeated the sample site's sentence almost word for word. Keep the key claim within the H1 and the first ~200 characters.",
+            tr: "Sayfanın en önemli bloğu. Asistan cevabına buradan bir cümle alır: kısa, somut, tek başına anlaşılır. Örnek sitenin cümlesini ChatGPT neredeyse kelimesi kelimesine tekrar etti. Asıl iddiayı H1’de ve ilk ~200 karakterde tutun.",
+        },
+    },
+    {
+        n: 4,
+        tags: [],
+        name: { en: "Try it now / one clear action", tr: "Hemen deneme / tek net eylem" },
+        example: { en: "Drop your invoice · try it free", tr: "Faturanı bırak · ücretsiz dene" },
+        rule: {
+            en: "The visitor arrives with the situation they told ChatGPT. On the sample site we put a file drop box on the two pages ChatGPT sent people to; 52 of the first 68 generations in week one used the visitor's own file.",
+            tr: "Ziyaretçi ChatGPT’ye anlattığı durumla gelir. Örnek sitede ChatGPT’nin gönderdiği iki sayfaya dosya kutusu koyduk; ilk haftadaki 68 ilk üretimin 52’si ziyaretçinin kendi dosyasıyla yapıldı.",
+        },
+    },
+    {
+        n: 5,
+        tags: ["GEO"],
+        name: { en: "Proof: number + date", tr: "Kanıt: sayı + tarih" },
+        example: { en: "A verifiable number with its date", tr: "Doğrulanabilir sayı, tarihiyle" },
+        rule: {
+            en: "A verifiable number, with its date. Don't claim more than your proof: the assistant repeats it and a competitor refutes it.",
+            tr: "Doğrulanabilir sayı, tarihiyle. Kanıtından büyük iddia yazmayın; asistan tekrar eder, rakip çürütür.",
+        },
+    },
+    {
+        n: 6,
+        tags: ["SEO", "GEO"],
+        name: { en: "How it works: 3–5 steps", tr: "Nasıl çalışır: 3–5 adım" },
+        example: { en: "3–5 plain-text steps", tr: "3–5 düz metin adım" },
+        rule: {
+            en: "Plain HTML text; a demo drawn with JavaScript is an empty page to a bot.",
+            tr: "Düz HTML metin; JavaScript ile çizilen bir demo bot için boş sayfadır.",
+        },
+    },
+    {
+        n: 7,
+        tags: ["GEO"],
+        name: { en: "Who it's not for", tr: "Kimler için değil" },
+        example: { en: "2–3 bullets", tr: "2–3 madde" },
+        rule: {
+            en: "Saying who it's not for and naming competitors honestly builds trust; assistants quote one-sided pages less.",
+            tr: "“Kime uygun değil” ve rakipleri dürüstçe saymak güven verir; asistan tek taraflı sayfayı daha az alıntılar.",
+        },
+    },
+    {
+        n: 8,
+        tags: ["GEO"],
+        name: { en: "Alternatives, honestly", tr: "Alternatifler, dürüstçe" },
+        example: { en: "Competitor: who it fits", tr: "Rakip: kime uygun" },
+        rule: {
+            en: "Name the alternatives and say whom each one fits; take competitor facts only from their own pages, with a date.",
+            tr: "Alternatifleri sayın, hangisinin kime uygun olduğunu yazın; rakip bilgisini yalnızca kendi sayfasından, tarihiyle alın.",
+        },
+    },
+    {
+        n: 9,
+        tags: ["GEO"],
+        name: { en: "FAQ: 5–8 questions", tr: "SSS: 5–8 soru" },
+        example: { en: "Questions in the customer's words", tr: "Müşterinin ağzından sorular" },
+        rule: {
+            en: "Questions in the customer's words, answers whose first sentence is the answer. Google no longer shows an FAQ rich result; this block is for the assistant.",
+            tr: "Müşterinin ağzından sorular, ilk cümlesi cevap olan yanıtlar. Google’da SSS zengin sonucu yok; bu blok asistan için.",
+        },
+    },
+    {
+        n: 10,
+        tags: ["SEO"],
+        name: { en: "Related pages", tr: "İlgili sayfalar" },
+        example: { en: "3–5 text links", tr: "3–5 metinli link" },
+        rule: {
+            en: "Internal links with descriptive text; every page gets a link from somewhere.",
+            tr: "Metinli iç linkler; her sayfa en az bir yerden link alsın.",
+        },
+    },
+    {
+        n: 11,
+        tags: ["SEO", "GEO"],
+        name: { en: "Updated date · author · JSON-LD", tr: "Güncellendi · yazar · JSON-LD" },
+        example: { en: "Updated: 29 Sep 2026 · Author · JSON-LD", tr: "Güncellendi: 29.09.2026 · Yazar · JSON-LD" },
+        rule: {
+            en: "A real update date (changed only when the text changes), the author, valid JSON-LD. In the sample site's first version all 85 pages carried the launch date; we fixed it.",
+            tr: "Gerçek güncelleme tarihi (yalnızca metin değişince), yazar, geçerli JSON-LD. Örnek sitede ilk sürümde 85 sayfanın hepsi yayın tarihini taşıyordu; düzelttik.",
+        },
+    },
+];
+/** The page brief the book tells you to start P6 with. */
+export const PAGE_BRIEF_TEMPLATE = {
+    en: `Situation: [the customer's sentence]
+URL: /[words]                               Title: [situation] — [brand]
+First sentence: [brings] → [we do] → [they get]. [fear is unnecessary].
+Action: [file drop / trial / pricing]
+Proof: [number, source, date]
+Not for: [2–3 bullets]
+Alternatives: [competitor: who it fits]
+FAQ: [5–8 questions, in the customer's words]
+Related pages: [3–5 URLs]`,
+    tr: `Durum: [müşterinin cümlesi]
+Adres: /[kelimeler]                               Title: [durum] — [marka]
+İlk cümle: [getirir] → [yaparız] → [eline geçer]. [korku gereksiz].
+Eylem: [dosya kutusu / deneme / fiyat]
+Kanıt: [sayı, kaynak, tarih]
+Kimler için değil: [2-3 madde]
+Alternatifler: [rakip: kime uygun]
+SSS: [5-8 soru, müşterinin ağzından]
+İlgili sayfalar: [3-5 adres]`,
+};
+export const ANATOMY_EXERCISE = {
+    en: "Write your own four-part sentence (brings → we do → gets → fear is unnecessary). Put the same sentence in three places: the first paragraph of your most important page, that page's meta description, and llms.txt.",
+    tr: "Kendi dört parçalı cümlenizi yazın (getirir → yaparız → eline geçer → korku gereksiz). Aynı cümleyi üç yere koyun: en önemli sayfanın ilk paragrafı, o sayfanın meta açıklaması, llms.txt.",
+};

package/dist/tools/method/data/appendices.js

@@ -0,0 +1,202 @@
+/** Appendix A — the sample robots.txt (katman_generate builds the project-specific version). */
+export const APPENDIX_A_ROBOTS = {
+    en: `# Open to search engines, AI assistants and crawlers.
+# Content signals: search=yes, ai-input=yes, ai-train=yes
+# (Written as a comment: as a rule line, Lighthouse reported "robots.txt is not valid".)
+
+User-agent: *
+Allow: /
+Disallow: /app/
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: OAI-SearchBot
+Allow: /
+Disallow: /app/
+Disallow: /admin/
+Disallow: /api/
+
+# The same group is repeated for: ChatGPT-User, GPTBot, Claude-SearchBot,
+# Claude-User, ClaudeBot, PerplexityBot, Perplexity-User, Google-Extended,
+# Applebot, Applebot-Extended, Bingbot, DuckAssistBot, Meta-ExternalAgent, Amazonbot
+
+Sitemap: https://yourdomain.com/sitemap.xml
+# For assistants: https://yourdomain.com/llms.txt`,
+    tr: `# Arama motorlarına, yapay zekâ asistanlarına ve tarayıcılara açığız.
+# Content signals: search=yes, ai-input=yes, ai-train=yes
+# (Yorum olarak yazıldı: kural olarak yazılınca Lighthouse "robots.txt geçersiz" dedi.)
+
+User-agent: *
+Allow: /
+Disallow: /app/
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: OAI-SearchBot
+Allow: /
+Disallow: /app/
+Disallow: /admin/
+Disallow: /api/
+
+# Aynı grup şunlar için de tekrarlanır: ChatGPT-User, GPTBot, Claude-SearchBot,
+# Claude-User, ClaudeBot, PerplexityBot, Perplexity-User, Google-Extended,
+# Applebot, Applebot-Extended, Bingbot, DuckAssistBot, Meta-ExternalAgent, Amazonbot
+
+Sitemap: https://alanadiniz.com/sitemap.xml
+# Asistanlar için: https://alanadiniz.com/llms.txt`,
+};
+export const APPENDIX_A_NOTE = {
+    en: "A bot that has a group with its own name doesn't read the * group, so repeat the closed paths in every group. Don't write bare prefixes: Disallow: /t closes both /tr and /tools; write /t/. Have your coding tool generate this file with P4.",
+    tr: "Bir bot için adıyla yazılmış grup varsa o bot * grubunu okumaz; bu yüzden kapalı yolları her grupta tekrar yazın. Çıplak önek yazmayın: Disallow: /t hem /tr’yi hem /tools’u kapatır, /t/ yazın. Kod aracınıza bu dosyayı P4 ile ürettirin.",
+};
+/** Appendix B — llms.txt skeleton. */
+export const APPENDIX_B_LLMS = {
+    en: `# [Brand] [category word]
+
+> [Brand] is a [product type] that turns [input] into [output]. [The most important difference, one sentence].
+> Operated by [company name] ([country]).
+
+Key facts: [pricing model, lowest price, trial], [cancellation], [usage limits].
+Not to be confused with: [Brand] is not [similarly named product]; it is not a [big company] product.
+Limits of the evidence: [the test behind the claim and its size, stated plainly].
+
+## Product
+- [Home](https://yourdomain.com/): what it is
+- [Pricing](https://yourdomain.com/pricing): plans
+- [Situation page](https://yourdomain.com/...): [the four-part sentence]
+
+## Guides
+## Comparisons
+## Optional
+- [Terms](...), [Privacy](...)`,
+    tr: `# [Marka] [kategori kelimesi]
+
+> [Marka], [girdi]yi [çıktı]ya dönüştüren bir [ürün tipi]. [En önemli fark, tek cümle].
+> [Şirket adı] tarafından işletilir ([ülke]).
+
+Temel bilgiler: [fiyat modeli, en düşük fiyat, deneme], [iptal], [kullanım sınırları].
+Karıştırılmasın: [Marka], [benzer adlı ürün] değildir; [büyük şirket]in ürünü değildir.
+Kanıtın sınırı: [iddianın dayandığı test ve büyüklüğü, açıkça].
+
+## Ürün
+- [Ana sayfa](https://alanadiniz.com/): ne olduğu
+- [Fiyatlar](https://alanadiniz.com/fiyatlandirma): planlar
+- [Durum sayfası](https://alanadiniz.com/...): [dört parçalı cümle]
+
+## Rehberler
+## Karşılaştırmalar
+## Optional
+- [Şartlar](...), [Gizlilik](...)`,
+};
+export const APPENDIX_B_NOTE = {
+    en: "Keep it short: the sample site's llms.txt grew to 65 KB and is being trimmed. Every figure should come from the same source as the pages.",
+    tr: "Kısa tutun: örnek sitenin llms.txt’si 65 KB’a çıktı, inceltilecek. Her rakam sayfalarla aynı kaynaktan gelsin.",
+};
+/** Appendix C — Organization JSON-LD with the not-X note. */
+export const APPENDIX_C_ORG = `{
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  "@id": "https://yourdomain.com/#org",
+  "name": "[Brand] [Category]",
+  "alternateName": ["[Brand]"],
+  "disambiguatingDescription": "A [category] product. Not [similarly named product]; not a [big company] product.",
+  "url": "https://yourdomain.com",
+  "logo": "https://yourdomain.com/img/logo-512.png",
+  "sameAs": ["https://www.youtube.com/@[channel]", "https://www.instagram.com/[account]"],
+  "address": { "@type": "PostalAddress", "addressCountry": "TR" }
+}`;
+export const APPENDIX_C_NOTE = {
+    en: "On every page also WebSite, BreadcrumbList and, by page type, Article (datePublished, dateModified, author), FAQPage (the real questions and answers on the page), VideoObject (if a video is embedded). Everything in the schema must also be visible on the page.",
+    tr: "Her sayfada ayrıca WebSite, BreadcrumbList ve sayfa tipine göre Article (datePublished, dateModified, author), FAQPage (sayfadaki gerçek soru-cevaplar), VideoObject (gömülü video varsa). Schema’daki her bilgi sayfada da görünmeli.",
+};
+/** Appendix D — content rules (+ the 2026 additions). */
+export const CONTENT_RULES = [
+    { en: "The first 1–3 sentences answer the question and can be quoted on their own.", tr: "İlk 1–3 cümle soruyu cevaplar ve tek başına alıntılanabilir." },
+    { en: "Every claim's proof is on the page; if the proof is small, say it's small.", tr: "Her iddianın kanıtı sayfada; kanıt küçükse küçük olduğunu yazın." },
+    { en: "About competitors, write only what their own pages say, with the date.", tr: "Rakipler hakkında yalnızca kendi sayfalarında yazanı, tarihiyle yazın." },
+    { en: "Prices and features come from one source; no two pages contradict each other.", tr: "Fiyat ve özellik tek kaynaktan; iki sayfa birbiriyle çelişmesin." },
+    { en: "Don't call a paid product “free”; don't write headlines that imply another brand's endorsement.", tr: "Ücretli ürüne “ücretsiz” demeyin; başka markanın onayını ima eden başlık yazmayın." },
+    {
+        en: "Let AI write the draft, but don't publish until it passes a rule script (no made-up numbers, no “best / perfect”, no real people's names) and a human read. katman_lint_content is that rule script.",
+        tr: "Taslağı yapay zekâya yazdırın, ama bir kural betiğinden (uydurma sayı, “en iyi / mükemmel”, gerçek kişi adı yok) ve bir insan okumasından geçmeden yayınlamayın. katman_lint_content bu kural betiğidir.",
+    },
+    {
+        en: "Question sources: Google autocomplete (seed keyword + letter by letter), situation sentences people really ask the assistant, the pages the assistant sends people to in your analytics.",
+        tr: "Soru kaynağı: Google’ın otomatik tamamlaması (tohum kelime + harf harf), asistana gerçekten sorulan durum cümleleri, analitikte asistanın indirdiği sayfalar.",
+    },
+    {
+        en: "Watch the page mix: Perplexity took the sample site for a “template and education site” because it had ~110 template pages against 10 product pages. The mix of your pages decides what the assistant thinks you are.",
+        tr: "Sayfa karışımına dikkat: Perplexity örnek sitemizi “şablon ve eğitim sitesi” sandı, çünkü yaklaşık 110 şablon sayfasına karşı 10 ürün sayfası vardı. Sayfalarınızın dağılımı asistanın sizi ne sandığını belirler.",
+    },
+    {
+        en: "On a new domain, 5–10 pages a week. Don't grow a template whose “crawled – not indexed” rate passes 30%.",
+        tr: "Yeni alan adında haftada 5–10 sayfa. “Tarandı, dizine eklenmedi” oranı %30’u geçen şablonu büyütmeyin.",
+    },
+    {
+        en: "Put the key claim in the H1 and the first ~200 characters. Don't keyword-stuff: keyword-heavy titles and URLs get cited less.",
+        tr: "Asıl iddiayı H1’e ve ilk ~200 karaktere koyun. Anahtar kelime doldurmayın: anahtar kelime yüklü başlıklar ve adresler daha az alıntılanıyor.",
+    },
+    {
+        en: "Never show bots different content than people (cloaking), never hide instructions for AI in the page (prompt injection): Google's spam policy covers both since May 2026.",
+        tr: "Botlara insanlardan farklı içerik göstermeyin (cloaking), sayfaya yapay zekâ için gizli talimat koymayın (prompt enjeksiyonu): Google’ın spam politikası Mayıs 2026’dan beri ikisini de kapsıyor.",
+    },
+    {
+        en: "Real freshness only: update the facts and show the date; faking dates is manipulation.",
+        tr: "Yalnızca gerçek tazelik: bilgiyi güncelleyin, tarihi gösterin; tarih uydurmak manipülasyondur.",
+    },
+];
+/** Appendix E — the full site audit checklist (what the crawl script checks). */
+export const SITE_AUDIT_CHECKLIST = {
+    perUrl: [
+        { en: "Status 200 (no redirect), content-type text/html", tr: "Durum 200 (yönlendirme yok), content-type text/html" },
+        { en: "No noindex in meta robots or X-Robots-Tag (special pages should have it)", tr: "meta robots’ta ve X-Robots-Tag’de noindex yok (özel sayfalarda olmalı)" },
+        { en: "<title> present, unique, not longer than 60–65 characters", tr: "<title> var, benzersiz, 60–65 karakteri geçmiyor" },
+        { en: "Meta description present, unique, 70–160 characters", tr: "Meta açıklama var, benzersiz, 70–160 karakter" },
+        { en: "One H1, no heading level skips (h1 → h2 → h3)", tr: "Tek H1, başlık seviyesi atlaması yok (h1 → h2 → h3)" },
+        { en: "One absolute, self-referencing canonical", tr: "Tek, mutlak, kendini gösteren canonical" },
+        { en: "Reciprocal hreflang pairs, an x-default, a correct <html lang>", tr: "hreflang çiftleri karşılıklı, x-default var, <html lang> doğru" },
+        { en: "JSON-LD parses; the expected types are there", tr: "JSON-LD ayrıştırılabiliyor, beklenen tipler var" },
+        { en: "og:title, og:description, og:image (with width, height, alt), og:url, og:locale, twitter:card", tr: "og:title, og:description, og:image (width, height, alt ile), og:url, og:locale, twitter:card" },
+        { en: "Every <img> has alt, width and height; lazy below the fold; a modern format", tr: "Bütün <img>’lerde alt, width ve height; ekranın altındaysa lazy; modern format" },
+        { en: "No http:// resources (mixed content)", tr: "http:// kaynak yok (karışık içerik)" },
+        { en: "URL: lowercase, hyphens, ASCII, short, no trailing /", tr: "URL: küçük harf, tire, ASCII, kısa, sonda / yok" },
+        { en: "At least 3 internal links point to the page (no orphans)", tr: "Sayfaya gelen iç link en az 3 (yetim yok)" },
+        { en: "Every internal and external link on the page is 200 or a deliberate redirect", tr: "Sayfadaki bütün iç ve dış linkler 200 ya da bilinçli yönlendirme" },
+        { en: "Content is visible with JavaScript off (a sensible word count)", tr: "JavaScript kapalıyken içerik görünüyor (kelime sayısı makul)" },
+    ],
+    siteWide: [
+        { en: "http → https 301, www → bare domain 301, HSTS", tr: "http → https 301, www → yalın alan adı 301, HSTS" },
+        { en: "HTML, CSS and JS compressed (Content-Encoding: br or gzip)", tr: "HTML, CSS ve JS sıkıştırılmış (Content-Encoding: br ya da gzip)" },
+        { en: "Long caching and versioning for static files", tr: "Statik dosyalarda uzun önbellek ve sürümleme" },
+        { en: "robots.txt valid, with a sitemap line", tr: "robots.txt geçerli, sitemap satırı var" },
+        { en: "A missing page returns a real 404", tr: "Olmayan sayfa gerçek 404" },
+        { en: "Lighthouse mobile, 5 pages: performance ≥ 90, the others 100", tr: "Lighthouse mobil, 5 sayfa: performans ≥ 90, diğerleri 100" },
+        { en: "Search Console and Bing Webmaster verified, sitemap submitted, IndexNow working", tr: "Search Console ve Bing Webmaster doğrulandı, sitemap gönderildi, IndexNow çalışıyor" },
+        { en: "AI bots get 200 through the CDN (ch. 6)", tr: "CDN’de yapay zekâ botları 200 alıyor (06. bölüm)" },
+    ],
+};
+/** Appendix F — glossary. Terms as used in English by Katman. */
+export const GLOSSARY = [
+    { term: { en: "GEO", tr: "GEO" }, def: { en: "Generative engine optimisation: visibility in generative engines (assistants).", tr: "Üretken motorlarda (asistanlarda) görünürlük optimizasyonu." } },
+    { term: { en: "AEO", tr: "AEO" }, def: { en: "Answer engine optimisation: quotable answers for direct-answer boxes and AI Overviews.", tr: "Cevap motoru optimizasyonu; doğrudan cevap kutuları ve AI Overviews için alıntılanabilir cevap." } },
+    { term: { en: "Read / Quote / Fit", tr: "Okunmak / Alıntılanmak / Soruya uymak" }, def: { en: "The three gates every public page must pass: bots can read it, the assistant can quote its first sentences, and it fits the situation the customer describes.", tr: "Her herkese açık sayfanın geçmesi gereken üç kapı: botlar okuyabilir, asistan ilk cümlelerini alıntılayabilir, sayfa müşterinin anlattığı duruma uyar." } },
+    { term: { en: "Situation page", tr: "Durum sayfası" }, def: { en: "A page written for one concrete situation a user describes to the assistant, answering in the first sentence.", tr: "Kullanıcının asistana anlattığı somut bir duruma yazılmış, ilk cümlede cevap veren sayfa." } },
+    { term: { en: "The one sentence", tr: "Tek cümle" }, def: { en: "The brand's four-part description (brings → we do → gets → fear is unnecessary), word for word the same on the page, in the meta description and in llms.txt.", tr: "Markanın dört parçalı tanımı (getirir → yaparız → eline geçer → korku gereksiz); sayfada, meta açıklamada ve llms.txt’de kelimesi kelimesine aynı." } },
+    { term: { en: "Not-X note", tr: "“X değildir” notu" }, def: { en: "A plain statement of what the brand is not confused with (llms.txt, About, FAQ, Organization disambiguatingDescription).", tr: "Markanın neyle karıştırılmaması gerektiğini açıkça söyleyen cümle (llms.txt, Hakkımızda, SSS, Organization disambiguatingDescription)." } },
+    { term: { en: "Question set", tr: "Soru seti" }, def: { en: "12 unbranded questions + 2 diagnostic ones, asked the same way every 14 days.", tr: "12 markasız soru + 2 teşhis sorusu; 14 günde bir aynı şekilde sorulur." } },
+    { term: { en: "OAI-SearchBot", tr: "OAI-SearchBot" }, def: { en: "The bot that fills ChatGPT's search index (doesn't run JavaScript).", tr: "ChatGPT’nin arama dizinini dolduran bot (JavaScript çalıştırmaz)." } },
+    { term: { en: "GPTBot", tr: "GPTBot" }, def: { en: "OpenAI's training-data bot.", tr: "OpenAI’ın eğitim verisi botu." } },
+    { term: { en: "ChatGPT-User, Claude-User", tr: "ChatGPT-User, Claude-User" }, def: { en: "Agents that open a page on the user's behalf during a chat.", tr: "Sohbet sırasında kullanıcı adına sayfa açan ajan." } },
+    { term: { en: "ClaudeBot, Claude-SearchBot", tr: "ClaudeBot, Claude-SearchBot" }, def: { en: "Anthropic's training bot and search bot.", tr: "Anthropic’in eğitim botu ve arama botu." } },
+    { term: { en: "llms.txt", tr: "llms.txt" }, def: { en: "A short Markdown summary of the site for language models (llmstxt.org).", tr: "Sitenin dil modelleri için kısa Markdown özeti (llmstxt.org)." } },
+    { term: { en: "IndexNow", tr: "IndexNow" }, def: { en: "A protocol that tells search engines about changed URLs instantly.", tr: "Değişen adresleri arama motorlarına anında bildiren protokol." } },
+    { term: { en: "hreflang", tr: "hreflang" }, def: { en: "The tag linking a page's language and region versions.", tr: "Bir sayfanın dil ve bölge sürümlerini birbirine bağlayan etiket." } },
+    { term: { en: "Canonical", tr: "Canonical" }, def: { en: "The preferred URL of a piece of content.", tr: "Bir içeriğin tercih edilen adresi." } },
+    { term: { en: "lastmod", tr: "lastmod" }, def: { en: "A page's last real change date in the sitemap.", tr: "Sitemap’te sayfanın son gerçek değişiklik tarihi." } },
+    { term: { en: "Entity", tr: "Varlık (entity)" }, def: { en: "What search engines and models recognise as “who/what is this”: name, definition, distinction.", tr: "Arama motorunun ve modellerin “bu kim, ne” diye tanıdığı şey: ad, tanım, ayrım." } },
+    { term: { en: "Human filter", tr: "İnsan filtresi" }, def: { en: "A behaviour rule that separates bots from people in analytics.", tr: "Botları analitikten ayıran davranış kuralı." } },
+    { term: { en: "Facade", tr: "Kapak (facade)" }, def: { en: "An embed that is just an image until clicked, then loads the real player.", tr: "Tıklanana kadar yalnızca resim olan, tıklanınca gerçek oynatıcıyı yükleyen gömme." } },
+    { term: { en: "CWV", tr: "CWV" }, def: { en: "Core Web Vitals: LCP (largest content), CLS (shift), INP (interaction).", tr: "Core Web Vitals: LCP (en büyük içerik), CLS (kayma), INP (etkileşim)." } },
+    { term: { en: "Soft 404", tr: "Sahte 404 (soft 404)" }, def: { en: "A page that says “page not found” but returns a 200 status code.", tr: "“Sayfa yok” diyen ama 200 durum kodu dönen sayfa." } },
+    { term: { en: "Training / search / user bot", tr: "Eğitim / arama / kullanıcı botu" }, def: { en: "Bots that collect pages to train models, fill an assistant's search index, and open pages during a chat (ch. 6).", tr: "Model eğitmek için toplayan, asistanın arama dizinini dolduran ve sohbet sırasında sayfa açan botlar (06. bölüm)." } },
+];

package/dist/tools/method/data/cloudflare.js

@@ -0,0 +1,192 @@
+export const CF_INTRO = {
+    en: "If a CDN such as Cloudflare sits in front of your site, bots pass its rules before they ever reach your robots.txt. robots.txt is a request; the CDN's decision is the door. If a bot gets a 403, whatever robots.txt says no longer matters.",
+    tr: "Sitenizin önünde Cloudflare gibi bir CDN varsa, botlar robots.txt’nize ulaşmadan önce onun kurallarından geçer. robots.txt bir rica; CDN’in kararı kapıdır. Bir bot 403 alırsa robots.txt’de ne yazdığının hiçbir önemi kalmaz.",
+};
+export const BOT_TYPES = [
+    {
+        key: "training",
+        name: { en: "Training", tr: "Eğitim" },
+        what: { en: "Collects pages to train models.", tr: "Model eğitmek için sayfa toplar." },
+        bots: ["GPTBot", "ClaudeBot", "CCBot", "Bytespider"],
+        ifBlocked: {
+            en: "Future models can't learn about you from your site. According to OpenAI, blocking GPTBot doesn't affect ChatGPT search: “each setting is independent of the others”.",
+            tr: "Gelecek modeller sizi sitenizden öğrenemez. OpenAI’a göre GPTBot’u engellemek ChatGPT aramasını etkilemez: “her ayar diğerlerinden bağımsız”.",
+        },
+    },
+    {
+        key: "search",
+        name: { en: "Search", tr: "Arama" },
+        what: {
+            en: "Fills the assistant's search index; the pages shown in an answer are chosen from here.",
+            tr: "Asistanın arama dizinini doldurur; cevapta hangi sayfaların gösterileceği buradan seçilir.",
+        },
+        bots: ["OAI-SearchBot", "Claude-SearchBot", "PerplexityBot"],
+        ifBlocked: {
+            en: "You don't appear in the assistant's search. OpenAI: a site that blocks OAI-SearchBot isn't shown in ChatGPT search answers (it may appear only as a bare link).",
+            tr: "Asistanın aramasında çıkmazsınız. OpenAI: OAI-SearchBot’u engelleyen site ChatGPT arama cevaplarında gösterilmez (yalnızca adres linki olarak çıkabilir).",
+        },
+    },
+    {
+        key: "user",
+        name: { en: "User (agent)", tr: "Kullanıcı (ajan)" },
+        what: {
+            en: "Opens a page during a chat because the user asked for it.",
+            tr: "Sohbet sırasında, kullanıcı istediği için sayfayı açar.",
+        },
+        bots: ["ChatGPT-User", "Claude-User", "Perplexity-User"],
+        ifBlocked: {
+            en: "When a user gives the assistant your link, it can't read your page. OpenAI writes that robots.txt rules may not apply to this bot.",
+            tr: "Kullanıcı linkinizi verdiğinde asistan sayfanızı okuyamaz. OpenAI bu bot için robots.txt kurallarının geçerli olmayabileceğini yazıyor.",
+        },
+    },
+];
+export const PERMISSION_TOKENS_NOTE = {
+    en: "Google-Extended and Applebot-Extended aren't bots but permission names used in robots.txt: they have no crawler of their own (Google and Apple docs), so testing them with a user-agent shows nothing. Googlebot, Bingbot and Applebot are used for both search and training — which is why the Cloudflare change below matters. Note: Google-Extended also controls Gemini grounding; blocking it removes you from Gemini answers (not from Google Search).",
+    tr: "Google-Extended ve Applebot-Extended bot değil, robots.txt’de kullanılan izin adlarıdır: ayrı bir tarayıcıları yok (Google ve Apple belgeleri). Onları user-agent ile test etmek bir şey göstermez. Googlebot, Bingbot ve Applebot ise hem arama hem eğitim için kullanılıyor; aşağıdaki Cloudflare değişikliği bu yüzden önemli. Not: Google-Extended Gemini’nin kaynak göstermesini (grounding) de yönetir; engellerseniz Gemini cevaplarından çıkarsınız (Google aramasından değil).",
+};
+export const CF_SETTINGS = [
+    {
+        name: { en: "Block AI bots (legacy toggle)", tr: "Block AI bots (eski düğme)" },
+        api: "ai_bots_protection",
+        what: {
+            en: "Blocks verified training bots and some unverified bots that look like them. Options: off, on every page, only on pages with ads (ad detection is per domain). Cloudflare marked this toggle for removal on 15 September 2026.",
+            tr: "Doğrulanmış eğitim botlarını ve onlara benzeyen bazı doğrulanmamış botları engeller. Seçenekler: kapalı, her sayfada, yalnızca reklamlı sayfalarda (reklam tespiti alan adı bazında). Cloudflare bu düğmeyi 15 Eylül 2026’da kaldırılacak diye işaretledi.",
+        },
+        recommendation: { en: "Off. Choose the policy settings below deliberately instead.", tr: "Kapalı. Yerine aşağıdaki politika ayarını bilerek seçin." },
+    },
+    {
+        name: { en: "AI bot policies (Training / Search / Agent)", tr: "AI bot politikaları (Eğitim / Arama / Ajan)" },
+        api: "ai_training, ai_search, ai_user",
+        what: {
+            en: "A separate choice per type: block on every page, block on pages with ads, or allow.",
+            tr: "Her tür için ayrı seçim: her sayfada engelle, reklamlı sayfalarda engelle ya da izin ver.",
+        },
+        recommendation: { en: "Search and Agent: allow. Training: your business decision (below).", tr: "Arama ve Ajan: izin ver. Eğitim: iş kararınız (aşağıda)." },
+    },
+    {
+        name: { en: "Managed robots.txt", tr: "Yönetilen robots.txt" },
+        what: {
+            en: "Prepends Cloudflare's block to your own robots.txt: ai-train=no and Disallow: / for GPTBot, ClaudeBot, CCBot, Bytespider, Google-Extended, Applebot-Extended, Amazonbot and meta-externalagent.",
+            tr: "Kendi robots.txt’nizin önüne Cloudflare’in bloğunu ekler: ai-train=no ve GPTBot, ClaudeBot, CCBot, Bytespider, Google-Extended, Applebot-Extended, Amazonbot, meta-externalagent için Disallow: /.",
+        },
+        recommendation: { en: "Off; write your own robots.txt (appendix A).", tr: "Kapalı; kendi robots.txt’nizi yazın (Ek A)." },
+    },
+    {
+        name: { en: "AI Labyrinth", tr: "AI Labyrinth" },
+        what: {
+            en: "Adds hidden links to pages to keep rule-breaking crawlers busy in an “endless link labyrinth”; it doesn't block.",
+            tr: "Sayfalara gizli linkler koyup kuralsız tarayıcıları “bitmeyen bir link labirentinde” oyalar; engellemez.",
+        },
+        recommendation: { en: "Off: it adds nothing to GEO.", tr: "Kapalı: GEO’ya katkısı yok." },
+    },
+    {
+        name: { en: "AI Crawl Control (formerly AI Audit)", tr: "AI Crawl Control (eski adı AI Audit)" },
+        what: {
+            en: "Shows how much each AI bot visits; blocking a bot here creates a WAF rule. On the free plan bots are recognised by user-agent only. “Pay per crawl” is in closed beta.",
+            tr: "Hangi yapay zekâ botunun ne kadar geldiğini gösterir; bir botu buradan engellemek bir WAF kuralı oluşturur. Ücretsiz planda botlar yalnızca user-agent’tan tanınır. “Taramaya ücret” (pay per crawl) kapalı betada.",
+        },
+        recommendation: { en: "Turn it on for read-only monitoring; don't block.", tr: "Salt okunur izleme için açın; engellemeyin." },
+    },
+    {
+        name: { en: "Bot Fight Mode", tr: "Bot Fight Mode" },
+        what: {
+            en: "Shows a challenge to unverified bots; WAF rules can't bypass it.",
+            tr: "Doğrulanmamış botlara meydan okuma (challenge) gösterir; WAF kurallarıyla atlanamaz.",
+        },
+        recommendation: { en: "If you see it leaving bots at the door, turn it off.", tr: "Botları kapıda bıraktığını görürseniz kapatın." },
+    },
+    {
+        name: { en: "Email obfuscation", tr: "E-posta gizleme" },
+        what: { en: "Hides e-mail addresses on the page with JavaScript.", tr: "Sayfadaki e-posta adresini JavaScript’le gizler." },
+        recommendation: {
+            en: "Off: bots and assistants should be able to read your address as text.",
+            tr: "Kapalı: bot ve asistan adresinizi metin olarak okuyabilsin.",
+        },
+    },
+];
+export const CF_DEFAULT_CHANGES = [
+    {
+        en: "July 2025: every domain newly added to Cloudflare is asked during setup whether to allow AI bots. Someone clicking quickly through setup may miss this question.",
+        tr: "Temmuz 2025: Cloudflare’e yeni eklenen her alan adına, kurulum sırasında yapay zekâ botlarına izin verip vermeyeceği soruluyor. Kurulumu hızlı geçen biri bu soruya dikkat etmeyebilir.",
+    },
+    {
+        en: "15 September 2026 (announced 1 July 2026): on new domains, Training and Agent bots start blocked on pages with ads, and Search bots start allowed.",
+        tr: "15 Eylül 2026 (1 Temmuz 2026’da duyuruldu): yeni alan adlarında Eğitim ve Ajan botları reklamlı sayfalarda engelli, Arama botları açık başlıyor.",
+    },
+    {
+        en: "Same announcement: anyone blocking training (legacy toggle included) will also block bots that work for both search and training; Cloudflare names Googlebot, Applebot and Bingbot as examples. There was an opt-out before 15 September. ANNOUNCEMENT: we found no record confirming it took effect — but if it did, leaving the legacy toggle on may also affect Google and Bing.",
+        tr: "Aynı duyuruda: eğitimi engelleyen herkes (eski düğme dahil), hem arama hem eğitim için çalışan botları da engelleyecek; Cloudflare örnek olarak Googlebot, Applebot ve Bingbot’u sayıyor. 15 Eylül’den önce vazgeçme (opt-out) hakkı vardı. DUYURU: bunun devreye girdiğini doğrulayan bir kayıt bulamadık; ama doğruysa eski düğmeyi açık bırakmak Google’ı ve Bing’i de etkileyebilir.",
+    },
+];
+export const CF_OUR_SITE = [
+    {
+        en: "30 Aug 2026: the first version of our audit tool found a CRITICAL issue on our own site: Cloudflare's managed robots.txt was silently closing GPTBot, ClaudeBot, Google-Extended, CCBot and Bytespider. We turned it off.",
+        tr: "30 Ağu 2026: denetim aracımızın ilk sürümü kendi sitemizde KRİTİK buldu: Cloudflare’in yönetilen robots.txt’si GPTBot, ClaudeBot, Google-Extended, CCBot ve Bytespider’ı sessizce kapatıyordu. Kapattık.",
+    },
+    {
+        en: "29 Sep 2026: retested while writing the book. Our robots.txt allowed GPTBot, but the legacy “Block AI bots” toggle was on in “only on pages with ads” mode and the AI training policy was “disallow”. Our site has no ads; training bots still got 403 on every page. The four blocked bots match Cloudflare's “AI Crawler” list exactly. We turned the legacy toggle off the same day; Cloudflare then set the training policy to “disabled” by itself, so “disallow” was a trace of the legacy toggle, not a separate decision. 20 seconds later all ten bots got 200.",
+        tr: "29 Eyl 2026: kitabı yazarken yeniden test ettik. robots.txt’miz GPTBot’a izin veriyordu, ama eski “Block AI bots” düğmesi “yalnızca reklamlı sayfalarda” konumunda açık, AI eğitim politikası da “disallow” idi. Sitemizde reklam yok; buna rağmen eğitim botları her sayfada 403 alıyordu. Engellenen dört bot, Cloudflare’in “AI Crawler” listesiyle birebir aynı. Eski düğmeyi aynı gün kapattık; Cloudflare eğitim politikasını da kendiliğinden “disabled” yaptı, yani “disallow” ayrı bir karar değil, eski düğmenin iziydi. 20 saniye sonra on botun onu da 200 aldı.",
+    },
+];
+export const CF_BEFORE_AFTER = [
+    { bot: "GPTBot", category: "AI Crawler (training)", before: 403, after: 200 },
+    { bot: "ClaudeBot", category: "AI Crawler (training)", before: 403, after: 200 },
+    { bot: "CCBot", category: "AI Crawler (training)", before: 403, after: 200 },
+    { bot: "Bytespider", category: "AI Crawler (training)", before: 403, after: 200 },
+    { bot: "OAI-SearchBot", category: "AI Search", before: 200, after: 200 },
+    { bot: "Claude-SearchBot", category: "AI Search", before: 200, after: 200 },
+    { bot: "PerplexityBot", category: "AI Search", before: 200, after: 200 },
+    { bot: "ChatGPT-User", category: "AI Assistant (user)", before: 200, after: 200 },
+    { bot: "Claude-User", category: "AI Assistant (user)", before: 200, after: 200 },
+    { bot: "Perplexity-User", category: "AI Assistant (user)", before: 200, after: 200 },
+];
+export const CF_CHECK_COMMAND = `# Status code for each bot. 403 = blocked at the door. (Spoofing the user-agent only shows user-agent-based rules;
+# you can't impersonate IP-verified bots such as Googlebot: check Search Console for those.)
+for b in GPTBot/1.2 ClaudeBot/1.0 CCBot/2.0 OAI-SearchBot/1.0 Claude-SearchBot/1.0 PerplexityBot/1.0 ChatGPT-User/1.0 Claude-User/1.0; do
+  printf "%-22s %s\\n" "$b" "$(curl -s -o /dev/null -w '%{http_code}' -A "Mozilla/5.0 (compatible; $b)" {site_url}/)"; done`;
+export const CF_WHERE_TO_LOOK = [
+    {
+        en: "Cloudflare dashboard → Security → Analytics → Events: which request was blocked by which rule (on the free plan, a sampled log of the last 24 hours).",
+        tr: "Cloudflare paneli → Security → Analytics → Events: hangi isteğin hangi kuralla engellendiği (ücretsiz planda son 24 saatin örneklenmiş kaydı).",
+    },
+    { en: "AI Crawl Control → Metrics: AI bot requests and status codes.", tr: "AI Crawl Control → Metrics: yapay zekâ botlarının istekleri ve durum kodları." },
+    {
+        en: "Search Console → Settings → Crawl stats → By response: the 403 and “other 4xx” responses Googlebot got, with URL and date.",
+        tr: "Search Console → Ayarlar → Tarama istatistikleri → Yanıta göre: Googlebot’un aldığı 403 ve “diğer 4xx” yanıtları, adres ve tarihiyle.",
+    },
+    {
+        en: "Your own server logs: search for the bot names. If they never appear, your door may be closed (ch. 15).",
+        tr: "Kendi sunucu kayıtlarınız: bot adlarını arayın. Hiç görünmüyorlarsa kapınız kapalı olabilir (15. bölüm).",
+    },
+];
+export const TRAINING_DECISION = {
+    allow: {
+        en: "If you allow it: models can learn you in your own words, and an assistant may know your name even when it answers without looking at the web. The sample site chose this: ai-train=yes in robots.txt, every block off on Cloudflare. In the first week ClaudeBot made 578 requests, GPTBot 362.",
+        tr: "İzin verirseniz: modeller sizi kendi cümlelerinizle öğrenebilir; asistan web’e bakmadan cevap verdiğinde de adınızı bilebilir. Örnek site bunu seçti: robots.txt’de ai-train=yes, Cloudflare’de bütün engeller kapalı. İlk haftada ClaudeBot 578, GPTBot 362 istek yaptı.",
+    },
+    block: {
+        en: "If you block it: your content stays out of training data. It doesn't stop you appearing in ChatGPT search (OpenAI). A sensible choice for publishers and paid-content sellers.",
+        tr: "Engellerseniz: içeriğiniz eğitim verisine girmez. ChatGPT aramasında görünmeyi engellemez (OpenAI). Yayıncılar ve ücretli içerik satanlar için mantıklı bir seçim olabilir.",
+    },
+    conditions: {
+        en: "Whichever you choose, three conditions: search and user bots must be open; robots.txt and the CDN must say the same thing; the decision must be made deliberately, not while clicking “next” on a setup screen. We couldn't measure a direct effect of training traffic on visitors from ChatGPT: the sample site's ChatGPT visitors came from pages the search bot had read.",
+        tr: "Hangisini seçerseniz seçin üç şart var: arama ve kullanıcı botları açık olmalı; robots.txt ile CDN aynı şeyi söylemeli; karar bilerek verilmeli, kurulum ekranında “ileri”ye basarken değil. Eğitim trafiğinin ChatGPT’den gelen ziyaretçiye doğrudan etkisini ölçemedik: örnek sitenin ChatGPT ziyaretçileri arama botunun okuduğu sayfalardan geldi.",
+    },
+};
+export const CF_FIX_STEPS = [
+    { en: "Cloudflare dashboard → your domain → Security → Settings: turn off the “Block AI bots” toggle.", tr: "Cloudflare paneli → alan adınız → Security → Settings: “Block AI bots” düğmesini kapatın." },
+    { en: "In the same place, AI bot policies: “allow” for Search and Agent; decide on Training.", tr: "Aynı yerde AI bot politikaları: Arama ve Ajan için “izin ver”; Eğitim için kararınızı verin." },
+    {
+        en: "Managed robots.txt, AI Labyrinth and, if needed, Bot Fight Mode: off. Email Address Obfuscation: off.",
+        tr: "“Yönetilen robots.txt”, AI Labyrinth ve gerekirse Bot Fight Mode: kapalı. E-posta gizleme (Email Address Obfuscation): kapalı.",
+    },
+    { en: "Run the check command again; OpenAI says changes take about 24 hours to take effect.", tr: "Kontrol komutunu tekrar çalıştırın; OpenAI değişikliklerin yaklaşık 24 saatte yansıdığını yazıyor." },
+    {
+        en: "Developers: the same settings are in the API — PUT /zones/<zone>/bot_management with ai_bots_protection: \"disabled\" and ai_training according to your training decision.",
+        tr: "Geliştiriciyseniz aynı ayarlar API’de: PUT /zones/<zone>/bot_management ile ai_bots_protection: \"disabled\" ve eğitim kararınıza göre ai_training.",
+    },
+];
+export const CF_EXERCISE = {
+    en: "Run the check command on your own site. Write every bot that gets 403 into research and note next to it “deliberate?”. If it isn't deliberate, fix it today.",
+    tr: "Kontrol komutunu kendi sitenizde çalıştırın. 403 alan her botu research.md’ye yazın ve karşısına “bilerek mi?” diye not düşün. Bilerek değilse bugün düzeltin.",
+};