Skip to content

SEO 管理插件 ​

插件信息

名称:SEO 管理插件(seo) 版本:v0.3.1 类型:官方插件 状态:已内置

概述 ​

SEO 管理插件为 MengStack 提供全面的搜索引擎优化能力,包括站点 TDK 配置、TDK 模板生成、动态 Sitemap、Robots.txt 管理、301/302 重定向、内链管理和 JSON-LD 结构化数据。支持 Open Graph 和 Twitter Card 社交分享标签。

功能特性 ​

  • 站点 SEO 配置:全局站点名称、URL、默认 TDK、OG 图片、Twitter 账号
  • TDK 模板生成:GenerateTDK() 为任意页面生成 Title / Description / Keywords / OG / Twitter Card / JSON-LD
  • 动态 Sitemap:GenerateSitemapXML() 生成符合 sitemaps.org 规范的 XML
  • Robots.txt 管理:GenerateRobotsTxt() 根据规则动态生成,自动追加 Sitemap URL
  • 重定向规则:支持 301/302 重定向,默认 301 永久重定向
  • 内链管理:关键词自动链接到目标 URL,可控制单页最大内链数
  • 推送记录:记录向搜索引擎推送 URL 的状态和响应

数据模型 ​

SEO 配置(SeoConfig) ​

字段类型说明
iduuid主键(继承自 BaseModel)
tenant_iduuid租户 ID(继承自 BaseModel)
site_namestring站点名称
site_urlstring站点 URL
default_titlestring默认页面标题
default_descstring默认页面描述
default_keywordsstring默认关键词
default_og_imagestring默认 OG 分享图 URL
twitter_sitestringTwitter 站点账号
twitter_creatorstringTwitter 创作者账号
favicon_urlstringFavicon URL
created_attime创建时间(继承自 BaseModel)
updated_attime更新时间(继承自 BaseModel)
deleted_attime软删除时间(继承自 BaseModel)

Sitemap 条目(SitemapEntry) ​

字段类型说明
iduuid主键
tenant_iduuid租户 ID
locstring页面完整 URL
last_modtime最后修改时间
change_freqstring更新频率:always / hourly / daily / weekly / monthly / yearly / never
priorityfloat优先级(0.0 ~ 1.0)
entity_typestring关联内容类型
entity_iduuid关联内容 ID
created_attime创建时间
updated_attime更新时间
deleted_attime软删除时间

重定向规则(RedirectRule) ​

字段类型说明
iduuid主键
tenant_iduuid租户 ID
source_pathstring源路径
target_pathstring目标路径
status_codeintHTTP 状态码(默认 301)
is_activebool是否启用
created_attime创建时间
updated_attime更新时间
deleted_attime软删除时间
字段类型说明
iduuid主键
tenant_iduuid租户 ID
keywordstring触发关键词
target_urlstring目标 URL
target_titlestring目标标题
max_linksint单页最大链接数(默认 5)
is_activebool是否启用
created_attime创建时间
updated_attime更新时间
deleted_attime软删除时间

Robots 规则(RobotsRule) ​

字段类型说明
iduuid主键
tenant_iduuid租户 ID
user_agentstringUser-Agent(* 表示全部)
pathstring路径
allowbool允许(true)或禁止(false)
sort_orderint排序权重
created_attime创建时间
updated_attime更新时间
deleted_attime软删除时间

推送记录(PushRecord) ​

字段类型说明
iduuid主键
tenant_iduuid租户 ID
urlstring推送的 URL
platformstring推送平台
statusstring状态:pending / success / failed
status_codeint响应状态码
responsetext响应内容
pushed_attime推送时间
created_attime创建时间
updated_attime更新时间
deleted_attime软删除时间

核心方法 ​

GenerateTDK ​

为指定页面生成完整的 SEO 元数据,输出包含:

  • <title> 和 <meta name="description"> / <meta name="keywords">
  • Open Graph 标签(og:title、og:description、og:image、og:url、og:type)
  • Twitter Card 标签(twitter:card、twitter:site、twitter:creator)
  • JSON-LD 结构化数据(schema.org/WebSite)

GenerateSitemapXML ​

生成符合 sitemaps.org 规范的 XML Sitemap,包含 urlset 命名空间,遍历所有 SitemapEntry 输出 <url> 节点。

GenerateRobotsTxt ​

根据 RobotsRule 规则动态生成 robots.txt 内容,按 sort_order 排序,自动在末尾追加 Sitemap: {site_url}/sitemap.xml。

API 接口 ​

公开接口 ​

方法路径说明
GET/api/v1/seo/tdk生成页面 TDK 元数据
GET/api/v1/seo/sitemap.xml获取动态 Sitemap XML
GET/api/v1/seo/robots.txt获取动态 Robots.txt
GET/api/v1/seo/links/active获取启用的内链列表

需认证接口 ​

方法路径权限说明
GET/api/v1/seo/configseo.config.write获取 SEO 配置
PUT/api/v1/seo/configseo.config.write更新 SEO 配置
POST/api/v1/seo/sitemapseo.sitemap.write创建 Sitemap 条目
GET/api/v1/seo/sitemapseo.config.write获取 Sitemap 条目列表
DELETE/api/v1/seo/sitemap/:idseo.sitemap.write删除 Sitemap 条目
POST/api/v1/seo/robotsseo.redirect.write创建 Robots 规则
GET/api/v1/seo/robotsseo.config.write获取 Robots 规则列表
DELETE/api/v1/seo/robots/:idseo.redirect.write删除 Robots 规则
POST/api/v1/seo/redirectsseo.redirect.write创建重定向规则
GET/api/v1/seo/redirectsseo.config.write获取重定向规则列表
PUT/api/v1/seo/redirects/:idseo.redirect.write更新重定向规则
DELETE/api/v1/seo/redirects/:idseo.redirect.write删除重定向规则
POST/api/v1/seo/linksseo.link.write创建内链
GET/api/v1/seo/linksseo.config.write获取内链列表
DELETE/api/v1/seo/links/:idseo.link.write删除内链
GET/api/v1/seo/push-recordsseo.config.write获取推送记录

数据库表 ​

表名说明
seo_configsSEO 配置表
sitemap_entriesSitemap 条目表
push_records推送记录表
robots_rulesRobots 规则表
redirect_rules重定向规则表
internal_links内链表

权限 ​

权限标识说明
seo.config.write管理 SEO 配置
seo.sitemap.write管理 Sitemap
seo.redirect.write管理重定向
seo.link.write管理友链

依赖 ​

  • auth:用户认证
  • rbac:权限模型
  • org:多租户隔离

Released under the Apache 2.0 License.