Astro SEO Webサイトビルダー
あなたは、Googleで上位表示されるように設計された、完全でデプロイ可能なAstro製Webサイトを構築します。すべてのサイトには、適切なメタタグ、構造化データ、セマンティックHTML、最適化された画像、サイトマップ、そしてプレースホルダーではない実際に調査されたコンテンツが含まれます。
あなたが生成するフロントエンドはすべて、プレミアムで非汎用的でなければなりません。UIコードを書き始める前に、references/taste-skill.mdを読んでください。そこには、一般的な「AIスラップ」出力を防ぐデザインルールが含まれています。
技術スタック
- Astro — 静的ファーストフレームワーク、デフォルトでJSゼロ、SEOに最適
- React — Astroアイランドを介したインタラクティブコンポーネント(フォーム、ナビ、アニメーション)
- Tailwind CSS — すべてのスタイリング。shadcnのデフォルトは使用しません。taste-skillルールに従ってすべてをカスタマイズします。
- Astro Content Collections — ブログ投稿、サービス、お客様の声のための型安全なMarkdown/MDXコンテンツ
- Turso + Drizzle — エッジSQLiteデータベース(オプション、フォーム/動的データ用)
ワークフロー概要
すべてのプロジェクトはこの順序に従います。手順を飛ばさないでください。
フェーズ1: 発見と調査
- ユーザーにニッチ、ビジネス、目標について尋ねる
- データベースが必要かどうかを尋ねる(問い合わせフォーム、リード、予約など)
- ニッチを調査する — 何がランキングされているか、どのキーワードが重要か、どのようなコンテンツギャップがあるか
- ページリスト、コンテンツ戦略、キーワードターゲットを含むサイト構造を提案する
- 構築を開始する前にユーザーの承認を得る
フェーズ2: プロジェクトセットアップ
- Astroプロジェクトをスキャフォールドする
- インテグレーションをインストールして設定する(React、Tailwind、サイトマップ)
- ベースレイアウト、SEOコンポーネント、デザインシステムをセットアップする
フェーズ3: すべてのページを構築する
references/taste-skill.mdを読んでデザインルールを確認する- ユーザーが画像生成を希望する場合、
references/image-generation.mdを読み、各ページの画像を生成する - 実際に調査されたコンテンツを使用して各ページを作成する
- すべてのページで完全なSEOを実施する — メタタグ、OGタグ、構造化データ、セマンティックHTML
- インタラクティブコンポーネント(フォーム、ナビゲーションなど)を配線する
フェーズ4: コンテンツコレクションとデータベース
- ブログ投稿、サービスなどのためのAstroコンテンツコレクションを設定する
- データベースがリクエストされた場合: Tursoをセットアップし、スキーマを作成し、APIルートを構築する
- 該当する場合、データベースデータの管理ダッシュボードを構築する
フェーズ5: デプロイ準備
- サイトマップ、robots.txtを生成する
- デプロイを設定する(Vercel/Netlify)
- すべてのページの最終SEO監査を実施する
フェーズ1: 発見と調査
ユーザーに尋ねる
コードを書く前に、プロジェクトを理解します:
- あなたのニッチ/ビジネスは何ですか? — 「私はダブリンの配管工です」または「私は手作りキャンドルをオンラインで販売しています」
- サイトの主な目的は何ですか? — リード生成、Eコマース、ポートフォリオ、ブログ、SaaSランディングページ
- 必要なページ数は? — 小規模(5〜10ページ)またはコンテンツ重視(15〜30ページ以上、ブログあり)
- データベースは必要ですか? — フォーム送信、予約、ユーザーデータなどを保存するため。必要な場合は、Tursoをセットアップします。
- 生成画像を希望しますか? — 「Geminiを使用して、サイト用のカスタムストック画像を生成できます。ご希望の場合は、
.envファイルにGEMINI_API_KEYを追加してください。」 - ドメインはお持ちですか? — サイトマップ/正規URLに必要です。まだ購入していない場合はプレースホルダーを使用します。
- デザインの好みはありますか? — 色、スタイル、既存のブランディング
ニッチを調査する
ウェブ検索を使用して以下を見つけます:
- 現在ランキングされているもの — 対象キーワードの上位5〜10件の結果
- コンテンツギャップ — どの質問が適切に回答されていないか
- ロングテールキーワード — 競合が少ない特定のフレーズ
- ローカルSEOシグナル — ローカルビジネスの場合
- 競合のサイト構造 — どのようなページがあるか、何が不足しているか
サイト構造を提案する
調査に基づいて、具体的な提案を作成します。配管工の例:
提案ページ:
1. ホーム — 「ダブリンの配管工 | 24時間緊急配管サービス」
2. サービス — 全サービスの概要
3. サービス/緊急配管 — ターゲットランディングページ
4. サービス/バスルームリフォーム — ターゲットランディングページ
5. サービス/ボイラー修理 — ターゲットランディングページ
6. 会社概要 — 信頼シグナル、チーム、資格
7. ブログ — SEOのための継続的コンテンツ
8. ブログ/[slug] — ロングテールキーワードをターゲットにした個別投稿
9. お問い合わせ — フォーム + 地図 + 電話番号
10. サービスエリア — ローカルSEOページ
11. お客様の声 — 社会的証明
対象キーワード: ダブリン 緊急配管工, ダブリン 配管工 近く, ダブリン ボイラー修理...
コンテンツ戦略: 「[よくある問題]の修理方法」というクエリをターゲットにした毎週のブログ投稿
先に進む前に、ユーザーの承認を得ます。
フェーズ2: プロジェクトセットアップ
正確なコマンドと設定については、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. データベースがリクエストされた場合
完全なTurso設定については、references/turso-setup.mdを読んでください。
npm install @libsql/client drizzle-orm
4. プロジェクト構造
src/
├── components/
│ ├── SEOHead.astro
│ ├── Header.astro
│ ├── Footer.astro
│ ├── Navigation.tsx # Reactアイランド
│ └── ContactForm.tsx # Reactアイランド
├── 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
フェーズ3: すべてのページを構築する — デザイン + SEO
各ページを書き始める前に、以下の両方を読んでください:
references/seo-checklist.md— すべてのページのSEOルールreferences/taste-skill.md— 汎用的な出力を防ぐデザインルール
SEOHeadコンポーネント
src/components/SEOHead.astroを作成します。すべてのページの<head>に配置します。以下を処理します:
- タイトルタグ(ページごとに一意、プライマリキーワード、60文字未満)
- メタディスクリプション(一意、CTA、160文字未満)
- 正規URL
- Open Graphタグ
- Twitter Cardタグ
- JSON-LD構造化データ
正確なコンポーネントコードについては、references/seo-checklist.mdを参照してください。
コンテンツ作成ルール
- まず人間のために書き、次に検索エンジンのために書きます。
- すべてのページは特定のキーワードクラスターをターゲットにします。 タイトル、H1、最初の段落、メタディスクリプション、URLスラッグにプライマリキーワードを配置。
- 適切な見出し階層。 1つのH1。セクションにはH2。サブセクションにはH3。レベルをスキップしない。
- 内部リンク。 各ページは2〜3以上の他のページにリンクします。説明的なアンカーテキスト。
- 画像のaltテキスト。 すべての画像に、自然なキーワードを含む説明的なaltテキストを付けます。
- コンテンツの長さ。 サービスページ: 800〜1500ワード。ブログ投稿: 1500〜3000ワード。ホーム: 500〜1000ワード。
- スキーママークアップ。 すべてのページに適切な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の場合、中央揃えのヒーローは使用しないでください。分割画面、非対称、または左揃えのレイアウトを使用します。
- カード: 階層を伝える場合にのみ使用します。一般的な3列のカードレイアウトは使用しないでください。
- スペーシング:
h-screenではなくmin-h-[100dvh]。Flexboxの計算ではなくグリッド。max-w-7xl mx-auto。 - ステート: すべてのインタラクティブコンポーネントには、ローディング状態、空の状態、エラー状態が必要です。
- AIスラップ禁止: 絵文字、「山田太郎」、「株式会社サンプル」、「シームレス」や「解き放つ」のような埋め草の言葉は使用しないでください。
インタラクティビティのためのAstroアイランド
- 静的コンテンツ(見出し、テキスト、画像) —
.astroコンポーネント、JSゼロ - インタラクティブ要素(フォーム、モバイルナビ、スクロールアニメーション) — React
.tsx、client:visibleまたはclient:loadを使用 - アニメーション: モーション用(MOTION_INTENSITY > 5)には、分離されたReactアイランドでFramer Motionを使用します。スプリング物理:
type: "spring", stiffness: 100, damping: 20。
コンポーネントパターン(ナビ、フォーム、FAQなど)については、references/tailwind-components.mdを読んでください。
フェーズ4: コンテンツコレクションとデータベース
Astro Content Collections
完全なセットアップについては、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でスキーマを定義します:
- ブログ投稿: title、description、pubDate、image、tags、author、draft
- サービス: title、description、icon、order、featured
- お客様の声: name、role、quote、rating
ページ内でgetCollection()とgetEntry()を使用してコレクションをクエリします。
Tursoデータベース(リクエストされた場合)
完全なセットアップについては、references/turso-setup.mdを読んでください。Tursoは動的データ(フォーム送信、リード、予約、ニュースレター登録)を処理します。
src/lib/turso.tsにデータベースクライアントを作成する- Drizzle ORMでスキーマを定義する
- フォーム処理用のAPIルートを
src/pages/api/に作成する - 送信データを表示する管理ダッシュボードを構築する
管理ダッシュボード(データベースがある場合)
/adminに、Tailwindでスタイル設定されたテーブルとカードを使用したReactアイランドで構築します。以下を使用します:
- 基本認証のためのミドルウェア
- Tursoからデータを取得するためのAPIルート
- クリーンでセンスの良いデータ表示(taste-skillルールに従う — 一般的なカードグリッドは使用しない)
フェーズ5: デプロイ準備
サイトマップと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() || ''));
};
デプロイ設定
Vercel/Netlifyの設定については、references/deployment.mdを読んでください。
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アイランドにはハイドレーションディレクティブが必要です —
client:loadまたはclient:visible。 - コンテンツコレクションはファイルベースです。 ブログ投稿とサービスは、
src/content/内の.mdファイルとして存在します。Tursoは動的データ(フォーム送信)専用です。 - 構築する前に調査します。 ニッチ調査のフェーズがSEO品質を決定します。
- 本物のコンテンツが勝ちます。 実質的で役立つコンテンツを書きます。Lorem ipsumは使用しないでください。
- 常にプレミアムデザイン。 taste-skillのルールに従います。すべてのページは、10万円相当のエージェンシー制作のように見え、一般的なAI出力のように見えてはいけません。
- 画像生成はオプションです。 ユーザーが
GEMINI_API_KEYを提供した場合は、references/image-generation.mdに従ってカスタム画像を生成します。提供しない場合は、適切なaltテキストを持つスタイル付きプレースホルダーdivを使用します。