llmo-checker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ken Imoto and contributors to the Open LLMO Research Initiative
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/open-llmo/llmo-checker/main/assets/banner.svg" alt="llmo-checker — Lighthouse-style CLI for AI-retrievability scoring. Part of the Open LLMO Research Initiative." width="100%">
+</p>
+
+# llmo-checker
+
+> LLMO Score checker — measures AI-retrieval readiness of a URL.
+> Part of the [Open LLMO Research Initiative](https://llmoframework.com).
+
+[![CI](https://github.com/open-llmo/llmo-checker/actions/workflows/ci.yml/badge.svg)](https://github.com/open-llmo/llmo-checker/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/llmo-checker.svg)](https://www.npmjs.com/package/llmo-checker)
+[![npm downloads](https://img.shields.io/npm/dm/llmo-checker.svg)](https://www.npmjs.com/package/llmo-checker)
+[![node](https://img.shields.io/node/v/llmo-checker.svg)](https://nodejs.org)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+`llmo-checker` is a Lighthouse-style CLI that scores how "AI-retrievable" a given URL is. It fetches the page, runs a small set of static checks, and returns a JSON report with a single LLMO Score (0-100) plus per-check scores and notes.
+
+It is intentionally **not** a full AI-citation simulator. It measures the *substrate* — the structured signals an AI crawler can extract without running an LLM — so that page authors get a fast, reproducible signal before paying for citation simulations.
+
+## Status
+
+**v0.1 — Draft.** Score weights, check list, and JSON schema may change in v0.2. Pin a specific version if you depend on the JSON shape.
+
+## Install / Run
+
+> **Note:** The npm publish is pending account verification. Until the npm release lands, install directly from GitHub.
+
+Run from GitHub with `npx` (no clone needed):
+
+```bash
+npx github:open-llmo/llmo-checker https://example.com
+npx github:open-llmo/llmo-checker https://example.com --json
+```
+
+Once published, the same commands work without the `github:` prefix:
+
+```bash
+npx llmo-checker https://example.com           # after npm publish
+npx llmo-checker https://example.com --json
+```
+
+Or clone and run locally:
+
+```bash
+git clone https://github.com/open-llmo/llmo-checker.git
+cd llmo-checker
+npm install
+npm run dev https://example.com
+```
+
+Requires Node.js 20+.
+
+## What it checks (v0.1)
+
+| Check | Weight | What it measures |
+|---|---|---|
+| `llms-txt` | 20 | Presence and structure of `/llms.txt` per [llmstxt.org](https://llmstxt.org/) |
+| `robots-ai` | 15 | Explicit posture toward known AI crawlers in `/robots.txt` (GPTBot, ClaudeBot, CCBot, Google-Extended, PerplexityBot, etc.) |
+| `canonical` | 15 | `<link rel="canonical">` correctness and hreflang alternates |
+| `jsonld` | 20 | JSON-LD structured data presence, parseability, and recognized schema.org `@type`s |
+| `meta` | 15 | `<title>` / `<meta name="description">` / OpenGraph / `<h1>` / `<html lang>` |
+
+Total weight in v0.1 is **85** (scores normalize to 0-100). Citation Visibility and Chunk Readability are planned for v0.2.
+
+## Score bands
+
+| Band | Score | Meaning |
+|---|---|---|
+| Green | 85-100 | Well-grounded for AI retrieval |
+| Yellow | 65-84 | Needs work — several signals missing or weak |
+| Yellow | 40-64 | Poor — significant grounding gaps |
+| Red | 0-39 | Critical — page is largely invisible to AI crawlers |
+
+## JSON output
+
+```bash
+npx llmo-checker https://example.com --json
+```
+
+```json
+{
+  "url": "https://example.com/",
+  "origin": "https://example.com",
+  "timestamp": "2026-05-24T10:00:00.000Z",
+  "checkerVersion": "0.1.0",
+  "scoreVersion": "0.1",
+  "score": 72,
+  "checks": [
+    {
+      "id": "llms-txt",
+      "name": "llms.txt presence and structure",
+      "status": "pass",
+      "score": 100,
+      "weight": 20,
+      "details": { "...": "..." },
+      "notes": []
+    }
+  ]
+}
+```
+
+Each check exits with one of `pass` / `warn` / `fail` / `skip`. The CLI exits with status `0` if the overall score is ≥ 50, `1` otherwise, and `2` on fetch errors.
+
+## Score v0.1 indicator set (Draft)
+
+These are the indicator categories the v0.1 score covers. Inclusion does not imply causation with downstream AI citation — they are *necessary substrate signals* that have a clear definition.
+
+- Citation Visibility — whether AI assistants cite the URL (planned v0.2, requires probing)
+- Chunk Readability — heuristic readability of extracted chunks (planned v0.2)
+- Semantic Structure — JSON-LD, OpenGraph, heading hierarchy (covered by `jsonld` and `meta`)
+- AI Crawlability — robots.txt posture toward known AI bots (covered by `robots-ai`)
+- llms.txt — covered by `llms-txt`
+- Markdown Quality — applies only when the page has a Markdown source (planned v0.2)
+- Entity Clarity — JSON-LD `@type` Organization / Person / Book recognition (partially covered by `jsonld`)
+
+The full draft spec lives at <https://llmoframework.com/en/experimental-projects/>.
+
+## Development
+
+```bash
+git clone https://github.com/open-llmo/llmo-checker.git
+cd llmo-checker
+npm install
+npm run dev https://example.com
+npm test
+npm run build
+```
+
+## Contributing
+
+This is an early Draft. Issues and PRs welcome at <https://github.com/open-llmo/llmo-checker/issues>.
+
+If you want to propose a new check, open an issue with:
+- the signal name and what it measures
+- why it predicts AI-retrieval readiness (a paper, a public experiment, or a Lighthouse-style argument)
+- proposed weight and scoring rule
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Founded and maintained by [Ken Imoto](https://kenimoto.dev) as part of the Open LLMO Research Initiative.

package/dist/check.d.ts

@@ -0,0 +1,5 @@
+import type { CheckerReport } from "./types.js";
+export declare const CHECKER_VERSION = "0.1.0";
+export declare const SCORE_VERSION: "0.1";
+export declare function runChecks(rawUrl: string): Promise<CheckerReport>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,aAAa,EAAG,KAAc,CAAC;AAE5C,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqCtE"}

package/dist/check.js

@@ -0,0 +1,42 @@
+import { checkLlmsTxt } from "./checks/llms-txt.js";
+import { checkRobotsAi } from "./checks/robots-ai.js";
+import { checkCanonical } from "./checks/canonical.js";
+import { checkJsonLd } from "./checks/jsonld.js";
+import { checkMeta } from "./checks/meta.js";
+import { computeScore } from "./score.js";
+export const CHECKER_VERSION = "0.1.0";
+export const SCORE_VERSION = "0.1";
+export async function runChecks(rawUrl) {
+    const url = new URL(rawUrl).toString();
+    const origin = new URL(rawUrl).origin;
+    const res = await fetch(url, {
+        headers: {
+            "User-Agent": "llmo-checker/0.1.0 (+https://llmoframework.com)",
+            Accept: "text/html,application/xhtml+xml",
+        },
+        redirect: "follow",
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch ${url}: HTTP ${res.status}`);
+    }
+    const html = await res.text();
+    const ctx = { url, origin, html, fetch };
+    const [llms, robots, canonical, jsonld, meta] = await Promise.all([
+        checkLlmsTxt(ctx),
+        checkRobotsAi(ctx),
+        Promise.resolve(checkCanonical(ctx)),
+        Promise.resolve(checkJsonLd(ctx)),
+        Promise.resolve(checkMeta(ctx)),
+    ]);
+    const checks = [llms, robots, canonical, jsonld, meta];
+    return {
+        url,
+        origin,
+        timestamp: new Date().toISOString(),
+        checkerVersion: CHECKER_VERSION,
+        scoreVersion: SCORE_VERSION,
+        score: computeScore(checks),
+        checks,
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAc,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAEtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE;YACP,YAAY,EAAE,iDAAiD;YAC/D,MAAM,EAAE,iCAAiC;SAC1C;QACD,QAAQ,EAAE,QAAQ;KACnB,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,MAAM,GAAG,GAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAEvD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChE,YAAY,CAAC,GAAG,CAAC;QACjB,aAAa,CAAC,GAAG,CAAC;QAClB,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEvD,OAAO;QACL,GAAG;QACH,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,cAAc,EAAE,eAAe;QAC/B,YAAY,EAAE,aAAa;QAC3B,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/checks/canonical.d.ts

@@ -0,0 +1,3 @@
+import type { CheckContext, CheckResult } from "../types.js";
+export declare function checkCanonical(ctx: CheckContext): CheckResult;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/checks/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/checks/canonical.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CA2C7D"}

package/dist/checks/canonical.js

@@ -0,0 +1,50 @@
+import * as cheerio from "cheerio";
+export function checkCanonical(ctx) {
+    const $ = cheerio.load(ctx.html);
+    const notes = [];
+    const details = {};
+    const canonical = $('link[rel="canonical"]').attr("href")?.trim();
+    details.canonical = canonical ?? null;
+    if (!canonical) {
+        notes.push("Missing <link rel=\"canonical\">. AI crawlers may dedupe wrong URL.");
+        return result("fail", 0, details, notes);
+    }
+    let absolute;
+    try {
+        absolute = new URL(canonical, ctx.url);
+    }
+    catch {
+        notes.push(`Canonical href is not a valid URL: ${canonical}`);
+        return result("fail", 20, details, notes);
+    }
+    details.canonicalAbsolute = absolute.toString();
+    const here = new URL(ctx.url);
+    const matchesOrigin = absolute.origin === here.origin;
+    details.matchesOrigin = matchesOrigin;
+    if (!matchesOrigin) {
+        notes.push(`Canonical points to a different origin (${absolute.origin}). Intentional only if this page is a republished mirror.`);
+        return result("warn", 60, details, notes);
+    }
+    const hreflang = $('link[rel="alternate"][hreflang]')
+        .map((_, el) => $(el).attr("hreflang"))
+        .get();
+    details.hreflangCount = hreflang.length;
+    let score = 90;
+    if (hreflang.length > 0)
+        score += 10;
+    else
+        notes.push("No hreflang alternates — fine for single-language sites.");
+    return result("pass", Math.min(score, 100), details, notes);
+}
+function result(status, score, details, notes) {
+    return {
+        id: "canonical",
+        name: "Canonical URL and hreflang",
+        status,
+        score,
+        weight: 15,
+        details,
+        notes,
+    };
+}
+//# sourceMappingURL=canonical.js.map

package/dist/checks/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/checks/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,MAAM,UAAU,cAAc,CAAC,GAAiB;IAC9C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IAClE,OAAO,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,CAAC;IAEtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,QAAa,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,iBAAiB,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAEhD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;IACtD,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAEtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,2CAA2C,QAAQ,CAAC,MAAM,2DAA2D,CACtH,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,CAAC,iCAAiC,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;SACtC,GAAG,EAAE,CAAC;IACT,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;IAExC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,IAAI,EAAE,CAAC;;QAChC,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAE5E,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,MAAM,CACb,MAAgC,EAChC,KAAa,EACb,OAAgC,EAChC,KAAe;IAEf,OAAO;QACL,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,4BAA4B;QAClC,MAAM;QACN,KAAK;QACL,MAAM,EAAE,EAAE;QACV,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/checks/jsonld.d.ts

@@ -0,0 +1,3 @@
+import type { CheckContext, CheckResult } from "../types.js";
+export declare function checkJsonLd(ctx: CheckContext): CheckResult;
+//# sourceMappingURL=jsonld.d.ts.map

package/dist/checks/jsonld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.d.ts","sourceRoot":"","sources":["../../src/checks/jsonld.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkB7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAgD1D"}

package/dist/checks/jsonld.js

@@ -0,0 +1,96 @@
+import * as cheerio from "cheerio";
+const ENTITY_TYPES = [
+    "Organization",
+    "Person",
+    "Article",
+    "BlogPosting",
+    "TechArticle",
+    "Book",
+    "WebSite",
+    "WebPage",
+    "BreadcrumbList",
+    "FAQPage",
+    "HowTo",
+    "Product",
+    "SoftwareApplication",
+];
+export function checkJsonLd(ctx) {
+    const $ = cheerio.load(ctx.html);
+    const notes = [];
+    const blocks = [];
+    const types = new Set();
+    let parseErrors = 0;
+    $('script[type="application/ld+json"]').each((_, el) => {
+        const raw = $(el).contents().text();
+        if (!raw.trim())
+            return;
+        try {
+            const parsed = JSON.parse(raw);
+            blocks.push(parsed);
+            collectTypes(parsed, types);
+        }
+        catch {
+            parseErrors += 1;
+        }
+    });
+    const details = {
+        blockCount: blocks.length,
+        typesFound: [...types],
+        parseErrors,
+    };
+    if (blocks.length === 0) {
+        notes.push("No JSON-LD found. Entity grounding will rely on text alone.");
+        return result("fail", 0, details, notes);
+    }
+    if (parseErrors > 0) {
+        notes.push(`${parseErrors} JSON-LD block(s) failed to parse.`);
+    }
+    const recognized = [...types].filter((t) => ENTITY_TYPES.includes(t));
+    details.recognizedTypes = recognized;
+    let score = 50;
+    score += Math.min(recognized.length * 12, 36);
+    if (types.has("Organization") || types.has("Person"))
+        score += 8;
+    if (parseErrors > 0)
+        score -= 20;
+    score = Math.max(0, Math.min(100, score));
+    const status = score >= 85 ? "pass" : score >= 50 ? "warn" : "fail";
+    if (recognized.length === 0) {
+        notes.push("JSON-LD present but no recognized schema.org entity types.");
+    }
+    return result(status, score, details, notes);
+}
+function collectTypes(node, out) {
+    if (!node)
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node)
+            collectTypes(item, out);
+        return;
+    }
+    if (typeof node !== "object")
+        return;
+    const obj = node;
+    const t = obj["@type"];
+    if (typeof t === "string")
+        out.add(t);
+    else if (Array.isArray(t)) {
+        for (const sub of t)
+            if (typeof sub === "string")
+                out.add(sub);
+    }
+    if ("@graph" in obj)
+        collectTypes(obj["@graph"], out);
+}
+function result(status, score, details, notes) {
+    return {
+        id: "jsonld",
+        name: "JSON-LD structured data",
+        status,
+        score,
+        weight: 20,
+        details,
+        notes,
+    };
+}
+//# sourceMappingURL=jsonld.js.map

package/dist/checks/jsonld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.js","sourceRoot":"","sources":["../../src/checks/jsonld.ts"],"names":[],"mappings":"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"}

package/dist/checks/llms-txt.d.ts

@@ -0,0 +1,3 @@
+import type { CheckContext, CheckResult } from "../types.js";
+export declare function checkLlmsTxt(ctx: CheckContext): Promise<CheckResult>;
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/checks/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../src/checks/llms-txt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAsB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA4D1E"}

package/dist/checks/llms-txt.js

@@ -0,0 +1,69 @@
+export async function checkLlmsTxt(ctx) {
+    const url = `${ctx.origin}/llms.txt`;
+    const notes = [];
+    const details = { url };
+    try {
+        const res = await ctx.fetch(url, {
+            headers: { "User-Agent": "llmo-checker/0.1.0 (+https://llmoframework.com)" },
+        });
+        details.httpStatus = res.status;
+        if (res.status === 404) {
+            notes.push("No /llms.txt found. See https://llmstxt.org/ for the spec.");
+            return result("fail", 0, details, notes);
+        }
+        if (!res.ok) {
+            notes.push(`/llms.txt returned HTTP ${res.status}`);
+            return result("fail", 0, details, notes);
+        }
+        const body = await res.text();
+        const trimmed = body.trim();
+        details.byteLength = body.length;
+        details.lineCount = trimmed.split("\n").length;
+        if (trimmed.length === 0) {
+            notes.push("/llms.txt exists but is empty.");
+            return result("fail", 10, details, notes);
+        }
+        const lines = trimmed.split("\n");
+        const h1 = lines.find((l) => l.startsWith("# "));
+        const linkCount = (body.match(/^- \[/gm) ?? []).length;
+        const sectionCount = (body.match(/^## /gm) ?? []).length;
+        details.hasH1Title = Boolean(h1);
+        details.linkCount = linkCount;
+        details.sectionCount = sectionCount;
+        let score = 60;
+        if (h1)
+            score += 15;
+        else
+            notes.push("Missing top-level `# Title` line.");
+        if (sectionCount > 0)
+            score += 10;
+        else
+            notes.push("No `## Section` headings found — links should be grouped.");
+        if (linkCount >= 3)
+            score += 15;
+        else if (linkCount > 0)
+            score += 8;
+        else {
+            score += 5;
+            notes.push("No `- [Title](url)` link entries. Optional per spec, but link lists help retrieval.");
+        }
+        const status = score >= 85 ? "pass" : score >= 60 ? "warn" : "fail";
+        return result(status, score, details, notes);
+    }
+    catch (err) {
+        notes.push(`Fetch error: ${err.message}`);
+        return result("fail", 0, details, notes);
+    }
+}
+function result(status, score, details, notes) {
+    return {
+        id: "llms-txt",
+        name: "llms.txt presence and structure",
+        status,
+        score,
+        weight: 20,
+        details,
+        notes,
+    };
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/checks/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../../src/checks/llms-txt.ts"],"names":[],"mappings":"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"}

package/dist/checks/meta.d.ts

@@ -0,0 +1,3 @@
+import type { CheckContext, CheckResult } from "../types.js";
+export declare function checkMeta(ctx: CheckContext): CheckResult;
+//# sourceMappingURL=meta.d.ts.map

package/dist/checks/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/checks/meta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAsExD"}

package/dist/checks/meta.js

@@ -0,0 +1,72 @@
+import * as cheerio from "cheerio";
+export function checkMeta(ctx) {
+    const $ = cheerio.load(ctx.html);
+    const notes = [];
+    const title = $("head > title").first().text().trim();
+    const description = $('meta[name="description"]').attr("content")?.trim() ?? "";
+    const ogTitle = $('meta[property="og:title"]').attr("content")?.trim() ?? "";
+    const ogDescription = $('meta[property="og:description"]').attr("content")?.trim() ?? "";
+    const ogType = $('meta[property="og:type"]').attr("content")?.trim() ?? "";
+    const h1Count = $("h1").length;
+    const lang = $("html").attr("lang")?.trim() ?? "";
+    const details = {
+        title,
+        titleLength: title.length,
+        description,
+        descriptionLength: description.length,
+        ogTitle,
+        ogDescription,
+        ogType,
+        h1Count,
+        htmlLang: lang,
+    };
+    let score = 0;
+    if (title) {
+        if (title.length >= 20 && title.length <= 70)
+            score += 20;
+        else {
+            score += 10;
+            notes.push(`Title length ${title.length} is outside the 20-70 sweet spot.`);
+        }
+    }
+    else {
+        notes.push("Missing <title>.");
+    }
+    if (description) {
+        if (description.length >= 80 && description.length <= 200)
+            score += 20;
+        else {
+            score += 10;
+            notes.push(`Description length ${description.length} is outside the 80-200 sweet spot.`);
+        }
+    }
+    else {
+        notes.push("Missing <meta name=\"description\">.");
+    }
+    if (ogTitle && ogDescription)
+        score += 20;
+    else
+        notes.push("Missing OpenGraph title/description.");
+    if (ogType)
+        score += 10;
+    if (h1Count === 1)
+        score += 20;
+    else
+        notes.push(`Found ${h1Count} <h1> elements (recommended: exactly 1).`);
+    if (lang)
+        score += 10;
+    else
+        notes.push("Missing <html lang=\"...\"> attribute.");
+    score = Math.min(score, 100);
+    const status = score >= 85 ? "pass" : score >= 60 ? "warn" : "fail";
+    return {
+        id: "meta",
+        name: "Semantic metadata and headings",
+        status,
+        score,
+        weight: 15,
+        details,
+        notes,
+    };
+}
+//# sourceMappingURL=meta.js.map

package/dist/checks/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/checks/meta.ts"],"names":[],"mappings":"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"}

package/dist/checks/robots-ai.d.ts

@@ -0,0 +1,3 @@
+import type { CheckContext, CheckResult } from "../types.js";
+export declare function checkRobotsAi(ctx: CheckContext): Promise<CheckResult>;
+//# sourceMappingURL=robots-ai.d.ts.map

package/dist/checks/robots-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots-ai.d.ts","sourceRoot":"","sources":["../../src/checks/robots-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB7D,wBAAsB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAwD3E"}

package/dist/checks/robots-ai.js

@@ -0,0 +1,105 @@
+const AI_BOTS = [
+    "GPTBot",
+    "ChatGPT-User",
+    "OAI-SearchBot",
+    "ClaudeBot",
+    "Claude-Web",
+    "anthropic-ai",
+    "CCBot",
+    "Google-Extended",
+    "PerplexityBot",
+    "Applebot-Extended",
+    "cohere-ai",
+];
+export async function checkRobotsAi(ctx) {
+    const url = `${ctx.origin}/robots.txt`;
+    const notes = [];
+    const details = { url, knownAiBots: AI_BOTS };
+    try {
+        const res = await ctx.fetch(url, {
+            headers: { "User-Agent": "llmo-checker/0.1.0 (+https://llmoframework.com)" },
+        });
+        details.httpStatus = res.status;
+        if (res.status === 404) {
+            notes.push("No /robots.txt found. AI crawlers will use default allow, but explicit posture is recommended.");
+            return result("warn", 60, details, notes);
+        }
+        if (!res.ok) {
+            notes.push(`/robots.txt returned HTTP ${res.status}`);
+            return result("fail", 0, details, notes);
+        }
+        const body = await res.text();
+        details.byteLength = body.length;
+        const mentioned = [];
+        const disallowed = [];
+        const groups = parseRobotsGroups(body);
+        for (const bot of AI_BOTS) {
+            const lower = bot.toLowerCase();
+            const group = groups.find((g) => g.userAgents.some((u) => u.toLowerCase() === lower));
+            if (!group)
+                continue;
+            mentioned.push(bot);
+            if (group.disallows.some((d) => d.trim() === "/")) {
+                disallowed.push(bot);
+            }
+        }
+        details.mentionedBots = mentioned;
+        details.disallowedBots = disallowed;
+        details.hasWildcardUserAgent = groups.some((g) => g.userAgents.includes("*"));
+        let score = 70;
+        if (mentioned.length >= 3)
+            score += 20;
+        else if (mentioned.length > 0)
+            score += 10;
+        else
+            notes.push("No explicit AI-bot rules in robots.txt.");
+        if (groups.length > 0 && details.hasWildcardUserAgent)
+            score += 10;
+        const status = score >= 85 ? "pass" : score >= 60 ? "warn" : "fail";
+        return result(status, Math.min(score, 100), details, notes);
+    }
+    catch (err) {
+        notes.push(`Fetch error: ${err.message}`);
+        return result("fail", 0, details, notes);
+    }
+}
+function parseRobotsGroups(body) {
+    const groups = [];
+    let current = null;
+    for (const rawLine of body.split("\n")) {
+        const line = rawLine.replace(/#.*$/, "").trim();
+        if (!line)
+            continue;
+        const idx = line.indexOf(":");
+        if (idx < 0)
+            continue;
+        const key = line.slice(0, idx).trim().toLowerCase();
+        const value = line.slice(idx + 1).trim();
+        if (key === "user-agent") {
+            if (!current || current.disallows.length > 0 || current.allows.length > 0) {
+                current = { userAgents: [], disallows: [], allows: [] };
+                groups.push(current);
+            }
+            current.userAgents.push(value);
+        }
+        else if (key === "disallow" && current) {
+            current.disallows.push(value);
+        }
+        else if (key === "allow" && current) {
+            current.allows.push(value);
+        }
+    }
+    return groups;
+}
+function result(status, score, details, notes) {
+    return {
+        id: "robots-ai",
+        name: "AI crawler posture (robots.txt)",
+        status,
+        score,
+        weight: 15,
+        details,
+        notes,
+    };
+}
+//# sourceMappingURL=robots-ai.js.map

package/dist/checks/robots-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots-ai.js","sourceRoot":"","sources":["../../src/checks/robots-ai.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import pc from "picocolors";
+import { CHECKER_VERSION, runChecks } from "./check.js";
+const program = new Command();
+program
+    .name("llmo-checker")
+    .description("LLMO Score checker — measures AI-retrieval readiness of a URL.\n" +
+    "Part of the Open LLMO Research Initiative (https://llmoframework.com).")
+    .version(CHECKER_VERSION)
+    .argument("<url>", "URL to check (must include https://)")
+    .option("--json", "output JSON report only (no pretty print)")
+    .action(async (rawUrl, options) => {
+    try {
+        const report = await runChecks(rawUrl);
+        if (options.json) {
+            process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+        }
+        else {
+            printPretty(report);
+        }
+        process.exit(report.score >= 50 ? 0 : 1);
+    }
+    catch (err) {
+        console.error(pc.red(`Error: ${err.message}`));
+        process.exit(2);
+    }
+});
+program.parseAsync(process.argv);
+function printPretty(report) {
+    const out = process.stdout;
+    const band = scoreBand(report.score);
+    out.write(`\n${pc.bold("LLMO Score")}  ${band.color(`${report.score}/100`)}  ${pc.dim(band.label)}\n`);
+    out.write(`${pc.dim(`url: ${report.url}`)}\n`);
+    out.write(`${pc.dim(`checker: v${report.checkerVersion}  score: v${report.scoreVersion}`)}\n\n`);
+    for (const c of report.checks) {
+        out.write(`${statusBadge(c)} ${pc.bold(c.name)}  ${pc.dim(`${c.score}/100 · weight ${c.weight}`)}\n`);
+        for (const note of c.notes) {
+            out.write(`    ${pc.dim("·")} ${note}\n`);
+        }
+    }
+    out.write("\n");
+    out.write(`${pc.dim("Full audit (measured AI-citation rates, GA4/GSC analysis, prioritized roadmap): https://propel-lab.co.jp/llmo-audit")}\n\n`);
+}
+function statusBadge(c) {
+    switch (c.status) {
+        case "pass":
+            return pc.green("PASS");
+        case "warn":
+            return pc.yellow("WARN");
+        case "fail":
+            return pc.red("FAIL");
+        default:
+            return pc.dim("SKIP");
+    }
+}
+function scoreBand(score) {
+    if (score >= 85)
+        return { color: pc.green, label: "well-grounded" };
+    if (score >= 65)
+        return { color: pc.yellow, label: "needs work" };
+    if (score >= 40)
+        return { color: pc.yellow, label: "poor" };
+    return { color: pc.red, label: "critical" };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/score.d.ts

@@ -0,0 +1,3 @@
+import type { CheckResult } from "./types.js";
+export declare function computeScore(checks: CheckResult[]): number;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAK1D"}

package/dist/score.js

@@ -0,0 +1,8 @@
+export function computeScore(checks) {
+    const totalWeight = checks.reduce((sum, c) => sum + c.weight, 0);
+    if (totalWeight === 0)
+        return 0;
+    const weighted = checks.reduce((sum, c) => sum + c.score * c.weight, 0);
+    return Math.round(weighted / totalWeight);
+}
+//# sourceMappingURL=score.js.map

package/dist/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export type CheckStatus = "pass" | "warn" | "fail" | "skip";
+export interface CheckResult {
+    id: string;
+    name: string;
+    status: CheckStatus;
+    score: number;
+    weight: number;
+    details: Record<string, unknown>;
+    notes: string[];
+}
+export interface CheckerReport {
+    url: string;
+    origin: string;
+    timestamp: string;
+    checkerVersion: string;
+    score: number;
+    scoreVersion: "0.1";
+    checks: CheckResult[];
+}
+export interface CheckContext {
+    url: string;
+    origin: string;
+    html: string;
+    fetch: typeof fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,KAAK,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "llmo-checker",
+  "version": "0.1.0",
+  "description": "LLMO Score checker — measures AI-retrieval readiness of a URL. Part of the Open LLMO Research Initiative.",
+  "type": "module",
+  "bin": {
+    "llmo-checker": "./dist/cli.js"
+  },
+  "main": "./dist/check.js",
+  "exports": {
+    ".": "./dist/check.js",
+    "./cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "llmo",
+    "ai-seo",
+    "llms.txt",
+    "ai-crawler",
+    "grounding",
+    "citation",
+    "lighthouse"
+  ],
+  "author": "Ken Imoto <ken@propel-lab.com> (https://kenimoto.dev)",
+  "license": "MIT",
+  "homepage": "https://llmoframework.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-llmo/llmo-checker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/open-llmo/llmo-checker/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "cheerio": "^1.0.0",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}