PSEO-AI-Kit：面向AI应用的程序化SEO完整工具链

一个开源的Next.js程序化SEO脚手架，整合了LLM内容生成、SEO验证、内部链接图构建等完整功能，由运营43个以上pSEO站点的开发者开源贡献。

背景：程序化SEO的新挑战\n\n随着AI搜索的兴起，传统的SEO策略正在发生根本性变化。传统的关键词优化已经不足以应对ChatGPT、Claude等大语言模型驱动的搜索场景。在这个背景下，程序化SEO（Programmatic SEO，简称pSEO）结合AI内容生成成为新的趋势。\n\n然而，许多独立开发者和AI应用运营者面临一个共同问题：每个人都在重复构建相同的基础设施。从关键词列表到LLM内容生成，从站点地图到JSON-LD结构化数据，再到内部链接图的构建——这些重复性工作消耗了大量时间。\n\n## 项目概述\n\nPSEO-AI-Kit是由swarmclawai组织开源的一套程序化SEO工具包，专为AI应用设计。这个项目的独特之处在于，它并非来自理论推演，而是由一位实际运营43个以上pSEO站点的开发者基于实战经验构建并开源的。\n\n该项目采用Next.js 15 App Router作为基础框架，部署在Vercel平台上，充分利用了现代前端技术栈的优势。同时，它深度集成了大语言模型内容生成能力，支持Anthropic Claude Haiku等模型，让内容创作自动化成为可能。\n\n## 核心功能模块\n\n### 1. 类型安全的内容数据层\n\nPSEO-AI-Kit为生成的每一页内容都定义了严格的Zod Schema验证。这意味着从LLM生成的内容在写入前会经过类型检查，确保数据结构的一致性。内容采用frontmatter + markdown的格式存储，通过gray-matter库实现元数据与正文的分离和重组。\n\n### 2. LLM内容生成器\n\n项目的核心组件是generate.ts，它负责调用Claude Haiku API进行内容生成。该模块会将关键词列表转换为完整的SEO优化文章，每篇文章包含标题、元描述、H1标题、引言、多个章节、FAQ等结构化元素。生成过程支持并发控制，避免API限流。\n\n### 3. SEO基础要素\n\n工具包自动处理所有SEO基础配置：\n- Canonical标签管理\n- 自动生成站点地图（/sitemap.xml）\n- robots.txt配置\n- Open Graph和Twitter Card元标签\n- Article和FAQPage类型的JSON-LD结构化数据\n\n### 4. 内部链接图构建\n\nbuildLinkGraph函数是PSEO-AI-Kit的一大亮点。它会根据关键词重叠度自动计算页面之间的相关性，并在每篇文章底部渲染"相关页面"区块。开发者可以配置每页最大链接数和最低相关性分数阈值，避免低质量链接。\n\n### 5. 内容验证器\n\n在发布前，验证器会执行多项静态SEO检查：\n- 检测重复slug和重复标题\n- 检查标题和描述长度是否符合Google推荐范围\n- 识别内容过于单薄的页面\n- 发现孤立页面（没有内部链接指向的页面）\n\n## 技术架构与实现\n\nPSEO-AI-Kit采用模块化设计，核心命令包括：\n\n| 命令 | 功能 |\n|------|------|\n| pseo-ai init [dir] | 初始化新的pSEO站点 |\n| pseo-ai generate <keywords.txt> | 从关键词列表生成页面 |\n| pseo-ai validate | 执行静态SEO检查 |\n| pseo-ai graph | 打印内部链接图 |\n| pseo-ai help-agents | 输出机器可读的CLI目录 |\n\n每个命令都支持--json参数，返回单行JSON格式的结果，便于与其他工具链集成。退出码设计遵循Unix惯例：0表示成功，1表示用户错误，2表示内部错误。\n\n## 页面内容Schema\n\n生成的每篇文章都遵循统一的Schema结构：\n\ntypescript\n{\n slug: string, // URL友好的短横线格式，全局唯一\n title: string, // 30-60字符，适配SERP显示\n metaDescription: string, // 120-155字符\n h1: string,\n intro: string, // 60-120词\n sections: [{ heading: string, body: string }], // 2-10个章节\n keyword: string,\n relatedKeywords: string[],\n faqs: [{ q: string, a: string }],\n}\n\n\n这种结构化设计不仅有利于SEO，也方便后续的手动编辑和内容迭代。\n\n## 可扩展性设计\n\nPSEO-AI-Kit的ContentClient接口只包含一个generatePage方法，这使得替换底层LLM提供商变得非常简单。无论是切换到OpenAI、本地Ollama模型，还是自定义的内容管道，都只需要实现这一个接口即可。\n\n## 实际应用场景\n\n对于AI应用开发者来说，PSEO-AI-Kit解决了几个关键痛点：\n\n1. 规模化内容生产：通过程序化方式批量生成高质量的SEO内容，而不需要雇佣大量写手。\n2. 技术SEO自动化：自动处理canonical标签、结构化数据、站点地图等技术细节。\n3. 内容质量保证：验证器在发布前捕获常见问题，避免低质量页面上线。\n4. 内部链接优化：自动构建的内部链接图有助于提升整站的权重分布。\n\n## 总结与展望\n\nPSEO-AI-Kit代表了程序化SEO工具的新方向——不仅提供内容生成功能，更关注SEO的技术实现和质量保证。对于希望在AI搜索时代保持可见性的开发者和企业，这类工具将成为基础设施的一部分。\n\n项目的开源性质也意味着社区可以持续贡献改进，从更多实际运营场景中提炼最佳实践。随着AI搜索算法的演进，这类结合LLM和程序化SEO的工具将变得越来越重要。

