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 数据库(可选,用于表单/动态数据)
工作流概览
每个项目都遵循以下顺序。不要跳过任何步骤。
第一阶段:发现与研究
- 询问用户的细分市场、业务和目标
- 询问是否需要数据库(用于联系表单、线索、预订等)
- 研究细分市场——哪些页面排名靠前,哪些关键词重要,存在哪些内容缺口
- 提出网站结构建议,包含页面列表、内容策略和关键词目标
- 在构建前获得用户批准
第二阶段:项目设置
- 搭建 Astro 项目
- 安装并配置集成(React、Tailwind、sitemap)
- 设置基础布局、SEO 组件和设计系统
第三阶段:构建每个页面
- 阅读
references/taste-skill.md了解设计规则 - 如果用户想要生成图片,请阅读
references/image-generation.md并为每个页面生成图片 - 使用真实且有研究价值的内容创建每个页面
- 在每个页面上实施完整 SEO——元标签、OG 标签、结构化数据、语义化 HTML
- 连接交互式组件(表单、导航等)
第四阶段:内容集合与数据库
- 为博客文章、服务等配置 Astro 内容集合
- 如果请求了数据库:设置 Turso,创建模式,构建 API 路由
- 如果适用,为数据库数据构建管理后台
第五阶段:部署准备
- 生成站点地图、robots.txt
- 配置部署(Vercel/Netlify)
- 对每个页面进行最终 SEO 审核
第一阶段:发现与研究
询问用户
在编写任何代码之前,需要了解项目:
- 你的细分市场/业务是什么? ——“我是都柏林的一名水管工”或“我在线销售手工蜡烛”
- 网站的主要目标是什么? ——线索生成、电商、作品集、博客、SaaS 落地页
- 你想要多少页面? ——小型(5-10 页)或内容密集型(15-30+ 页含博客)
- 你需要数据库吗? ——用于存储表单提交、预订、用户数据等。如果需要,设置 Turso。
- 你想要生成图片吗? ——“我可以使用 Gemini 为你的网站生成自定义图库图片。如果你愿意,请将你的
GEMINI_API_KEY添加到.env文件中。” - 你有域名吗? ——站点地图/规范 URL 需要。如果尚未购买,请使用占位符。
- 有设计偏好吗? ——颜色、风格、现有品牌标识
研究细分市场
使用网络搜索查找:
- 当前排名靠前的内容 ——目标关键词的前 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 处理动态数据——表单提交、线索、预订、新闻通讯注册。
- 在
src/lib/turso.ts中创建数据库客户端 - 使用 Drizzle ORM 定义模式
- 在
src/pages/api/中为表单处理创建 API 路由 - 构建管理后台以查看已提交的数据
管理后台(如果使用了数据库)
使用带有 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。