構造化データを腐らせない ── 手書きをやめて、生成と検証にする

type Article = {  slug: string;  title: string;  excerpt: string;  date: string;  dateModified?: string;  author: { name: string; url: string };};
/** 記事データから JSON-LD を生成する。手で書かない。 */export function articleJsonLd(a: Article, siteUrl: string) {  const url = `${siteUrl}/blog/${a.slug}`;  return {    "@context": "https://schema.org",    "@type": "Article",    headline: a.title,          // 本文と同じ値を使う    description: a.excerpt,     // ここも同じ    datePublished: a.date,    dateModified: a.dateModified ?? a.date,    author: {      "@type": "Person",      name: a.author.name,      url: a.author.url,    },    mainEntityOfPage: { "@type": "WebPage", "@id": url },  };}

import { describe, it, expect } from "vitest";
describe("構造化データが本文と一致していること", () => {  it("タイトルが一致する", () => {    const article = getArticle("llmo-09-structured-data-ops");    const jsonLd = articleJsonLd(article, "https://example.com");    expect(jsonLd.headline).toBe(article.title);  });
  it("更新日が本文の更新日以降である", () => {    const article = getArticle("llmo-09-structured-data-ops");    const jsonLd = articleJsonLd(article, "https://example.com");    expect(new Date(jsonLd.dateModified).getTime())      .toBeGreaterThanOrEqual(new Date(article.date).getTime());  });
  it("全記事で必須項目が欠けていない", () => {    for (const article of getAllArticles()) {      const jsonLd = articleJsonLd(article, "https://example.com");      expect(jsonLd.headline, `${article.slug}: headline が空`).toBeTruthy();      expect(jsonLd.author.name, `${article.slug}: author が空`).toBeTruthy();      expect(jsonLd.datePublished, `${article.slug}: 日付が空`).toBeTruthy();    }  });});