【免费下载链接】blumeThe open-source docs framework for humans and agents.项目地址https://gitcode.com/gh_mirrors/blum/blume点击查看免费下载Blume 是一个面向人类与 AI Agent 的开源文档框架它把文档 SEO 需要的四大件——Open Graph 社交分享图、Sitemap 站点地图、RSS 订阅源与 JSON-LD 结构化数据——全部做成了构建时自动生成的内置能力。你只需配置好站点地址Blume 就会在每次构建时为你写好这些文件甚至内置blume audit命令帮你逐项体检 SEO 健康度。本文带你完整了解这套文档 SEO 方案零基础也能快速上手。一、先理解 Blume 的 SEO 自动机制 Blume 的 SEO 能力集中在配置文件的seo区块见 config-input.ts并与deployment.site站点地址联动Sitemap 与 RSS需要绝对 URL设置站点地址后默认开启Open Graph 图片在检测到站点地址后自动启用og:image必须是绝对地址才对爬虫有效JSON-LD 结构化数据则无条件默认开启。如果你的项目部署在 Vercel、Netlify 或 Cloudflare 上Blume 还能自动从托管平台探测站点地址无需手写。下面的社交分享卡就是 Blume 为官网首页自动生成的 Open Graph 图片效果二、一键生成 Open Graph 社交分享图每个页面都有专属卡片当文档链接被分享到社交平台时一张 1200×630 的精美卡片直接决定了点击率。Blume 在构建时为每个页面渲染一张社交卡片无需无头浏览器底层采用 Takumi 渲染构建依然飞快。关键特性一览能力说明卡片来源页面标题作主标题、页面描述作副标题、主题色作点缀图片地址/og/slug.png与页面路由一一对应品牌定制seo.og.logo指定本地 SVGseo.og.palette调整配色多语言内置 Google Noto 回退字体栈中日韩、阿拉伯文、印地文标题不再变豆腐块单页覆盖在页面 frontmatter 中写seo.image即可使用自定义图构建缓存卡片按内容哈希缓存只重绘变化过的页面自定义页面.astro没有 frontmatter 可读可用seo.og.titles按路由命名卡片标题避免/cli被渲染成难看的 Cli。 提示如果你配置了theme.fonts生成的卡片会自动跟随主题字体分享图与站点视觉天然一致零额外配置。详细配置参见官方文档 open-graph.mdx。三、Sitemap 与 robots.txt 自动生成让爬虫按图索骥搜索引擎与 AI 爬虫都从站点根目录的两个文件起步Blume 每次构建都会替你写好实现见 sitemap.ts 与 robots.tssitemap.xml列出所有可索引页面并自动排除草稿draft、隐藏页hidden与noindex页面seo.canonical指向其他 URL 的页面只收录规范地址避免重复收录版本化站点中已被 canonical 指向新版本文档的旧版页面。当 URL 数量超过 50,000 条时Blume 会自动将sitemap.xml转换为站点地图索引加多个分片文件避免被搜索引擎直接拒收。robots.txt则允许全部爬虫附加Sitemap:指向行并带有一行新兴的Content-Signal声明告诉 AI 爬虫如何使用你的文档User-agent: * Content-Signal: searchyes, ai-inputyes, ai-trainyes Allow: /这是 Blume为人与 Agent 而建理念的体现——你可以用agents.contentSignals精细控制是否允许 AI 检索search、检索增强ai-input与模型训练ai-train比如只开放前两者而关闭训练。如果你已有自己的public/sitemap.xml或public/robots.txtBlume 不会覆盖——手动文件永远优先。四、内置 RSS 订阅源博客与 Changelog 自动出 Feed有日期型内容的站点天然适合订阅。Blume 为seo.rss.types中声明的每种内容类型各生成一个 Feed默认是blog和changelog托管在/type/rss.xml实现见 rss.ts。每条 Feed 最多 50 条seo.rss.limit可调按时间倒序自动跳过草稿与隐藏页条目链接使用站点绝对 URL页面head中自动注入link relalternate浏览器与 Feed 阅读器无需手动订阅地址即可发现 FeedAI Agent 也能通过可读性清单找到它们。注意Feed 链接必须是绝对地址因此 RSS 同样依赖deployment.site本地blume dev时则由开发服务器地址临时顶上本地预览完全可用。五、JSON-LD 结构化数据让搜索引擎读懂你的内容Blume 在每个页面的head中注入 schema.org JSON-LD核心实现见 jsonld.ts由graph组织多个节点WebSite 节点站点身份需要站点地址才输出因为依赖绝对标识符页面节点首页是WebPage博客文章是BlogPostingChangelog 与文档页是TechArticle自动携带标题、描述、语言inLanguage、发布日期与修改日期datePublished/dateModified日期取自 frontmatter 与lastModifiedBreadcrumbList 节点由侧边栏导航路径自动构建为文章页生成符合 Google 要求的面包屑列表。更进一步Blume 提供两个可选的身份区块让 AI Agent 在推荐或引用你的文档前能核实你是谁seo.organization在每个页面输出Organization节点——名称、Logo、邮箱与电话生成ContactPoint、地址生成PostalAddress、社交档案sameAs这正是企业核验检查的字段seo.software在首页输出SoftwareApplication节点——产品名、描述、应用分类、运行环境、许可证price: 0会生成免费的Offer并把组织作为publisher关联。两个区块都需要deployment.site节点携带绝对id。想全部使用默认值直接写software: true即可。六、用 blume audit 做 SEO 体检 ✅配置完成后运行blume audit即可对已部署站点做全面 SEO 巡检社交卡片检查逐页校验og:title、og:type、og:description有站点地址时还包括og:url是否齐全缺失项会精确报出检查逻辑见 social.tsSitemap 检查验证收录完整性并识别被收录却 canonical 指向别处这类违规还包括 robots 规则、hreflang 语言标注、Open Graph 图片、LLMS 排除等一系列文档可发现性检查。把 audit 接入 CI就能在每次发布前自动拦截 SEO 回归。七、核心文件速查 模块文件路径SEO 配置定义og / rss / organization / softwareconfig-input.tsJSON-LD 图构建seo/jsonld.ts元标签管理拒绝重复 tagseo/metatags.tsSitemap 生成deploy/sitemap.tsRSS Feed 构建deploy/rss.tsOG 卡片渲染og/card.ts非拉丁字体推导og/derive.ts官方文档Open Graphopen-graph.mdx官方文档Sitemap 与 robotssitemap-and-robots.mdx官方文档RSSrss.mdx官方文档结构化数据structured-data.mdx八、上手清单三步完成文档 SEO 配置设置站点地址配置deployment.site或依赖托管平台自动探测这是 Sitemap、RSS 与绝对 URL 的地基按需微调在seo区块定制 OG 卡片配色与 Logo、组织/软件身份节点、Feed 类型与条数跑一次审计执行blume audit逐项确认社交卡片、站点地图与 robots 声明全部绿灯。至此你的文档站已具备完整的文档 SEO 能力每次分享都有专属社交卡片每个页面都带结构化数据每个 Feed 都自动可发现——而这一切Blume 在构建时就替你完成了。赞分享【免费下载链接】blumeThe open-source docs framework for humans and agents.项目地址https://gitcode.com/gh_mirrors/blum/blume点击查看免费下载相关推荐Next.js SEO终极指南动态Open Graph图片和自动sitemap配置Next.js SEO终极指南动态Open Graph图片和自动sitemap配置 在当今竞争激烈的网络环境中SEO优化已成为每个网站成功的关键因素。对于N前端示例工程后端Next.js 中集成 next-seo默认 SEO、Open Graph 与 JSON-LD 结构化数据的完整示例解析Next.js 中集成 next seo默认 SEO、Open Graph 与 JSON LD 结构化数据的完整示例解析 在 Next.js 应用中统一管理前端后端Web框架SSR前端构建深度剖析blocks.so的SEO工程JSON-LD结构化数据、Sitemap与RSS自动生成实现深度剖析blocks.so的SEO工程JSON LD结构化数据、Sitemap与RSS自动生成实现 blocks.so 是基于 React Tailwin前端UI组件设计系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考