SuperAPI AI 工具集

seo-best-practices

营销与增长

查看项目

更新于 10-15 17:20

技能介绍

用途:为 React 与 Laravel 构建的 Web 应用提供 SEO 模式、约定与审计清单,可在实现元标签、结构化数据、Core Web Vitals、站点地图、Open Graph 时参考,也可对现有代码库执行 SEO 审计。版本 1.2.0,范围覆盖 Laravel Blade 与 Laravel + Inertia.js + React,共 31 条规则、8 个类别,采用 MIT 许可。

主要能力:规则按优先级分为 Core Web Vitals(LCP<2.5s、INP<200ms、CLS<0.1)、技术 SEO(title、description、canonical、robots.txt、XML 站点地图、URL 结构)、页面内 SEO(标题层级、语义 HTML、内链、图片 alt)、结构化数据(JSON-LD、Article、Product、BreadcrumbList、@graph、FAQ、校验)、性能 SEO(WebP/AVIF、懒加载、字体加载、资源提示)、社交分享(Open Graph、Twitter Card)、React/SPA SEO(SSR/CSR/SSG、动态元标签、路由可抓取)以及移动优先。

使用方式:审计时先确定范围(有参数则只审指定页面或文件,无参数则审全部页面和布局),再检测项目类型——依赖中出现 @inertiajs/react 判为 Laravel + Inertia + React,仅有 resources/views/**/*.blade.php 判为 Laravel Blade——然后逐项输出 PASS、FAIL(含确切 file:line、问题描述与修复建议)或 N/A,最后给出通过/失败/不适用数量与三项最优先修复项。Laravel Blade 的元标签写入 Blade 布局,站点地图用 spatie/laravel-sitemap;Inertia + React 通过布局中的 @inertiaHead 与 React 页面的 <Head> 组件管理元标签,并使用 head-key 属性避免重复。SSR 需创建 resources/js/ssr.jsx(使用 @inertiajs/react/server 的 createServer),在 Vite 配置中加入 ssr: 'resources/js/ssr.jsx',执行 vite build && vite build --ssr,随后运行 php artisan inertia:start-ssr。

适用场景:代码库 SEO 审计、添加元标签、实现 JSON-LD、优化 Core Web Vitals、配置 Open Graph 与 Twitter Card、创建站点地图与 robots.txt、构建对 SEO 友好的 React SPA、配置 Laravel SEO 中间件与包、优化图片字体与加载性能。

限制:仅面向上述 Laravel 技术栈,其他框架未提供;规则细节需查阅 rules/ 目录下各规则文件(如 rules/tech-meta-tags.md),完整合集见 AGENTS.md;具体效果与实施收益资料未提供。