Communitygithub.com

Astro SEO网站构建器

使用Astro、Tailwind CSS、内容集合及可选的Turso数据库构建完整的、SEO优化的网站。当用户想要创建网站、构建能在谷歌排名的网站、启动Astro项目、制作落地页、搭建企业网站、创建博客或任何需要SEO的Web项目时使用此技能。

Astro SEO网站构建器 是什么?

该技能旨在帮助用户快速构建部署就绪、搜索引擎优化的Astro网站。它提供了一套完整的工作流程,涵盖需求调研、项目搭建、页面设计、内容管理、数据库集成以及最终部署准备。技能的核心优势在于强制性的设计规范(通过`references/taste-skill.md`避免“AI垃圾”输出)和全面的SEO检查,确保每个页面都拥有正确的元标签、结构化数据、语义化HTML和真实的有研究价值的内容。支持Astro、React、Tailwind CSS、Astro Content Collections,并可选集成Turso和Drizzle用于动态数据处理。该技能通过分阶段引导用户,从发现与研究到部署审核,确保项目高质量交付。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/IncomeStreamSurfer/astro-builder-skill/tree/HEAD/skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Astro SEO 网站构建器

你将使用 Astro 构建完整、可直接部署且经过 SEO 优化、旨在 Google 获得排名的网站。每个网站都带有正确的元标签、结构化数据、语义化 HTML、优化后的图片、站点地图,以及真实有研究价值的内容——绝非占位文本。

你制作的每个前端界面都必须是高品质且非千篇一律的。在编写任何 UI 代码前,请阅读 references/taste-skill.md——其中包含了避免生成通用“AI垃圾”输出的设计规则。

技术栈

  • Astro — 静态优先框架,默认零 JavaScript,完美 SEO
  • React — 通过 Astro islands 实现交互式组件(表单、导航、动画)
  • Tailwind CSS — 所有样式。不使用 shadcn 默认值——根据 taste-skill 规则自定义所有内容
  • Astro Content Collections — 类型安全的 Markdown/MDX 内容,用于博客文章、服务、客户评价
  • Turso + Drizzle — 边缘 SQLite 数据库(可选,用于表单/动态数据)

工作流概览

每个项目都遵循以下顺序。不要跳过任何步骤。

第一阶段:发现与研究

  1. 询问用户的细分市场、业务和目标
  2. 询问是否需要数据库(用于联系表单、线索、预订等)
  3. 研究细分市场——哪些页面排名靠前,哪些关键词重要,存在哪些内容缺口
  4. 提出网站结构建议,包含页面列表、内容策略和关键词目标
  5. 在构建前获得用户批准

第二阶段:项目设置

  1. 搭建 Astro 项目
  2. 安装并配置集成(React、Tailwind、sitemap)
  3. 设置基础布局、SEO 组件和设计系统

第三阶段:构建每个页面

  1. 阅读 references/taste-skill.md 了解设计规则
  2. 如果用户想要生成图片,请阅读 references/image-generation.md 并为每个页面生成图片
  3. 使用真实且有研究价值的内容创建每个页面
  4. 在每个页面上实施完整 SEO——元标签、OG 标签、结构化数据、语义化 HTML
  5. 连接交互式组件(表单、导航等)

第四阶段:内容集合与数据库

  1. 为博客文章、服务等配置 Astro 内容集合
  2. 如果请求了数据库:设置 Turso,创建模式,构建 API 路由
  3. 如果适用,为数据库数据构建管理后台

第五阶段:部署准备

  1. 生成站点地图、robots.txt
  2. 配置部署(Vercel/Netlify)
  3. 对每个页面进行最终 SEO 审核

第一阶段:发现与研究

询问用户

在编写任何代码之前,需要了解项目:

  1. 你的细分市场/业务是什么? ——“我是都柏林的一名水管工”或“我在线销售手工蜡烛”
  2. 网站的主要目标是什么? ——线索生成、电商、作品集、博客、SaaS 落地页
  3. 你想要多少页面? ——小型(5-10 页)或内容密集型(15-30+ 页含博客)
  4. 你需要数据库吗? ——用于存储表单提交、预订、用户数据等。如果需要,设置 Turso。
  5. 你想要生成图片吗? ——“我可以使用 Gemini 为你的网站生成自定义图库图片。如果你愿意,请将你的 GEMINI_API_KEY 添加到 .env 文件中。”
  6. 你有域名吗? ——站点地图/规范 URL 需要。如果尚未购买,请使用占位符。
  7. 有设计偏好吗? ——颜色、风格、现有品牌标识

研究细分市场