背景：程序化SEO的新挑战\n\n随着AI搜索的兴起，传统的SEO策略正在发生根本性变化。传统的关键词优化已经不足以应对ChatGPT、Claude等大语言模型驱动的搜索场景。在这个背景下，程序化SEO（Programmatic SEO，简称pSEO）结合AI内容生成成为新的趋势。\n\n然而，许多独立开发者和AI应用运营者面临一个共同问题：每个人都在重复构建相同的基础设施。从关键词列表到LLM内容生成，从站点地图到JSON-LD结构化数据，再到内部链接图的构建——这些重复性工作消耗了大量时间。\n\n项目概述\n\nPSEO-AI-Kit是由swarmclawai组织开源的一套程序化SEO工具包，专为AI应用设计。这个项目的独特之处在于，它并非来自理论推演，而是由一位实际运营43个以上pSEO站点的开发者基于实战经验构建并开源的。\n\n该项目采用Next.js 15 App Router作为基础框架，部署在Vercel平台上，充分利用了现代前端技术栈的优势。同时，它深度集成了大语言模型内容生成能力，支持Anthropic Claude Haiku等模型，让内容创作自动化成为可能。\n\n核心功能模块\n\n1. 类型安全的内容数据层\n\nPSEO-AI-Kit为生成的每一页内容都定义了严格的Zod Schema验证。这意味着从LLM生成的内容在写入前会经过类型检查，确保数据结构的一致性。内容采用frontmatter + markdown的格式存储，通过gray-matter库实现元数据与正文的分离和重组。\n\n2. LLM内容生成器\n\n项目的核心组件是generate.ts，它负责调用Claude Haiku API进行内容生成。该模块会将关键词列表转换为完整的SEO优化文章，每篇文章包含标题、元描述、H1标题、引言、多个章节、FAQ等结构化元素。生成过程支持并发控制，避免API限流。\n\n3. SEO基础要素\n\n工具包自动处理所有SEO基础配置：\n- Canonical标签管理\n- 自动生成站点地图（/sitemap.xml）\n- robots.txt配置\n- Open Graph和Twitter Card元标签\n- Article和FAQPage类型的JSON-LD结构化数据\n\n4. 内部链接图构建\n\nbuildLinkGraph函数是PSEO-AI-Kit的一大亮点。它会根据关键词重叠度自动计算页面之间的相关性，并在每篇文章底部渲染"相关页面"区块。开发者可以配置每页最大链接数和最低相关性分数阈值，避免低质量链接。\n\n5. 内容验证器\n\n在发布前，验证器会执行多项静态SEO检查：\n- 检测重复slug和重复标题\n- 检查标题和描述长度是否符合Google推荐范围\n- 识别内容过于单薄的页面\n- 发现孤立页面（没有内部链接指向的页面）\n\n技术架构与实现\n\nPSEO-AI-Kit采用模块化设计，核心命令包括：\n\n| 命令 | 功能 |\n|------|------|\n| pseo-ai init [dir] | 初始化新的pSEO站点 |\n| pseo-ai generate <keywords.txt> | 从关键词列表生成页面 |\n| pseo-ai validate | 执行静态SEO检查 |\n| pseo-ai graph | 打印内部链接图 |\n| pseo-ai help-agents | 输出机器可读的CLI目录 |\n\n每个命令都支持--json参数，返回单行JSON格式的结果，便于与其他工具链集成。退出码设计遵循Unix惯例：0表示成功，1表示用户错误，2表示内部错误。\n\n页面内容Schema\n\n生成的每篇文章都遵循统一的Schema结构：\n\ntypescript\n{\n slug: string, // URL友好的短横线格式，全局唯一\n title: string, // 30-60字符，适配SERP显示\n metaDescription: string, // 120-155字符\n h1: string,\n intro: string, // 60-120词\n sections: [{ heading: string, body: string }], // 2-10个章节\n keyword: string,\n relatedKeywords: string[],\n faqs: [{ q: string, a: string }],\n}\n\n\n这种结构化设计不仅有利于SEO，也方便后续的手动编辑和内容迭代。\n\n可扩展性设计\n\nPSEO-AI-Kit的ContentClient接口只包含一个generatePage方法，这使得替换底层LLM提供商变得非常简单。无论是切换到OpenAI、本地Ollama模型，还是自定义的内容管道，都只需要实现这一个接口即可。\n\n实际应用场景\n\n对于AI应用开发者来说，PSEO-AI-Kit解决了几个关键痛点：\n\n1. 规模化内容生产：通过程序化方式批量生成高质量的SEO内容，而不需要雇佣大量写手。\n2. 技术SEO自动化：自动处理canonical标签、结构化数据、站点地图等技术细节。\n3. 内容质量保证：验证器在发布前捕获常见问题，避免低质量页面上线。\n4. 内部链接优化：自动构建的内部链接图有助于提升整站的权重分布。\n\n总结与展望\n\nPSEO-AI-Kit代表了程序化SEO工具的新方向——不仅提供内容生成功能，更关注SEO的技术实现和质量保证。对于希望在AI搜索时代保持可见性的开发者和企业，这类工具将成为基础设施的一部分。\n\n项目的开源性质也意味着社区可以持续贡献改进，从更多实际运营场景中提炼最佳实践。随着AI搜索算法的演进，这类结合LLM和程序化SEO的工具将变得越来越重要。