switch SEO tool from OpenAI SDK to Vercel AI SDK

Refactored the summary/index.js to use the Vercel AI SDK instead of
the OpenAI SDK directly. This allows easily swapping between AI
providers:

- Defaults to Claude (Anthropic) if ANTHROPIC_API_KEY is set
- Falls back to GPT-5 mini if only OPENAI_API_KEY is available
- Removed direct openai dependency, now uses @ai-sdk/openai
- Added ai, @ai-sdk/anthropic, @ai-sdk/openai as devDependencies
- Updated README to document the new provider options

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: btholt

README.md

@@ -80,7 +80,7 @@ Each of these lessons can have a [frontmatter](https://github.com/jonschlinkert/
 - _description_ – If you want to give individual lessons descriptions for SEO and for Frontend Masters, you can write a brief description here.
 - _keywords_ - If you want to give individual lessons keywords for SEO purposes, write a comma separated list
 
-🤖: now the course starter can auto-generate the description and keywords for you using ChatGPT. See below how to.
+🤖: now the course starter can auto-generate the description and keywords for you using AI (Claude or GPT). See below how to.
 
 Be aware because of how the numbers and letters are stripped out, it is possible to have ambigious paths. `01-welcome/A-intro.md` and `03-welcome/D-intro.md` would resolve to the same thing and only the first one would be visitable.
 
@@ -132,7 +132,7 @@ _Future pushes to the main branch will automatically trigger a new deployment._
 - `npm run start` - Start an already-built server.
 - `npm run csv` – Will generate the CSV of the metadata from your course. Note you may have to run build first, depending on your csvPath.
 - `npm run llm-text` – Will generate the LLM full text of your course - this concatenates all your lessons together into one long text document that students can load into an LLM to get additional help. Also useful for editing - just ask your LLM to look at all the text and fix grammar/spelling/content errors.
-- `npm run seo` – Using ChatGPT, every file that does not have a description, ChatGPT will generate a description and keywords and write them to the file. Requires you to set a valid `OPENAI_API_KEY` (which means having a paid OpenAI account) using a [.env](https://github.com/motdotla/dotenv) or just by setting it in the environment. If a description already exists, this will skip it.
+- `npm run seo` – Using AI, every file that does not have a description will have a description and keywords generated and written to the file. Set either `ANTHROPIC_API_KEY` (for Claude, preferred) or `OPENAI_API_KEY` (for GPT-5 mini) using a [.env](https://github.com/motdotla/dotenv) file or by setting it in the environment. If both are set, Claude is used. If a description already exists, this will skip it.
 
 ## Analytics
 

package-lock.json

@@ -23,9 +23,11 @@
     "title-case": "^4.3.2"
   },
   "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.35",
+    "@ai-sdk/openai": "^3.0.25",
+    "ai": "^6.0.68",
     "convert-array-to-csv": "^2.0.0",
     "dotenv": "^17.2.3",
-    "openai": "^6.17.0",
     "zod": "^4.3.6"
   }
 }

package.json

@@ -1,10 +1,11 @@
-import OpenAI from "openai";
+import { generateObject } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+import { openai } from "@ai-sdk/openai";
 import matter from "gray-matter";
 import "dotenv/config";
 import fs from "fs/promises";
 import { getLesson, getLessons } from "../data/lesson.js";
-import { zodResponseFormat } from "openai/helpers/zod";
-import getPrompt from "./getSystemPrompt.js";
+import getPrompt from "./getPrompt.js";
 import assert from "assert";
 import path from "path";
 import { z } from "zod";
@@ -17,13 +18,27 @@ const configBuffer = await fs.readFile(
 );
 const config = JSON.parse(configBuffer);
 
-const openai = new OpenAI();
+// Determine which provider to use based on available API keys
+// Defaults to Anthropic (Claude), falls back to OpenAI
+const useAnthropic = !!process.env.ANTHROPIC_API_KEY;
+const useOpenAI = !!process.env.OPENAI_API_KEY;
 
 assert(
-  process.env.OPENAI_API_KEY,
-  "OPENAI_API_KEY must exist. Either pass it in via the environment or define it in the .env file"
+  useAnthropic || useOpenAI,
+  "Either ANTHROPIC_API_KEY or OPENAI_API_KEY must be set. Pass it via the environment or define it in a .env file"
 );
 
+// Configure the model - prefer Anthropic if available
+const model = useAnthropic
+  ? anthropic("claude-sonnet-4-20250514")
+  : openai("gpt-5-mini");
+
+if (useAnthropic) {
+  console.log("🤖 Using Claude (Anthropic)");
+} else {
+  console.log("🤖 Using GPT-5 mini (OpenAI)");
+}
+
 async function exec() {
   const list = await getLessons();
 
@@ -43,27 +58,19 @@ async function summarize(section, lesson) {
     console.log(`⏺️ ${lesson.fullSlug}`);
   } else {
     try {
-      const completion = await openai.beta.chat.completions.parse({
-        model: "gpt-4o-2024-08-06",
-        messages: [
-          { role: "system", content: getPrompt(config) },
-          {
-            role: "user",
-            content: `The markdown content is: \n\n\n${rendered.markdown}`,
-          },
-        ],
-        response_format: zodResponseFormat(
-          z.object({
-            seoDescription: z.string(),
-            seoKeywords: z.array(z.string()),
-          }),
-          "lesson"
-        ),
+      const { object } = await generateObject({
+        model,
+        system: getPrompt(config),
+        prompt: `The markdown content is: \n\n\n${rendered.markdown}`,
+        schema: z.object({
+          seoDescription: z.string(),
+          seoKeywords: z.array(z.string()),
+        }),
       });
 
       const parsed = {
-        description: completion.choices[0].message.parsed.seoDescription,
-        keywords: completion.choices[0].message.parsed.seoKeywords,
+        description: object.seoDescription,
+        keywords: object.seoKeywords,
       };
 
       const newData = Object.assign({}, data, parsed);