geo-checker 0.3.0 → 0.3.2

package/dist/index.js

@@ -255,10 +255,12 @@ async function buildContext(url, opts = {}) {
       "Site appears to be JS-rendered (sparse body + SPA root element). Re-run with --render for accurate results."
     );
   }
-  const [robotsRaw, llmsRaw, llmsFullRaw] = await Promise.all([
+  const [robotsRaw, llmsRaw, llmsFullRaw, skillMdRaw, agentPermissionsRaw] = await Promise.all([
     fetchText(`${origin}/robots.txt`, opts),
     fetchText(`${origin}/llms.txt`, opts),
-    fetchText(`${origin}/llms-full.txt`, opts)
+    fetchText(`${origin}/llms-full.txt`, opts),
+    fetchText(`${origin}/skill.md`, opts),
+    fetchText(`${origin}/agent-permissions.json`, opts)
   ]);
   let sitemapUrl = null;
   const robots = robotsRaw ? parseRobots(robotsRaw) : null;
@@ -266,6 +268,13 @@ async function buildContext(url, opts = {}) {
   if (!sitemapUrl) sitemapUrl = `${origin}/sitemap.xml`;
   const sitemapRaw = await fetchText(sitemapUrl, opts);
   const sitemap = sitemapRaw ? parseSitemap(sitemapRaw) : null;
+  let agentPermissions = null;
+  if (agentPermissionsRaw && agentPermissionsRaw.trim().length > 0) {
+    try {
+      agentPermissions = JSON.parse(agentPermissionsRaw);
+    } catch {
+    }
+  }
   return {
     url,
     finalUrl,
@@ -280,7 +289,9 @@ async function buildContext(url, opts = {}) {
     jsonLd: extractJsonLd($),
     renderMode,
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    warnings
+    warnings,
+    skillMd: skillMdRaw && skillMdRaw.trim().length > 0 ? skillMdRaw : null,
+    agentPermissions
   };
 }
 
@@ -289,10 +300,11 @@ function defineRule(rule) {
   return rule;
 }
 var CATEGORY_WEIGHTS = {
-  crawler: 25,
-  "structured-data": 30,
-  citation: 25,
-  content: 20
+  crawler: 20,
+  "structured-data": 25,
+  citation: 20,
+  content: 15,
+  aeo: 20
 };
 
 // src/engine.ts
@@ -306,7 +318,8 @@ async function runRules(ctx, rules, opts = {}) {
     crawler: { score: 0, weight: weights.crawler, results: [] },
     "structured-data": { score: 0, weight: weights["structured-data"], results: [] },
     citation: { score: 0, weight: weights.citation, results: [] },
-    content: { score: 0, weight: weights.content, results: [] }
+    content: { score: 0, weight: weights.content, results: [] },
+    aeo: { score: 0, weight: weights.aeo, results: [] }
   };
   for (const rule of rules) {
     if (onlySet && !onlySet.has(rule.id) && (!rule.stableId || !onlySet.has(rule.stableId))) continue;
@@ -331,6 +344,7 @@ async function runRules(ctx, rules, opts = {}) {
       durationMs
     };
     if (rule.stableId !== void 0) entry.stableId = rule.stableId;
+    if (rule.title_ko !== void 0) entry.title_ko = rule.title_ko;
     if (rule.group !== void 0) entry.group = rule.group;
     if (rule.impact !== void 0) entry.impact = rule.impact;
     if (rule.effort !== void 0) entry.effort = rule.effort;
@@ -393,13 +407,15 @@ var httpsRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerhttps",
   title: "Site is served over HTTPS",
+  title_ko: "\uC0AC\uC774\uD2B8\uAC00 HTTPS\uB85C \uC81C\uACF5\uB428",
   description: "AI crawlers treat HTTPS pages as more trustworthy and some skip plain HTTP entirely.",
   run(ctx) {
     const isHttps = ctx.finalUrl.startsWith("https://");
-    return isHttps ? { status: "pass", score: 1, rationale: "Final URL uses HTTPS." } : {
+    return isHttps ? { status: "pass", score: 1, rationale: "Final URL uses HTTPS.", rationale_ko: "\uCD5C\uC885 URL\uC774 HTTPS\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4." } : {
       status: "fail",
       score: 0,
       rationale: "Final URL does not use HTTPS. Redirect HTTP \u2192 HTTPS site-wide.",
+      rationale_ko: "\uCD5C\uC885 URL\uC774 HTTPS\uB97C \uC0AC\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC0AC\uC774\uD2B8 \uC804\uCCB4\uB97C HTTP \u2192 HTTPS\uB85C \uB9AC\uB2E4\uC774\uB809\uD2B8\uD558\uC138\uC694.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -416,15 +432,17 @@ var robotsReachableRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerrobots-reachable",
   title: "robots.txt is reachable",
+  title_ko: "robots.txt \uC811\uADFC \uAC00\uB2A5 \uC5EC\uBD80",
   description: "A reachable robots.txt lets crawlers confirm their permissions; missing file is treated as allow-all but blocks explicit signalling.",
   run(ctx) {
     if (ctx.robots) {
-      return { status: "pass", score: 1, rationale: "robots.txt returned successfully." };
+      return { status: "pass", score: 1, rationale: "robots.txt returned successfully.", rationale_ko: "robots.txt\uAC00 \uC815\uC0C1\uC801\uC73C\uB85C \uC751\uB2F5\uD569\uB2C8\uB2E4." };
     }
     return {
       status: "warn",
       score: 0.3,
       rationale: "robots.txt is missing. Add one even if empty to explicitly signal crawl policy.",
+      rationale_ko: "robots.txt\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uD06C\uB864 \uC815\uCC45\uC744 \uBA85\uC2DC\uC801\uC73C\uB85C \uC54C\uB9AC\uB824\uBA74 \uBE44\uC5B4 \uC788\uB354\uB77C\uB3C4 \uCD94\uAC00\uD558\uC138\uC694.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -472,13 +490,15 @@ var robotsAiAllowRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerrobots-ai-allow",
   title: "AI crawlers are allowed",
+  title_ko: "AI \uD06C\uB864\uB7EC \uC811\uADFC \uD5C8\uC6A9 \uC5EC\uBD80",
   description: "Major AI search and training crawlers (17 bots incl. GPTBot, OAI-SearchBot, Google-Extended, ClaudeBot, PerplexityBot, Applebot-Extended, Meta-ExternalAgent, Bytespider, DuckAssistBot, YouBot) must be allowed to index the homepage.",
   run(ctx) {
     if (!ctx.robots) {
       return {
         status: "warn",
         score: 0.5,
-        rationale: "robots.txt missing; AI crawlers default to allow, but explicit allow is recommended."
+        rationale: "robots.txt missing; AI crawlers default to allow, but explicit allow is recommended.",
+        rationale_ko: "robots.txt\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uD06C\uB864\uB7EC\uB294 \uAE30\uBCF8\uC801\uC73C\uB85C \uD5C8\uC6A9\uB418\uC9C0\uB9CC, \uBA85\uC2DC\uC801 \uD5C8\uC6A9\uC744 \uAD8C\uC7A5\uD569\uB2C8\uB2E4."
       };
     }
     const path = new URL(ctx.finalUrl).pathname || "/";
@@ -496,6 +516,7 @@ var robotsAiAllowRule = defineRule({
         status: "fail",
         score: Math.max(0, 1 - blocked.length / AI_BOTS.length),
         rationale: `Blocked: ${blocked.join(", ")}. Remove the Disallow or add an explicit Allow for these user-agents.`,
+        rationale_ko: `\uCC28\uB2E8\uB428: ${blocked.join(", ")}. \uD574\uB2F9 User-agent\uC758 Disallow\uB97C \uC81C\uAC70\uD558\uAC70\uB098 \uBA85\uC2DC\uC801 Allow\uB97C \uCD94\uAC00\uD558\uC138\uC694.`,
         evidence: { blocked, mentioned, totalBots: AI_BOTS.length },
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
@@ -504,13 +525,15 @@ var robotsAiAllowRule = defineRule({
       return {
         status: "warn",
         score: 0.6,
-        rationale: `All ${AI_BOTS.length} AI crawlers reach the page via default rules, but none are explicitly listed. Consider explicit Allow entries.`
+        rationale: `All ${AI_BOTS.length} AI crawlers reach the page via default rules, but none are explicitly listed. Consider explicit Allow entries.`,
+        rationale_ko: `${AI_BOTS.length}\uAC1C AI \uD06C\uB864\uB7EC \uBAA8\uB450 \uAE30\uBCF8 \uADDC\uCE59\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD558\uC9C0\uB9CC, \uBA85\uC2DC\uC801\uC73C\uB85C \uD5C8\uC6A9\uB41C \uBD07\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA85\uC2DC\uC801 Allow \uD56D\uBAA9 \uCD94\uAC00\uB97C \uAD8C\uC7A5\uD569\uB2C8\uB2E4.`
       };
     }
     return {
       status: "pass",
       score: 1,
       rationale: `All ${AI_BOTS.length} AI crawlers can reach the page; ${mentioned.length} explicitly listed.`,
+      rationale_ko: `${AI_BOTS.length}\uAC1C AI \uD06C\uB864\uB7EC \uBAA8\uB450 \uC811\uADFC \uAC00\uB2A5\uD558\uBA70, ${mentioned.length}\uAC1C\uAC00 \uBA85\uC2DC\uC801\uC73C\uB85C \uD5C8\uC6A9\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.`,
       evidence: { mentioned, totalBots: AI_BOTS.length }
     };
   }
@@ -527,15 +550,17 @@ var llmsTxtPresentRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerllms-txt-present",
   title: "llms.txt is present",
+  title_ko: "llms.txt \uD30C\uC77C \uC874\uC7AC \uC5EC\uBD80",
   description: "An /llms.txt file at the site root gives AI assistants a curated map of the most citation-worthy pages.",
   run(ctx) {
     if (ctx.llmsTxt) {
-      return { status: "pass", score: 1, rationale: "llms.txt found at site root." };
+      return { status: "pass", score: 1, rationale: "llms.txt found at site root.", rationale_ko: "llms.txt\uAC00 \uC0AC\uC774\uD2B8 \uB8E8\uD2B8\uC5D0 \uC874\uC7AC\uD569\uB2C8\uB2E4." };
     }
     return {
       status: "warn",
       score: 0,
       rationale: "No /llms.txt found. Add one to curate the pages AI assistants should read.",
+      rationale_ko: "/llms.txt\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uAC00 \uC77D\uC5B4\uC57C \uD560 \uD398\uC774\uC9C0\uB97C \uD050\uB808\uC774\uC158\uD558\uB824\uBA74 \uCD94\uAC00\uD558\uC138\uC694.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -552,10 +577,11 @@ var llmsTxtWellformedRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerllms-txt-wellformed",
   title: "llms.txt follows the spec",
+  title_ko: "llms.txt \uC2A4\uD399 \uC900\uC218 \uC5EC\uBD80",
   description: "Must start with an H1 project title, then a brief summary, then at least one H2 section containing link items.",
   run(ctx) {
     if (!ctx.llmsTxt) {
-      return { status: "skip", score: 0, rationale: "No llms.txt to validate." };
+      return { status: "skip", score: 0, rationale: "No llms.txt to validate.", rationale_ko: "\uAC80\uC99D\uD560 llms.txt\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const check = isLlmsTxtWellFormed(ctx.llmsTxt);
     if (check.ok) {
@@ -563,13 +589,15 @@ var llmsTxtWellformedRule = defineRule({
       return {
         status: "pass",
         score: 1,
-        rationale: `Well-formed with ${ctx.llmsTxt.sections.length} section(s) and ${totalLinks} link(s).`
+        rationale: `Well-formed with ${ctx.llmsTxt.sections.length} section(s) and ${totalLinks} link(s).`,
+        rationale_ko: `\uC2A4\uD399\uC5D0 \uB9DE\uAC8C \uC791\uC131\uB428 (\uC139\uC158 ${ctx.llmsTxt.sections.length}\uAC1C, \uB9C1\uD06C ${totalLinks}\uAC1C).`
       };
     }
     return {
       status: "warn",
       score: 0.3,
       rationale: `llms.txt does not fully match the spec: ${check.reason}.`,
+      rationale_ko: `llms.txt\uAC00 \uC2A4\uD399\uC744 \uC644\uC804\uD788 \uB530\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: ${check.reason}.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -586,13 +614,15 @@ var llmsFullTxtRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlerllms-full-txt",
   title: "llms-full.txt provides full-content mirror",
+  title_ko: "llms-full.txt \uC804\uCCB4 \uCF58\uD150\uCE20 \uBBF8\uB7EC \uC81C\uACF5 \uC5EC\uBD80",
   description: "Complement /llms.txt with /llms-full.txt containing the full body of every cited page. AI assistants can ingest it in one request instead of crawling every URL.",
   run(ctx) {
     if (ctx.llmsFullTxt && ctx.llmsFullTxt.length > 200) {
       return {
         status: "pass",
         score: 1,
-        rationale: `/llms-full.txt found (${ctx.llmsFullTxt.length.toLocaleString()} chars).`
+        rationale: `/llms-full.txt found (${ctx.llmsFullTxt.length.toLocaleString()} chars).`,
+        rationale_ko: `/llms-full.txt\uAC00 \uC874\uC7AC\uD569\uB2C8\uB2E4 (${ctx.llmsFullTxt.length.toLocaleString()}\uC790).`
       };
     }
     if (ctx.llmsFullTxt) {
@@ -600,6 +630,7 @@ var llmsFullTxtRule = defineRule({
         status: "warn",
         score: 0.5,
         rationale: `/llms-full.txt found but very short (${ctx.llmsFullTxt.length} chars). Consider expanding with page bodies.`,
+        rationale_ko: `/llms-full.txt\uAC00 \uC788\uC9C0\uB9CC \uB108\uBB34 \uC9E7\uC2B5\uB2C8\uB2E4 (${ctx.llmsFullTxt.length}\uC790). \uD398\uC774\uC9C0 \uBCF8\uBB38\uC73C\uB85C \uB0B4\uC6A9\uC744 \uBCF4\uAC15\uD558\uC138\uC694.`,
         fixHint: "Mirror full article bodies into /llms-full.txt so AI assistants can quote without re-crawling."
       };
     }
@@ -607,6 +638,7 @@ var llmsFullTxtRule = defineRule({
       status: "warn",
       score: 0,
       rationale: "No /llms-full.txt found. Adding one lets AI assistants ingest the full corpus in a single request.",
+      rationale_ko: "/llms-full.txt\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD94\uAC00\uD558\uBA74 AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uAC00 \uC804\uCCB4 \uCF58\uD150\uCE20\uB97C \uD55C \uBC88\uC758 \uC694\uCCAD\uC73C\uB85C \uC218\uC9D1\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
       fixHint: "Publish /llms-full.txt alongside /llms.txt with the full body text of your top pages.",
       estimatedImpact: 1
     };
@@ -624,19 +656,22 @@ var sitemapPresentRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#crawlersitemap-present",
   title: "sitemap.xml is present",
+  title_ko: "sitemap.xml \uC874\uC7AC \uC5EC\uBD80",
   description: "A sitemap helps AI crawlers discover and prioritise pages; many crawlers short-circuit discovery without one.",
   run(ctx) {
     if (ctx.sitemap && ctx.sitemap.urls.length > 0) {
       return {
         status: "pass",
         score: 1,
-        rationale: `Sitemap found with ${ctx.sitemap.urls.length} URL(s).`
+        rationale: `Sitemap found with ${ctx.sitemap.urls.length} URL(s).`,
+        rationale_ko: `\uC0AC\uC774\uD2B8\uB9F5\uC5D0 URL\uC774 ${ctx.sitemap.urls.length}\uAC1C \uC788\uC2B5\uB2C8\uB2E4.`
       };
     }
     return {
       status: "warn",
       score: 0.2,
       rationale: "No sitemap.xml found (checked /sitemap.xml and Sitemap: directive in robots.txt).",
+      rationale_ko: "sitemap.xml\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (/sitemap.xml \uBC0F robots.txt\uC758 Sitemap: \uC9C0\uC2DC\uC5B4\uB97C \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4).",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -664,15 +699,17 @@ var jsonLdPresentRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdjsonld-present",
   title: "JSON-LD structured data is present",
+  title_ko: "JSON-LD \uAD6C\uC870\uD654 \uB370\uC774\uD130 \uC874\uC7AC \uC5EC\uBD80",
   description: 'At least one <script type="application/ld+json"> block is the primary way AI engines map your page to an entity.',
   run(ctx) {
     if (ctx.jsonLd.length > 0) {
-      return { status: "pass", score: 1, rationale: `Found ${ctx.jsonLd.length} JSON-LD block(s).` };
+      return { status: "pass", score: 1, rationale: `Found ${ctx.jsonLd.length} JSON-LD block(s).`, rationale_ko: `JSON-LD \uBE14\uB85D\uC774 ${ctx.jsonLd.length}\uAC1C \uC788\uC2B5\uB2C8\uB2E4.` };
     }
     return {
       status: "fail",
       score: 0,
       rationale: "No JSON-LD blocks found. Add schema.org structured data.",
+      rationale_ko: "JSON-LD \uBE14\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. schema.org \uAD6C\uC870\uD654 \uB370\uC774\uD130\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -748,20 +785,22 @@ var jsonLdValidJsonRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdjsonld-valid-json",
   title: "JSON-LD blocks parse as valid JSON",
+  title_ko: "JSON-LD \uBE14\uB85D\uC758 JSON \uC720\uD6A8\uC131",
   description: "Malformed JSON in an ld+json block is silently ignored by most consumers \u2014 a costly silent failure.",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to validate." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to validate.", rationale_ko: "\uAC80\uC99D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     if (hasParseError(ctx.jsonLd)) {
       return {
         status: "fail",
         score: 0,
         rationale: "One or more JSON-LD blocks failed to parse.",
+        rationale_ko: "JSON-LD \uBE14\uB85D \uD558\uB098 \uC774\uC0C1\uC744 \uD30C\uC2F1\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
     }
-    return { status: "pass", score: 1, rationale: "All JSON-LD blocks parse cleanly." };
+    return { status: "pass", score: 1, rationale: "All JSON-LD blocks parse cleanly.", rationale_ko: "\uBAA8\uB4E0 JSON-LD \uBE14\uB85D\uC774 \uC62C\uBC14\uB974\uAC8C \uD30C\uC2F1\uB429\uB2C8\uB2E4." };
   }
 });
 
@@ -776,10 +815,11 @@ var schemaTypeRecognizedRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdschema-type-recognized",
   title: "Schema.org @type is a recognised kind",
+  title_ko: "Schema.org @type \uC778\uC2DD \uAC00\uB2A5 \uC5EC\uBD80",
   description: "AI engines match pages against well-known types (Article, Product, FAQPage...). Obscure types weaken the signal.",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse.", rationale_ko: "\uBD84\uC11D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const nodes = flattenJsonLd(ctx.jsonLd);
     const recognized = /* @__PURE__ */ new Set();
@@ -795,6 +835,7 @@ var schemaTypeRecognizedRule = defineRule({
         status: "pass",
         score: 1,
         rationale: `Recognised: ${[...recognized].join(", ")}.`,
+        rationale_ko: `\uC778\uC2DD\uB41C \uD0C0\uC785: ${[...recognized].join(", ")}.`,
         evidence: { recognized: [...recognized], all: [...seenTypes] }
       };
     }
@@ -802,6 +843,7 @@ var schemaTypeRecognizedRule = defineRule({
       status: "warn",
       score: 0.3,
       rationale: `No recognised schema.org types. Saw: ${[...seenTypes].join(", ") || "(none)"}.`,
+      rationale_ko: `\uC778\uC2DD \uAC00\uB2A5\uD55C schema.org \uD0C0\uC785\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBC1C\uACAC\uB41C \uD0C0\uC785: ${[...seenTypes].join(", ") || "(\uC5C6\uC74C)"}.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -818,10 +860,11 @@ var requiredFieldsRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdrequired-fields",
   title: "Required fields for recognised types are set",
+  title_ko: "\uC778\uC2DD\uB41C \uD0C0\uC785\uC758 \uD544\uC218 \uD544\uB4DC \uCDA9\uC871 \uC5EC\uBD80",
   description: "Article needs headline/author/datePublished, FAQPage needs mainEntity, Product needs offers, etc.",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse.", rationale_ko: "\uBD84\uC11D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const nodes = flattenJsonLd(ctx.jsonLd);
     const missing = [];
@@ -840,14 +883,16 @@ var requiredFieldsRule = defineRule({
       return {
         status: "skip",
         score: 0,
-        rationale: "No types with known required fields were found."
+        rationale: "No types with known required fields were found.",
+        rationale_ko: "\uD544\uC218 \uD544\uB4DC\uAC00 \uC815\uC758\uB41C \uD0C0\uC785\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."
       };
     }
     if (missing.length === 0) {
       return {
         status: "pass",
         score: 1,
-        rationale: `Required fields set on ${checked.length} node(s).`
+        rationale: `Required fields set on ${checked.length} node(s).`,
+        rationale_ko: `${checked.length}\uAC1C \uB178\uB4DC\uC758 \uD544\uC218 \uD544\uB4DC\uAC00 \uBAA8\uB450 \uCDA9\uC871\uB429\uB2C8\uB2E4.`
       };
     }
     const msg = missing.map((m) => `${m.type}.${m.field}`).join(", ");
@@ -855,6 +900,7 @@ var requiredFieldsRule = defineRule({
       status: "fail",
       score: Math.max(0, 1 - missing.length / (checked.length * 2)),
       rationale: `Missing required fields: ${msg}.`,
+      rationale_ko: `\uB204\uB77D\uB41C \uD544\uC218 \uD544\uB4DC: ${msg}.`,
       evidence: missing,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
@@ -872,10 +918,11 @@ var microdataFallbackRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdmicrodata-fallback",
   title: "Microdata or RDFa fallback when JSON-LD is missing",
+  title_ko: "JSON-LD \uC5C6\uC744 \uB54C Microdata/RDFa \uB300\uCCB4 \uC5EC\uBD80",
   description: "If JSON-LD is absent, inline microdata (itemscope/itemtype) or RDFa still gives some structured signal.",
   run(ctx) {
     if (ctx.jsonLd.length > 0) {
-      return { status: "skip", score: 0, rationale: "JSON-LD is present; fallback not needed." };
+      return { status: "skip", score: 0, rationale: "JSON-LD is present; fallback not needed.", rationale_ko: "JSON-LD\uAC00 \uC788\uC73C\uBBC0\uB85C \uB300\uCCB4 \uC218\uB2E8\uC774 \uD544\uC694\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." };
     }
     const microdata = ctx.$("[itemscope][itemtype]").length;
     const rdfa = ctx.$("[typeof][vocab], [typeof][property]").length;
@@ -883,13 +930,15 @@ var microdataFallbackRule = defineRule({
       return {
         status: "pass",
         score: 1,
-        rationale: `Found ${microdata} microdata and ${rdfa} RDFa nodes.`
+        rationale: `Found ${microdata} microdata and ${rdfa} RDFa nodes.`,
+        rationale_ko: `Microdata ${microdata}\uAC1C, RDFa ${rdfa}\uAC1C \uBC1C\uACAC\uB429\uB2C8\uB2E4.`
       };
     }
     return {
       status: "fail",
       score: 0,
       rationale: "No structured data at all (no JSON-LD, no microdata, no RDFa).",
+      rationale_ko: "\uAD6C\uC870\uD654 \uB370\uC774\uD130\uAC00 \uC804\uD600 \uC5C6\uC2B5\uB2C8\uB2E4 (JSON-LD, Microdata, RDFa \uBAA8\uB450 \uC5C6\uC74C).",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -907,10 +956,11 @@ var noDuplicateTypesRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdno-duplicate-types",
   title: "No conflicting duplicate @types",
+  title_ko: "@type \uC911\uBCF5 \uCDA9\uB3CC \uC5C6\uC74C",
   description: "Multiple competing entities of the same primary type (e.g. two Articles) confuse the engine about which one represents the page.",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse.", rationale_ko: "\uBD84\uC11D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const counts = /* @__PURE__ */ new Map();
     for (const node of flattenJsonLd(ctx.jsonLd)) {
@@ -920,12 +970,13 @@ var noDuplicateTypesRule = defineRule({
     }
     const dupes = [...counts.entries()].filter(([, n]) => n > 1);
     if (dupes.length === 0) {
-      return { status: "pass", score: 1, rationale: "No duplicate primary types." };
+      return { status: "pass", score: 1, rationale: "No duplicate primary types.", rationale_ko: "\uC911\uBCF5\uB41C \uAE30\uBCF8 \uD0C0\uC785\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     return {
       status: "warn",
       score: 0.4,
       rationale: `Duplicate primary types: ${dupes.map(([t, n]) => `${t}\xD7${n}`).join(", ")}.`,
+      rationale_ko: `\uC911\uBCF5\uB41C \uAE30\uBCF8 \uD0C0\uC785: ${dupes.map(([t, n]) => `${t}\xD7${n}`).join(", ")}.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -973,10 +1024,11 @@ var sameAsEntityRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdsameas-entity",
   title: "Entity nodes link the knowledge graph via sameAs",
+  title_ko: "sameAs\uB85C \uC9C0\uC2DD \uADF8\uB798\uD504 \uC5F0\uACB0 \uC5EC\uBD80",
   description: "Organization/Person nodes should declare a sameAs[] array linking to Wikipedia/Wikidata/LinkedIn so AI engines can resolve the entity in their knowledge graph (E-E-A-T signal).",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse.", rationale_ko: "\uBD84\uC11D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const nodes = flattenJsonLd(ctx.jsonLd);
     const entities = nodes.filter((n) => getTypes(n).some((t) => ENTITY_TYPES.includes(t)));
@@ -984,7 +1036,8 @@ var sameAsEntityRule = defineRule({
       return {
         status: "skip",
         score: 0,
-        rationale: "No Organization/Person/LocalBusiness/Brand entity to link."
+        rationale: "No Organization/Person/LocalBusiness/Brand entity to link.",
+        rationale_ko: "\uC5F0\uACB0\uD560 Organization/Person/LocalBusiness/Brand \uC5D4\uD2F0\uD2F0\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."
       };
     }
     let bestScore = 0;
@@ -1008,6 +1061,7 @@ var sameAsEntityRule = defineRule({
         status: "pass",
         score: 1,
         rationale: `Entity links ${bestEvidence.trusted} trusted knowledge-graph hosts via sameAs.`,
+        rationale_ko: `\uC5D4\uD2F0\uD2F0\uAC00 sameAs\uB85C \uC2E0\uB8B0\uD560 \uC218 \uC788\uB294 \uC9C0\uC2DD \uADF8\uB798\uD504 \uC0AC\uC774\uD2B8 ${bestEvidence.trusted}\uAC1C\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.`,
         evidence: bestEvidence
       };
     }
@@ -1016,6 +1070,7 @@ var sameAsEntityRule = defineRule({
         status: "pass",
         score: bestScore,
         rationale: `Entity has 1 trusted sameAs link. Add Wikipedia/Wikidata for stronger E-E-A-T.`,
+        rationale_ko: "\uC2E0\uB8B0\uD560 \uC218 \uC788\uB294 sameAs \uB9C1\uD06C\uAC00 1\uAC1C \uC788\uC2B5\uB2C8\uB2E4. E-E-A-T \uAC15\uD654\uB97C \uC704\uD574 Wikipedia/Wikidata\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
         evidence: bestEvidence,
         estimatedImpact: 1
       };
@@ -1025,6 +1080,7 @@ var sameAsEntityRule = defineRule({
         status: "warn",
         score: bestScore,
         rationale: "Entity declares sameAs but no trusted knowledge-graph hosts (Wikipedia/Wikidata/LinkedIn).",
+        rationale_ko: "sameAs\uAC00 \uC120\uC5B8\uB418\uC5B4 \uC788\uC9C0\uB9CC \uC2E0\uB8B0\uD560 \uC218 \uC788\uB294 \uC9C0\uC2DD \uADF8\uB798\uD504 \uD638\uC2A4\uD2B8(Wikipedia/Wikidata/LinkedIn)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
         evidence: bestEvidence,
         fixHint: "Add Wikipedia/Wikidata/LinkedIn URLs to your Organization sameAs[].",
         estimatedImpact: 2
@@ -1034,6 +1090,7 @@ var sameAsEntityRule = defineRule({
       status: "warn",
       score: 0,
       rationale: `${entities.length} entity node(s) found but none declare sameAs links.`,
+      rationale_ko: `\uC5D4\uD2F0\uD2F0 \uB178\uB4DC\uAC00 ${entities.length}\uAC1C \uC788\uC9C0\uB9CC sameAs \uB9C1\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.`,
       fixHint: 'Add sameAs:["https://en.wikipedia.org/wiki/...", "https://www.linkedin.com/company/..."] to your Organization JSON-LD.',
       estimatedImpact: 3
     };
@@ -1065,15 +1122,16 @@ var breadcrumbValidRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#sdbreadcrumb-valid",
   title: "BreadcrumbList items declare position, name, and item",
+  title_ko: "BreadcrumbList \uD56D\uBAA9\uC758 \uD544\uC218 \uD544\uB4DC \uCDA9\uC871 \uC5EC\uBD80",
   description: "When BreadcrumbList JSON-LD is present, every itemListElement should set position (1-indexed), name, and item (URL) \u2014 otherwise AI engines cannot reconstruct the path.",
   run(ctx) {
     if (ctx.jsonLd.length === 0) {
-      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse." };
+      return { status: "skip", score: 0, rationale: "No JSON-LD to analyse.", rationale_ko: "\uBD84\uC11D\uD560 JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const nodes = flattenJsonLd(ctx.jsonLd);
     const breadcrumbs = nodes.filter((n) => getTypes(n).includes("BreadcrumbList"));
     if (breadcrumbs.length === 0) {
-      return { status: "skip", score: 0, rationale: "No BreadcrumbList present." };
+      return { status: "skip", score: 0, rationale: "No BreadcrumbList present.", rationale_ko: "BreadcrumbList\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const allIssues = [];
     let totalItems = 0;
@@ -1086,7 +1144,8 @@ var breadcrumbValidRule = defineRule({
       return {
         status: "pass",
         score: 1,
-        rationale: `BreadcrumbList(s) valid (${totalItems} items).`
+        rationale: `BreadcrumbList(s) valid (${totalItems} items).`,
+        rationale_ko: `BreadcrumbList\uAC00 \uC720\uD6A8\uD569\uB2C8\uB2E4 (\uD56D\uBAA9 ${totalItems}\uAC1C).`
       };
     }
     const fatalCount = allIssues.length;
@@ -1096,6 +1155,7 @@ var breadcrumbValidRule = defineRule({
       status: score < 0.5 ? "fail" : "warn",
       score,
       rationale: `${fatalCount} breadcrumb item(s) missing required fields.`,
+      rationale_ko: `breadcrumb \uD56D\uBAA9 ${fatalCount}\uAC1C\uC5D0 \uD544\uC218 \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.`,
       evidence: allIssues.slice(0, 5),
       fixHint: 'Each itemListElement needs { "@type": "ListItem", position: N, name, item }.',
       estimatedImpact: Math.round(2 * (1 - score))
@@ -1126,6 +1186,7 @@ var titleRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cittitle",
   title: "<title> is set with a reasonable length",
+  title_ko: "<title> \uD0DC\uADF8 \uC801\uC815 \uAE38\uC774 \uC124\uC815 \uC5EC\uBD80",
   description: "The document title is the single most-cited piece of text and should be 10\u201370 characters.",
   run(ctx) {
     const title = ctx.$("head > title").first().text().trim();
@@ -1134,6 +1195,7 @@ var titleRule = defineRule({
         status: "fail",
         score: 0,
         rationale: "Page has no <title>.",
+        rationale_ko: "\uD398\uC774\uC9C0\uC5D0 <title>\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
     }
@@ -1141,17 +1203,19 @@ var titleRule = defineRule({
       return {
         status: "warn",
         score: 0.4,
-        rationale: `Title is only ${title.length} chars; consider a more descriptive one.`
+        rationale: `Title is only ${title.length} chars; consider a more descriptive one.`,
+        rationale_ko: `\uC81C\uBAA9\uC774 ${title.length}\uC790\uBC16\uC5D0 \uC548 \uB429\uB2C8\uB2E4. \uB354 \uAD6C\uCCB4\uC801\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694.`
       };
     }
     if (title.length > 70) {
       return {
         status: "warn",
         score: 0.6,
-        rationale: `Title is ${title.length} chars; search UIs commonly truncate after ~70.`
+        rationale: `Title is ${title.length} chars; search UIs commonly truncate after ~70.`,
+        rationale_ko: `\uC81C\uBAA9\uC774 ${title.length}\uC790\uC785\uB2C8\uB2E4. \uAC80\uC0C9 UI\uC5D0\uC11C 70\uC790 \uC774\uD6C4\uB294 \uC798\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`
       };
     }
-    return { status: "pass", score: 1, rationale: `Title length ${title.length} is within range.` };
+    return { status: "pass", score: 1, rationale: `Title length ${title.length} is within range.`, rationale_ko: `\uC81C\uBAA9 \uAE38\uC774 ${title.length}\uC790\uB85C \uC801\uC808\uD569\uB2C8\uB2E4.` };
   }
 });
 
@@ -1166,6 +1230,7 @@ var metaDescriptionRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citmeta-description",
   title: "meta description is set (50\u2013160 chars)",
+  title_ko: "meta description \uC124\uC815 \uC5EC\uBD80 (50\u2013160\uC790)",
   description: "AI snippets often quote the meta description verbatim; aim for 50\u2013160 chars.",
   run(ctx) {
     const desc = ctx.$('head meta[name="description"]').attr("content")?.trim() ?? "";
@@ -1174,16 +1239,17 @@ var metaDescriptionRule = defineRule({
         status: "warn",
         score: 0,
         rationale: "No meta description set.",
+        rationale_ko: "meta description\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
     }
     if (desc.length < 50) {
-      return { status: "warn", score: 0.5, rationale: `Only ${desc.length} chars; aim for 50+.` };
+      return { status: "warn", score: 0.5, rationale: `Only ${desc.length} chars; aim for 50+.`, rationale_ko: `${desc.length}\uC790\uBC16\uC5D0 \uC548 \uB429\uB2C8\uB2E4. 50\uC790 \uC774\uC0C1\uC744 \uBAA9\uD45C\uB85C \uD558\uC138\uC694.` };
     }
     if (desc.length > 160) {
-      return { status: "warn", score: 0.7, rationale: `${desc.length} chars; may be truncated after 160.` };
+      return { status: "warn", score: 0.7, rationale: `${desc.length} chars; may be truncated after 160.`, rationale_ko: `${desc.length}\uC790\uC785\uB2C8\uB2E4. 160\uC790 \uC774\uD6C4\uB294 \uC798\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.` };
     }
-    return { status: "pass", score: 1, rationale: `Description length ${desc.length} is within range.` };
+    return { status: "pass", score: 1, rationale: `Description length ${desc.length} is within range.`, rationale_ko: `\uC124\uBA85 \uAE38\uC774 ${desc.length}\uC790\uB85C \uC801\uC808\uD569\uB2C8\uB2E4.` };
   }
 });
 
@@ -1198,6 +1264,7 @@ var canonicalRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citcanonical",
   title: "Canonical URL is declared",
+  title_ko: "Canonical URL \uC120\uC5B8 \uC5EC\uBD80",
   description: 'rel="canonical" tells crawlers which URL is the source of truth, preventing duplicate-citation confusion.',
   run(ctx) {
     const href = ctx.$('head link[rel="canonical"]').attr("href")?.trim();
@@ -1206,14 +1273,15 @@ var canonicalRule = defineRule({
         status: "warn",
         score: 0,
         rationale: 'No <link rel="canonical"> found.',
+        rationale_ko: '<link rel="canonical">\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.',
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
     }
     try {
       const abs = new URL(href, ctx.finalUrl).toString();
-      return { status: "pass", score: 1, rationale: `Canonical URL: ${abs}.` };
+      return { status: "pass", score: 1, rationale: `Canonical URL: ${abs}.`, rationale_ko: `Canonical URL: ${abs}.` };
     } catch {
-      return { status: "fail", score: 0, rationale: `Canonical href is not a valid URL: ${href}` };
+      return { status: "fail", score: 0, rationale: `Canonical href is not a valid URL: ${href}`, rationale_ko: `Canonical href\uAC00 \uC720\uD6A8\uD55C URL\uC774 \uC544\uB2D9\uB2C8\uB2E4: ${href}` };
     }
   }
 });
@@ -1230,6 +1298,7 @@ var ogTagsRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citog-tags",
   title: "Open Graph tags are set",
+  title_ko: "Open Graph \uD0DC\uADF8 \uC124\uC815 \uC5EC\uBD80",
   description: "og:title/type/url/image power rich previews on AI chat, social, and messaging.",
   run(ctx) {
     const missing = [];
@@ -1238,13 +1307,14 @@ var ogTagsRule = defineRule({
       if (!val) missing.push(prop);
     }
     if (missing.length === 0) {
-      return { status: "pass", score: 1, rationale: "All required OG tags present." };
+      return { status: "pass", score: 1, rationale: "All required OG tags present.", rationale_ko: "\uD544\uC218 OG \uD0DC\uADF8\uAC00 \uBAA8\uB450 \uC788\uC2B5\uB2C8\uB2E4." };
     }
     const ratio = 1 - missing.length / REQUIRED.length;
     return {
       status: missing.length === REQUIRED.length ? "fail" : "warn",
       score: ratio,
       rationale: `Missing: ${missing.join(", ")}.`,
+      rationale_ko: `\uB204\uB77D\uB41C \uD0DC\uADF8: ${missing.join(", ")}.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1261,20 +1331,22 @@ var twitterCardRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cittwitter-card",
   title: "Twitter Card metadata is set",
+  title_ko: "Twitter Card \uBA54\uD0C0\uB370\uC774\uD130 \uC124\uC815 \uC5EC\uBD80",
   description: "twitter:card + twitter:title give better previews on X/Twitter and some AI surfaces that reuse the tags.",
   run(ctx) {
     const card = ctx.$('head meta[name="twitter:card"]').attr("content")?.trim();
     const title = ctx.$('head meta[name="twitter:title"]').attr("content")?.trim();
     if (card && title) {
-      return { status: "pass", score: 1, rationale: `Card type: ${card}.` };
+      return { status: "pass", score: 1, rationale: `Card type: ${card}.`, rationale_ko: `\uCE74\uB4DC \uC720\uD615: ${card}.` };
     }
     if (card || title) {
-      return { status: "warn", score: 0.5, rationale: "Partial twitter:* metadata; add the missing tag." };
+      return { status: "warn", score: 0.5, rationale: "Partial twitter:* metadata; add the missing tag.", rationale_ko: "twitter:* \uBA54\uD0C0\uB370\uC774\uD130\uAC00 \uC77C\uBD80\uB9CC \uC788\uC2B5\uB2C8\uB2E4. \uB204\uB77D\uB41C \uD0DC\uADF8\uB97C \uCD94\uAC00\uD558\uC138\uC694." };
     }
     return {
       status: "warn",
       score: 0,
       rationale: "No twitter:card metadata.",
+      rationale_ko: "twitter:card \uBA54\uD0C0\uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1291,6 +1363,7 @@ var langAttrRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citlang-attr",
   title: "<html lang> is set",
+  title_ko: "<html lang> \uC18D\uC131 \uC124\uC815 \uC5EC\uBD80",
   description: "A lang attribute helps AI engines route the page to the right-language search surface (and helps screen readers).",
   run(ctx) {
     const lang = ctx.$("html").attr("lang")?.trim();
@@ -1299,10 +1372,11 @@ var langAttrRule = defineRule({
         status: "warn",
         score: 0,
         rationale: "No lang attribute on <html>.",
+        rationale_ko: "<html>\uC5D0 lang \uC18D\uC131\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
       };
     }
-    return { status: "pass", score: 1, rationale: `lang="${lang}".` };
+    return { status: "pass", score: 1, rationale: `lang="${lang}".`, rationale_ko: `lang="${lang}".` };
   }
 });
 
@@ -1317,25 +1391,27 @@ var authorVisibleRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citauthor-visible",
   title: "Author is declared",
+  title_ko: "\uC791\uC131\uC790 \uC815\uBCF4 \uC120\uC5B8 \uC5EC\uBD80",
   description: "AI engines prefer citing content with an identifiable author; expose one via JSON-LD, meta[name=author], rel=author, or a .author class.",
   run(ctx) {
     for (const node of flattenJsonLd(ctx.jsonLd)) {
       if (hasField(node, "author")) {
-        return { status: "pass", score: 1, rationale: "Author found in JSON-LD." };
+        return { status: "pass", score: 1, rationale: "Author found in JSON-LD.", rationale_ko: "JSON-LD\uC5D0\uC11C \uC791\uC131\uC790 \uC815\uBCF4\uB97C \uCC3E\uC558\uC2B5\uB2C8\uB2E4." };
       }
     }
     const metaAuthor = ctx.$('head meta[name="author"]').attr("content")?.trim();
-    if (metaAuthor) return { status: "pass", score: 1, rationale: `meta[name=author] = "${metaAuthor}".` };
+    if (metaAuthor) return { status: "pass", score: 1, rationale: `meta[name=author] = "${metaAuthor}".`, rationale_ko: `meta[name=author] = "${metaAuthor}".` };
     if (ctx.$('[rel="author"]').length > 0) {
-      return { status: "pass", score: 1, rationale: 'rel="author" link found.' };
+      return { status: "pass", score: 1, rationale: 'rel="author" link found.', rationale_ko: 'rel="author" \uB9C1\uD06C\uB97C \uCC3E\uC558\uC2B5\uB2C8\uB2E4.' };
     }
     if (ctx.$('.author, [class*="author"], [itemprop="author"]').length > 0) {
-      return { status: "pass", score: 0.8, rationale: "Author-ish DOM selector found (weaker signal)." };
+      return { status: "pass", score: 0.8, rationale: "Author-ish DOM selector found (weaker signal).", rationale_ko: "\uC791\uC131\uC790 \uAD00\uB828 DOM \uC120\uD0DD\uC790\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (\uC2E0\uD638 \uAC15\uB3C4 \uB0AE\uC74C)." };
     }
     return {
       status: "warn",
       score: 0,
       rationale: "No author signal found (JSON-LD, meta, rel, or .author).",
+      rationale_ko: "\uC791\uC131\uC790 \uC815\uBCF4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 (JSON-LD, meta, rel, .author \uBAA8\uB450 \uC5C6\uC74C).",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1352,25 +1428,27 @@ var datesRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citdates",
   title: "Publish / modified date is present",
+  title_ko: "\uBC1C\uD589\uC77C / \uC218\uC815\uC77C \uC874\uC7AC \uC5EC\uBD80",
   description: "AI engines rank recent pages higher; expose datePublished via JSON-LD, <time datetime>, or article:published_time meta.",
   run(ctx) {
     for (const node of flattenJsonLd(ctx.jsonLd)) {
       if (hasField(node, "datePublished")) {
-        return { status: "pass", score: 1, rationale: "datePublished found in JSON-LD." };
+        return { status: "pass", score: 1, rationale: "datePublished found in JSON-LD.", rationale_ko: "JSON-LD\uC5D0\uC11C datePublished\uB97C \uCC3E\uC558\uC2B5\uB2C8\uB2E4." };
       }
     }
     const articleTime = ctx.$('head meta[property="article:published_time"]').attr("content")?.trim();
     if (articleTime) {
-      return { status: "pass", score: 1, rationale: `article:published_time = ${articleTime}.` };
+      return { status: "pass", score: 1, rationale: `article:published_time = ${articleTime}.`, rationale_ko: `article:published_time = ${articleTime}.` };
     }
     const timeEl = ctx.$("time[datetime]").first().attr("datetime")?.trim();
     if (timeEl) {
-      return { status: "pass", score: 0.8, rationale: `<time datetime="${timeEl}"> found.` };
+      return { status: "pass", score: 0.8, rationale: `<time datetime="${timeEl}"> found.`, rationale_ko: `<time datetime="${timeEl}">\uB97C \uCC3E\uC558\uC2B5\uB2C8\uB2E4.` };
     }
     return {
       status: "warn",
       score: 0,
       rationale: "No publish date found (JSON-LD, meta article:published_time, or <time datetime>).",
+      rationale_ko: "\uBC1C\uD589\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (JSON-LD, meta article:published_time, <time datetime> \uBAA8\uB450 \uC5C6\uC74C).",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1398,6 +1476,7 @@ var contentFreshnessRule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#citcontent-freshness",
   title: "Article content is fresh (dateModified within 1 year)",
+  title_ko: "\uCF58\uD150\uCE20 \uCD5C\uC2E0\uC131 (dateModified 1\uB144 \uC774\uB0B4)",
   description: "AI engines down-rank stale content. Surface a recent dateModified (\u2264365 days) on Article-like pages so retrieval rankings stay strong.",
   run(ctx) {
     const nodes = flattenJsonLd(ctx.jsonLd);
@@ -1406,7 +1485,8 @@ var contentFreshnessRule = defineRule({
       return {
         status: "skip",
         score: 0,
-        rationale: "No Article/BlogPosting/NewsArticle JSON-LD; freshness signal not applicable."
+        rationale: "No Article/BlogPosting/NewsArticle JSON-LD; freshness signal not applicable.",
+        rationale_ko: "Article/BlogPosting/NewsArticle JSON-LD\uAC00 \uC5C6\uC5B4 \uCD5C\uC2E0\uC131 \uC2E0\uD638\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."
       };
     }
     let bestMs = null;
@@ -1428,6 +1508,7 @@ var contentFreshnessRule = defineRule({
         status: "warn",
         score: 0,
         rationale: "Article has no parseable dateModified or datePublished.",
+        rationale_ko: "Article JSON-LD\uC5D0 \uD30C\uC2F1 \uAC00\uB2A5\uD55C dateModified \uB610\uB294 datePublished\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
         fixHint: "Add ISO-8601 dateModified and datePublished to your Article JSON-LD.",
         estimatedImpact: 3
       };
@@ -1438,6 +1519,7 @@ var contentFreshnessRule = defineRule({
         status: "pass",
         score: 1,
         rationale: `${usedField} within the last year (~${ageDays} day${ageDays === 1 ? "" : "s"} ago).`,
+        rationale_ko: `${usedField}\uC774 1\uB144 \uC774\uB0B4\uC785\uB2C8\uB2E4 (\uC57D ${ageDays}\uC77C \uC804).`,
         evidence: { ageDays, field: usedField }
       };
     }
@@ -1446,6 +1528,7 @@ var contentFreshnessRule = defineRule({
         status: "warn",
         score: 0.6,
         rationale: `${usedField} is ${ageDays} days old. Refresh within a year for best AI ranking.`,
+        rationale_ko: `${usedField}\uC774 ${ageDays}\uC77C \uB410\uC2B5\uB2C8\uB2E4. AI \uC21C\uC704\uB97C \uC720\uC9C0\uD558\uB824\uBA74 1\uB144 \uC774\uB0B4\uB85C \uAC31\uC2E0\uD558\uC138\uC694.`,
         evidence: { ageDays, field: usedField },
         estimatedImpact: 2
       };
@@ -1454,6 +1537,7 @@ var contentFreshnessRule = defineRule({
       status: "warn",
       score: 0.2,
       rationale: `${usedField} is ${ageDays} days old (>2 years). AI engines treat this as stale.`,
+      rationale_ko: `${usedField}\uC774 ${ageDays}\uC77C \uB410\uC2B5\uB2C8\uB2E4 (2\uB144 \uCD08\uACFC). AI \uC5D4\uC9C4\uC774 \uC624\uB798\uB41C \uCF58\uD150\uCE20\uB85C \uAC04\uC8FC\uD569\uB2C8\uB2E4.`,
       evidence: { ageDays, field: usedField },
       fixHint: "Update content and bump dateModified to today's date.",
       estimatedImpact: 3
@@ -1485,22 +1569,25 @@ var singleH1Rule = defineRule({
   effort: "low",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntsingle-h1",
   title: "Exactly one <h1>",
+  title_ko: "<h1> \uD0DC\uADF8 1\uAC1C \uC5EC\uBD80",
   description: "A single H1 tells AI engines the primary topic of the page without ambiguity.",
   run(ctx) {
     const n = ctx.$("h1").length;
-    if (n === 1) return { status: "pass", score: 1, rationale: "Exactly one <h1>." };
+    if (n === 1) return { status: "pass", score: 1, rationale: "Exactly one <h1>.", rationale_ko: "<h1>\uC774 \uC815\uD655\uD788 1\uAC1C\uC785\uB2C8\uB2E4." };
     if (n === 0) {
       return {
         status: "fail",
         score: 0,
         rationale: "No <h1> on the page.",
+        rationale_ko: "\uD398\uC774\uC9C0\uC5D0 <h1>\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
         fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules/cnt.single-h1.md"
       };
     }
     return {
       status: "warn",
       score: Math.max(0.3, 1 / n),
-      rationale: `Found ${n} <h1> tags; prefer one primary heading.`
+      rationale: `Found ${n} <h1> tags; prefer one primary heading.`,
+      rationale_ko: `<h1>\uC774 ${n}\uAC1C \uC788\uC2B5\uB2C8\uB2E4. \uB300\uD45C \uC81C\uBAA9 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.`
     };
   }
 });
@@ -1516,6 +1603,7 @@ var headingHierarchyRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntheading-hierarchy",
   title: "Heading levels do not skip",
+  title_ko: "\uC81C\uBAA9 \uB2E8\uACC4 \uC21C\uC11C \uC900\uC218 \uC5EC\uBD80",
   description: "Going from H2 directly to H4 breaks the outline AI engines use to segment content.",
   run(ctx) {
     const levels = [];
@@ -1525,7 +1613,7 @@ var headingHierarchyRule = defineRule({
       if (m?.[1]) levels.push(parseInt(m[1], 10));
     });
     if (levels.length === 0) {
-      return { status: "skip", score: 0, rationale: "No headings found." };
+      return { status: "skip", score: 0, rationale: "No headings found.", rationale_ko: "\uC81C\uBAA9 \uD0DC\uADF8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     }
     const skips = [];
     for (let i = 1; i < levels.length; i++) {
@@ -1534,12 +1622,13 @@ var headingHierarchyRule = defineRule({
       if (curr > prev + 1) skips.push({ from: prev, to: curr });
     }
     if (skips.length === 0) {
-      return { status: "pass", score: 1, rationale: "No heading-level skips." };
+      return { status: "pass", score: 1, rationale: "No heading-level skips.", rationale_ko: "\uC81C\uBAA9 \uB2E8\uACC4\uAC00 \uC21C\uC11C\uB300\uB85C \uC0AC\uC6A9\uB429\uB2C8\uB2E4." };
     }
     return {
       status: "warn",
       score: Math.max(0.3, 1 - skips.length / levels.length),
       rationale: `${skips.length} heading skip(s) detected (e.g. h${skips[0].from}\u2192h${skips[0].to}).`,
+      rationale_ko: `\uC81C\uBAA9 \uB2E8\uACC4 \uAC74\uB108\uB700\uC774 ${skips.length}\uAC1C \uAC10\uC9C0\uB429\uB2C8\uB2E4 (\uC608: h${skips[0].from}\u2192h${skips[0].to}).`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1556,11 +1645,12 @@ var imageAltRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntimage-alt",
   title: "\u226580% of <img> have alt text",
+  title_ko: "<img>\uC758 80% \uC774\uC0C1 alt \uD14D\uC2A4\uD2B8 \uBCF4\uC720 \uC5EC\uBD80",
   description: "Alt text gives AI engines a textual anchor for visual content and improves accessibility.",
   run(ctx) {
     const imgs = ctx.$("img");
     const total = imgs.length;
-    if (total === 0) return { status: "skip", score: 0, rationale: "No <img> on the page." };
+    if (total === 0) return { status: "skip", score: 0, rationale: "No <img> on the page.", rationale_ko: "\uD398\uC774\uC9C0\uC5D0 <img>\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." };
     let withAlt = 0;
     imgs.each((_i, el) => {
       const alt = ctx.$(el).attr("alt");
@@ -1568,12 +1658,13 @@ var imageAltRule = defineRule({
     });
     const ratio = withAlt / total;
     if (ratio >= 0.8) {
-      return { status: "pass", score: 1, rationale: `${withAlt}/${total} images have alt (${Math.round(ratio * 100)}%).` };
+      return { status: "pass", score: 1, rationale: `${withAlt}/${total} images have alt (${Math.round(ratio * 100)}%).`, rationale_ko: `\uC774\uBBF8\uC9C0 ${total}\uAC1C \uC911 ${withAlt}\uAC1C\uC5D0 alt\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${Math.round(ratio * 100)}%).` };
     }
     return {
       status: "warn",
       score: ratio,
       rationale: `Only ${withAlt}/${total} images have alt text (${Math.round(ratio * 100)}%). Aim for \u226580%.`,
+      rationale_ko: `\uC774\uBBF8\uC9C0 ${total}\uAC1C \uC911 ${withAlt}\uAC1C\uB9CC alt \uD14D\uC2A4\uD2B8\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${Math.round(ratio * 100)}%). 80% \uC774\uC0C1\uC744 \uBAA9\uD45C\uB85C \uD558\uC138\uC694.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1590,11 +1681,12 @@ var tldrOrFaqRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cnttldr-or-faq",
   title: "TL;DR summary or FAQ block",
+  title_ko: "TL;DR \uC694\uC57D \uB610\uB294 FAQ \uBE14\uB85D \uC874\uC7AC \uC5EC\uBD80",
   description: 'AI engines strongly prefer content with a quotable summary or FAQ \u2014 it makes the page "citation-ready".',
   run(ctx) {
     for (const node of flattenJsonLd(ctx.jsonLd)) {
       if (getTypes(node).includes("FAQPage")) {
-        return { status: "pass", score: 1, rationale: "FAQPage schema present." };
+        return { status: "pass", score: 1, rationale: "FAQPage schema present.", rationale_ko: "FAQPage \uC2A4\uD0A4\uB9C8\uAC00 \uC788\uC2B5\uB2C8\uB2E4." };
       }
     }
     const sel = [
@@ -1607,12 +1699,13 @@ var tldrOrFaqRule = defineRule({
       "[data-tldr]"
     ].join(", ");
     if (ctx.$(sel).length > 0) {
-      return { status: "pass", score: 0.85, rationale: "TL;DR / summary / FAQ region detected by selector." };
+      return { status: "pass", score: 0.85, rationale: "TL;DR / summary / FAQ region detected by selector.", rationale_ko: "TL;DR / \uC694\uC57D / FAQ \uC601\uC5ED\uC774 \uAC10\uC9C0\uB429\uB2C8\uB2E4." };
     }
     return {
       status: "warn",
       score: 0,
       rationale: "No TL;DR / summary / FAQ found; add one to boost AI citation odds.",
+      rationale_ko: "TL;DR / \uC694\uC57D / FAQ\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uC778\uC6A9 \uAC00\uB2A5\uC131\uC744 \uB192\uC774\uB824\uBA74 \uCD94\uAC00\uD558\uC138\uC694.",
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1629,6 +1722,7 @@ var wordCountRule = defineRule({
   effort: "high",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntword-count",
   title: "Page has enough body text",
+  title_ko: "\uCDA9\uBD84\uD55C \uBCF8\uBB38 \uD14D\uC2A4\uD2B8 \uC5EC\uBD80",
   description: "Thin pages (under ~100 words) are rarely cited by AI engines. Aim for \u2265300 words of meaningful body copy.",
   run(ctx) {
     const $ = ctx.$;
@@ -1636,12 +1730,13 @@ var wordCountRule = defineRule({
     clone.find("script, style, noscript, nav, header, footer, aside").remove();
     const text = clone.text().replace(/\s+/g, " ").trim();
     const words = text ? text.split(" ").length : 0;
-    if (words >= 300) return { status: "pass", score: 1, rationale: `${words} words of body text.` };
-    if (words >= 100) return { status: "warn", score: 0.5, rationale: `Only ${words} words; aim for 300+.` };
+    if (words >= 300) return { status: "pass", score: 1, rationale: `${words} words of body text.`, rationale_ko: `\uBCF8\uBB38 \uD14D\uC2A4\uD2B8\uAC00 ${words}\uB2E8\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.` };
+    if (words >= 100) return { status: "warn", score: 0.5, rationale: `Only ${words} words; aim for 300+.`, rationale_ko: `${words}\uB2E8\uC5B4\uBC16\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4. 300\uB2E8\uC5B4 \uC774\uC0C1\uC744 \uBAA9\uD45C\uB85C \uD558\uC138\uC694.` };
     return {
       status: "fail",
       score: 0,
       rationale: `Only ${words} words; too thin to be cited.`,
+      rationale_ko: `${words}\uB2E8\uC5B4\uBC16\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uC5D4\uC9C4\uC774 \uC778\uC6A9\uD558\uAE30\uC5D4 \uB108\uBB34 \uC801\uC2B5\uB2C8\uB2E4.`,
       fixUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md"
     };
   }
@@ -1692,11 +1787,12 @@ var qaStructureRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntqa-structure",
   title: "Content uses Q&A structure for answer extraction",
+  title_ko: "\uB2F5\uBCC0 \uCD94\uCD9C\uC744 \uC704\uD55C Q&A \uAD6C\uC870 \uC0AC\uC6A9 \uC5EC\uBD80",
   description: "Question-style H2/H3 headings (or FAQPage JSON-LD) help AI engines extract direct answers. Pages with \u22652 question headings are far more likely to be cited.",
   run(ctx) {
     for (const node of flattenJsonLd(ctx.jsonLd)) {
       if (getTypes(node).includes("FAQPage")) {
-        return { status: "pass", score: 1, rationale: "FAQPage JSON-LD provides explicit Q&A." };
+        return { status: "pass", score: 1, rationale: "FAQPage JSON-LD provides explicit Q&A.", rationale_ko: "FAQPage JSON-LD\uB85C \uBA85\uC2DC\uC801\uC778 Q&A \uAD6C\uC870\uAC00 \uC788\uC2B5\uB2C8\uB2E4." };
       }
     }
     const questionHeadings = [];
@@ -1709,6 +1805,7 @@ var qaStructureRule = defineRule({
         status: "pass",
         score: 1,
         rationale: `${questionHeadings.length} question-style headings detected.`,
+        rationale_ko: `\uC9C8\uBB38\uD615 \uC81C\uBAA9\uC774 ${questionHeadings.length}\uAC1C \uAC10\uC9C0\uB429\uB2C8\uB2E4.`,
         evidence: { headings: questionHeadings.slice(0, 5) }
       };
     }
@@ -1717,6 +1814,7 @@ var qaStructureRule = defineRule({
         status: "warn",
         score: 0.6,
         rationale: "1 question-style heading. Add a second to strengthen answer extraction.",
+        rationale_ko: "\uC9C8\uBB38\uD615 \uC81C\uBAA9\uC774 1\uAC1C\uC785\uB2C8\uB2E4. \uB2F5\uBCC0 \uCD94\uCD9C \uAC15\uD654\uB97C \uC704\uD574 \uD558\uB098 \uB354 \uCD94\uAC00\uD558\uC138\uC694.",
         evidence: { headings: questionHeadings },
         estimatedImpact: 1
       };
@@ -1725,6 +1823,7 @@ var qaStructureRule = defineRule({
       status: "warn",
       score: 0,
       rationale: "No question-style H2/H3 headings or FAQPage JSON-LD found.",
+      rationale_ko: "\uC9C8\uBB38\uD615 H2/H3 \uC81C\uBAA9\uC774\uB098 FAQPage JSON-LD\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
       fixHint: 'Reframe at least 2 H2 headings as questions ("How do I\u2026?", "What is\u2026?") or add FAQPage JSON-LD.',
       estimatedImpact: 3
     };
@@ -1742,13 +1841,14 @@ var externalCitationsRule = defineRule({
   effort: "medium",
   docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#cntexternal-citations",
   title: "Content cites external sources",
+  title_ko: "\uC678\uBD80 \uCD9C\uCC98 \uC778\uC6A9 \uC5EC\uBD80",
   description: "Outbound links to authoritative external sources are an E-E-A-T trust signal. AI engines treat well-cited pages as more credible.",
   run(ctx) {
     let host;
     try {
       host = new URL(ctx.finalUrl).hostname.toLowerCase();
     } catch {
-      return { status: "skip", score: 0, rationale: "Invalid finalUrl." };
+      return { status: "skip", score: 0, rationale: "Invalid finalUrl.", rationale_ko: "\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 finalUrl\uC785\uB2C8\uB2E4." };
     }
     const seen = /* @__PURE__ */ new Set();
     ctx.$("main a[href], article a[href], body a[href]").each((_i, el) => {
@@ -1773,6 +1873,7 @@ var externalCitationsRule = defineRule({
         status: "pass",
         score: 1,
         rationale: `${count} distinct external host(s) cited (excluding nofollow).`,
+        rationale_ko: `\uC678\uBD80 \uC0AC\uC774\uD2B8 ${count}\uAC1C\uB97C \uC778\uC6A9\uD569\uB2C8\uB2E4 (nofollow \uC81C\uC678).`,
         evidence: { hosts: [...seen].slice(0, 8) }
       };
     }
@@ -1781,6 +1882,7 @@ var externalCitationsRule = defineRule({
         status: "pass",
         score: 0.7,
         rationale: `${count} external host(s) cited. Aim for \u22653 for stronger E-E-A-T.`,
+        rationale_ko: `\uC678\uBD80 \uC0AC\uC774\uD2B8 ${count}\uAC1C\uB97C \uC778\uC6A9\uD569\uB2C8\uB2E4. E-E-A-T \uAC15\uD654\uB97C \uC704\uD574 3\uAC1C \uC774\uC0C1\uC744 \uBAA9\uD45C\uB85C \uD558\uC138\uC694.`,
         evidence: { hosts: [...seen] },
         estimatedImpact: 1
       };
@@ -1789,6 +1891,7 @@ var externalCitationsRule = defineRule({
       status: "warn",
       score: 0,
       rationale: "No external follow citations found in main content.",
+      rationale_ko: "\uBCF8\uBB38\uC5D0 \uC678\uBD80 \uCD9C\uCC98 \uB9C1\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
       fixHint: "Cite at least one authoritative external source (research paper, official docs, news outlet).",
       estimatedImpact: 2
     };
@@ -1806,12 +1909,130 @@ var contentRules = [
   externalCitationsRule
 ];
 
+// src/rules/aeo/skill-md.ts
+var aeoSkillMdRule = defineRule({
+  id: "aeo.skill-md",
+  stableId: "aeo.skill-md",
+  category: "aeo",
+  group: "opportunity",
+  weight: 3,
+  impact: "high",
+  effort: "low",
+  docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#aeoskill-md",
+  title: "skill.md is present",
+  title_ko: "skill.md \uD30C\uC77C \uC874\uC7AC \uC5EC\uBD80",
+  description: "A /skill.md file describes site capabilities so AI agents know what this site can do for them.",
+  run(ctx) {
+    if (ctx.skillMd !== null) {
+      return {
+        status: "pass",
+        score: 1,
+        rationale: "skill.md found at site root.",
+        rationale_ko: "skill.md\uAC00 \uC0AC\uC774\uD2B8 \uB8E8\uD2B8\uC5D0 \uC874\uC7AC\uD569\uB2C8\uB2E4."
+      };
+    }
+    return {
+      status: "warn",
+      score: 0,
+      rationale: "No /skill.md found. Add one to describe your site capabilities to AI agents.",
+      rationale_ko: "/skill.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uC5D0\uC774\uC804\uD2B8\uAC00 \uC0AC\uC774\uD2B8 \uAE30\uB2A5\uC744 \uD30C\uC545\uD560 \uC218 \uC788\uB3C4\uB85D \uCD94\uAC00\uD558\uC138\uC694.",
+      fixHint: "Create /skill.md listing what services, products, and capabilities this site offers."
+    };
+  }
+});
+
+// src/rules/aeo/agent-permissions.ts
+var aeoAgentPermissionsRule = defineRule({
+  id: "aeo.agent-permissions",
+  stableId: "aeo.agent-permissions",
+  category: "aeo",
+  group: "opportunity",
+  weight: 3,
+  impact: "medium",
+  effort: "low",
+  docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#aeoagent-permissions",
+  title: "agent-permissions.json is present",
+  title_ko: "agent-permissions.json \uD30C\uC77C \uC874\uC7AC \uC5EC\uBD80",
+  description: "Declares explicit read/summarize/cite/train permissions for AI agents.",
+  run(ctx) {
+    if (ctx.agentPermissions !== null) {
+      return {
+        status: "pass",
+        score: 1,
+        rationale: "agent-permissions.json found at site root.",
+        rationale_ko: "agent-permissions.json\uC774 \uC0AC\uC774\uD2B8 \uB8E8\uD2B8\uC5D0 \uC874\uC7AC\uD569\uB2C8\uB2E4.",
+        evidence: ctx.agentPermissions
+      };
+    }
+    return {
+      status: "warn",
+      score: 0,
+      rationale: "No /agent-permissions.json found. Add one to declare AI agent access policy.",
+      rationale_ko: "/agent-permissions.json\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. AI \uC5D0\uC774\uC804\uD2B8 \uC811\uADFC \uC815\uCC45\uC744 \uBA85\uC2DC\uD558\uB824\uBA74 \uCD94\uAC00\uD558\uC138\uC694.",
+      fixHint: "Create /agent-permissions.json with read, summarize, cite, and train permission flags."
+    };
+  }
+});
+
+// src/rules/aeo/token-length.ts
+var THRESHOLD_OPTIMAL = 15e3;
+var THRESHOLD_MAX = 25e3;
+var aeoTokenLengthRule = defineRule({
+  id: "aeo.token-length",
+  stableId: "aeo.token-length",
+  category: "aeo",
+  group: "diagnostic",
+  weight: 4,
+  impact: "medium",
+  effort: "medium",
+  docsUrl: "https://github.com/BaRam-OSS/geo-checker/blob/main/docs/rules.md#aeotoken-length",
+  title: "Content token length within AI agent limits",
+  title_ko: "\uCF58\uD150\uCE20 \uD1A0\uD070 \uC218 AI \uC5D0\uC774\uC804\uD2B8 \uAD8C\uC7A5 \uBC94\uC704",
+  description: "Pages under 15K tokens are optimal for AI agents (per Addy Osmani's AEO guidance).",
+  run(ctx) {
+    const text = ctx.$("body").text();
+    const tokenEstimate = Math.round(text.length / 3);
+    const evidence = { tokenEstimate, thresholds: { optimal: THRESHOLD_OPTIMAL, max: THRESHOLD_MAX } };
+    if (tokenEstimate <= THRESHOLD_OPTIMAL) {
+      return {
+        status: "pass",
+        score: 1,
+        rationale: `Estimated ~${tokenEstimate.toLocaleString()} tokens \u2014 within optimal range.`,
+        rationale_ko: `\uC608\uC0C1 \uD1A0\uD070 \uC218 ~${tokenEstimate.toLocaleString()} \u2014 \uAD8C\uC7A5 \uBC94\uC704(15K) \uC774\uB0B4\uC785\uB2C8\uB2E4.`,
+        evidence
+      };
+    }
+    if (tokenEstimate <= THRESHOLD_MAX) {
+      return {
+        status: "warn",
+        score: 0.5,
+        rationale: `Estimated ~${tokenEstimate.toLocaleString()} tokens \u2014 exceeds 15K recommendation.`,
+        rationale_ko: `\uC608\uC0C1 \uD1A0\uD070 \uC218 ~${tokenEstimate.toLocaleString()} \u2014 15K \uAD8C\uC7A5\uCE58\uB97C \uCD08\uACFC\uD569\uB2C8\uB2E4.`,
+        fixHint: "Consider splitting content into shorter, focused pages.",
+        evidence
+      };
+    }
+    return {
+      status: "fail",
+      score: 0,
+      rationale: `Estimated ~${tokenEstimate.toLocaleString()} tokens \u2014 exceeds 25K agent processing limit.`,
+      rationale_ko: `\uC608\uC0C1 \uD1A0\uD070 \uC218 ~${tokenEstimate.toLocaleString()} \u2014 AI \uC5D0\uC774\uC804\uD2B8 \uCC98\uB9AC \uD55C\uACC4(25K)\uB97C \uCD08\uACFC\uD569\uB2C8\uB2E4.`,
+      fixHint: "Split this page into multiple focused pages under 15K tokens.",
+      evidence
+    };
+  }
+});
+
+// src/rules/aeo/index.ts
+var aeoRules = [aeoSkillMdRule, aeoAgentPermissionsRule, aeoTokenLengthRule];
+
 // src/rules/index.ts
 var defaultRules = [
   ...crawlerRules,
   ...structuredDataRules,
   ...citationRules,
-  ...contentRules
+  ...contentRules,
+  ...aeoRules
 ];
 
 // src/config.ts
@@ -2007,7 +2228,8 @@ var CATEGORY_LABELS = {
   crawler: "AI Crawler Access",
   "structured-data": "Structured Data",
   citation: "Citation Signals",
-  content: "Content Structure"
+  content: "Content Structure",
+  aeo: "AEO Stack"
 };
 function scoreBadge(score) {
   const color = score >= 85 ? "brightgreen" : score >= 60 ? "yellow" : "red";