使用网络搜索查找:

  • 当前排名靠前的内容 ——目标关键词的前 5-10 个结果
  • 内容缺口 ——哪些问题未能得到很好的解答
  • 长尾关键词 ——竞争较少的具体短语
  • 本地 SEO 信号 ——如果是本地企业
  • 竞争对手网站结构 ——他们有哪些页面,缺少什么

提出网站结构

基于研究,创建一个具体的方案。以水管工为例:

建议页面:
1. 首页 — "都柏林水管工 | 24/7 紧急管道服务"
2. 服务 — 所有服务概览
3. 服务/紧急管道 — 定向落地页
4. 服务/浴室翻新 — 定向落地页
5. 服务/锅炉维修 — 定向落地页
6. 关于我们 — 信任信号、团队、资质
7. 博客 — 持续的 SEO 内容
8. 博客/[slug] — 针对长尾关键词的单篇文章
9. 联系我们 — 表单 + 地图 + 电话
10. 服务区域 — 本地 SEO 页面
11. 客户评价 — 社交证明

目标关键词:都柏林紧急水管工、都柏林附近水管工、都柏林锅炉维修...
内容策略:每周发布针对“如何修复 [常见问题]”类查询的博客文章

在继续之前获得用户批准。


第二阶段:项目设置

阅读 references/astro-setup.md 了解确切的命令和配置。

1. 创建项目

npm create astro@latest [项目名称] -- --template minimal --install --no-git
cd [项目名称]

2. 安装集成

npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono  # 根据 taste-skill 使用高级字体

3. 如果需要数据库

阅读 references/turso-setup.md 了解完整的 Turso 配置。

npm install @libsql/client drizzle-orm

4. 项目结构

src/
├── components/
│   ├── SEOHead.astro
│   ├── Header.astro
│   ├── Footer.astro
│   ├── Navigation.tsx    # React island
│   └── ContactForm.tsx   # React island
├── content.config.ts     # 内容集合模式(不在 content/ 中)
├── content/
│   ├── blog/
│   ├── services/
│   └── testimonials/
├── layouts/
│   └── BaseLayout.astro
├── lib/
│   ├── turso.ts          # 如果使用数据库
│   └── utils.ts
├── pages/
│   ├── index.astro
│   ├── about.astro
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro
│   │   └── [...slug].astro
│   └── api/              # API 路由(如果使用数据库)
├── styles/
│   └── globals.css
└── middleware.ts
astro.config.mjs

第三阶段:构建每个页面——设计 + SEO

在编写任何页面之前,请阅读以下两个文件:

  • references/seo-checklist.md ——每个页面的 SEO 规则
  • references/taste-skill.md ——防止生成通用输出的设计规则

SEOHead 组件

创建 src/components/SEOHead.astro ——位于每个页面的 <head> 中。处理:

  • 标题标签(每个页面唯一,包含主要关键词,不超过 60 个字符)
  • 元描述(唯一,包含行动号召,不超过 160 个字符)
  • 规范 URL
  • Open Graph 标签
  • Twitter Card 标签
  • JSON-LD 结构化数据

查看 references/seo-checklist.md 获取确切的组件代码。

内容编写规则

  • 首先为人类写作,其次才是搜索引擎。
  • **每个页面针对一个特定的关键词簇。**主要关键词出现在标题、H1、第一段、元描述、URL 别名中。
  • **正确的标题层级。**一个 H1。H2 用于各部分。H3 用于子部分。切勿跳过层级。
  • **内部链接。**每个页面链接到 2-3+ 个其他页面。使用描述性锚文本。
  • **图片 alt 文本。**每张图片附带描述性的 alt 文本,自然融入关键词。
  • **内容长度。**服务页面:800-1500 字。博客文章:1500-3000 字。首页:500-1000 字。
  • **Schema 标记。**每个页面获取适当的 JSON-LD。

设计规则(来自 taste-skill)

这些是你构建每个页面时必须遵守的规则:

  • **排版:**使用 Geist、Satoshi、Outfit 或 Cabinet Grotesk。绝不使用 Inter。标题:text-4xl md:text-6xl tracking-tighter leading-none。
  • **颜色:**最多 1 种强调色,饱和度 < 80%。没有紫色/蓝色的 AI 渐变。中性基底(Zinc/Slate)。
  • **布局:**当 DESIGN_VARIANCE > 4 时,不采用居中英雄区。使用分屏、不对称或左对齐布局。
  • **卡片:**仅在通过抬高高度传达层级关系时使用。没有通用的三列卡片布局。
  • **间距:**使用 min-h-[100dvh] 而不是 h-screen。使用 Grid 而不是 flexbox 数学计算。max-w-7xl mx-auto。
  • **状态:**每个交互式组件都需要加载状态、空状态和错误状态。
  • **避免 AI 垃圾:**无表情符号,无“John Doe”,无“Acme Corp”,无“无缝”、“释放”等填充词。

用于交互性的 Astro Islands

  • 静态内容(标题、文本、图片)—— .astro 组件,零 JavaScript
  • 交互式元素(表单、移动端导航、滚动动画)—— React .tsx,带有 client:visible 或 client:load
  • **动画:**对于运动效果(MOTION_INTENSITY > 5),在独立的 React islands 中使用 Framer Motion。弹簧物理学:type: "spring", stiffness: 100, damping: 20。

阅读 references/tailwind-components.md 了解组件模式(导航、表单、常见问题解答等)。


第四阶段:内容集合与数据库

Astro 内容集合

阅读 references/content-collections.md 了解完整设置。内容集合替代了 CMS——内容以 Markdown 文件形式存在于 src/content/ 中,并带有类型安全的模式。

**重要:**在 src/content.config.ts 中定义模式(不要使用 src/content/config.ts —— 旧路径在 Astro v5+ 中会引发 LegacyContentConfigError)。每个集合都必须有一个 loader(使用 astro/loaders 中的 glob())。

在 src/content.config.ts 中定义模式:

  • **博客文章:**标题、描述、发布日期、图片、标签、作者、草稿状态
  • **服务:**标题、描述、图标、排序、精选
  • **客户评价:**姓名、角色、引用、评分

在页面中使用 getCollection() 和 getEntry() 查询集合。

Turso 数据库(如果请求)

阅读 references/turso-setup.md 了解完整设置。Turso 处理动态数据——表单提交、线索、预订、新闻通讯注册。

  1. 在 src/lib/turso.ts 中创建数据库客户端
  2. 使用 Drizzle ORM 定义模式
  3. 在 src/pages/api/ 中为表单处理创建 API 路由
  4. 构建管理后台以查看已提交的数据

管理后台(如果使用了数据库)

使用带有 Tailwind 样式表格和卡片的 React islands 在 /admin 路径下构建。使用:

  • 用于基本身份验证的中间件
  • 从 Turso 获取数据的 API 路由
  • 干净、有品味的数据呈现(根据 taste-skill 规则——不使用通用卡片网格)

第五阶段:部署准备

站点地图与 Robots.txt

@astrojs/sitemap 自动生成站点地图。在 astro.config.mjs 中设置 site。

在 src/pages/robots.txt.ts 中创建动态 robots.txt:

import type { APIRoute } from 'astro';

const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;

export const GET: APIRoute = ({ site }) => {
  return new Response(getRobotsTxt(site?.toString() || ''));
};

部署配置

阅读 references/deployment.md 了解 Vercel/Netlify 的配置。

对于包含 API 路由或 Turso 的网站,添加适配器但保持默认的静态输出。使用 export const prerender = false; 标记单个服务器路由:

import vercel from '@astrojs/vercel';

export default defineConfig({
  // 不要使用 output: 'hybrid' —— 已在 Astro v5 中移除。
  // 默认是 'static'。服务器渲染的路由会单独选择退出。
  adapter: vercel(),
});

在每个 API 路由或服务器渲染的页面中:

// src/pages/api/contact.ts
export const prerender = false; // 此路由在服务器上运行

export const POST: APIRoute = async ({ request }) => {
  // ...
};

最终 SEO 审核

根据 references/seo-checklist.md 审核每个页面:

  • 每个页面有唯一的标题、描述、规范 URL
  • 所有图片都有 alt 文本
  • JSON-LD 验证通过
  • 内部链接正常工作
  • 移动端响应式(测试 taste-skill 移动端覆盖规则)
  • 站点地图包含所有页面
  • robots.txt 正确

重要说明

  • 不要使用 output: 'hybrid' ——它已在 Astro v5 中移除。使用默认的 'static' 输出。对于服务器渲染的路由(API 端点、表单处理程序),在每个文件中添加 export const prerender = false;。
  • React islands 需要水合指令 ——client:load 或 client:visible。
  • **内容集合基于文件。**博客文章和服务作为 .md 文件存在于 src/content/ 中。Turso 仅用于动态数据(如表单提交)。
  • **先研究再构建。**细分市场调研阶段决定了 SEO 质量。
  • **真实内容至上。**编写有实质内容、有帮助的内容。不要使用 lorem ipsum。
  • **始终追求高品质设计。**遵循 taste-skill 规则。每个页面看起来都像代理公司花费 10,000 美元构建的,而不是通用的 AI 输出。
  • **图片生成是可选的。**如果用户提供了 GEMINI_API_KEY,请按照 references/image-generation.md 生成自定义图片。如果没有,则使用带有适当 alt 文本的样式化占位符 div。

相关技能