AI開発ベース
🤖Next.js

Claude Code で Next.js のアフィリエイトブログを作った全手順【2026年版】

AIエージェントのClaude Codeを使って、SEOに強いNext.js + MarkdownのアフィリエイトブログをゼロからVercelに公開するまでの手順を、実際のコマンドとつまずきポイント込みで解説します。

📅 2026-06-27⏱ 約5分で読めます✍ Kosuke

「AIにブログサイトを丸ごと作らせたら、どこまで実用になるのか」を確かめるため、AIコーディングエージェントの Claude Code を使って、このサイト自体を Next.js でゼロから構築しました。この記事はその実作業ログです。生成AIの一般論ではなく、実際に動かしたコマンドと、詰まった箇所だけを書きます。

完成した構成

項目 採用したもの 理由
フレームワーク Next.js (App Router) SSG + Metadata APIでSEOが楽
言語 TypeScript 記事データの型を固めたい
スタイル Tailwind CSS v4 構築速度。typographyプラグインで本文整形
記事管理 Markdown + gray-matter DB不要。Gitで記事を管理できる
本文変換 remark / remark-gfm テーブルや脚注も崩れない
ホスティング Vercel Next.jsとの相性が最良・無料枠で開始可

ポイントは DBを使わないこと。記事を content/posts/*.md に置くだけで、ビルド時に静的HTMLへ変換されます。これにより表示は爆速、運用はGit commitだけ、という個人開発に最適な形になります。

1. プロジェクトを生成する

create-next-app を対話なし(フラグ指定)で実行します。

npx create-next-app@latest site \
  --ts --tailwind --app --eslint --src-dir \
  --import-alias "@/*" --use-npm --turbopack --yes

Markdownを扱うために追加で4つ入れます。

npm install gray-matter remark remark-html remark-gfm
npm install @tailwindcss/typography

2. Markdownを読む仕組みを書く

content/posts/ の .md を読み、frontmatter(タイトル等)と本文HTMLに分けるだけの薄いライブラリを用意します。要点は、記事一覧では本文をパースせずメタ情報だけを読むこと。これで一覧ページが速くなります。

const processed = await remark().use(remarkGfm).use(html).process(content);

remark-gfm を挟むのが地味に重要で、これが無いとMarkdownのテーブル(この記事の比較表のような)がただの文字列になります。

3. SEOの土台を最初に入れる

アフィリエイトブログは検索流入が命なので、最初から以下を入れておきます。後付けは漏れます。

  • Metadata API:各記事で title / description / canonical / OGPを動的生成
  • app/sitemap.ts:全記事URLを自動でsitemap化
  • app/robots.ts:クロール許可 + sitemapの場所を明示
  • JSON-LD(構造化データ):記事ページに Article を埋め込み、検索エンジンとAIに内容を伝える

metadataBase を next.config ではなく layout.tsx の metadata に設定しておくと、OGP画像の絶対URL化で後々ハマりません。

つまずき:Next.js 15以降の params は Promise

App Routerの動的ルートで、params を直接 params.slug と書くと型エラーになります。今は非同期なので await が必要です。

export default async function PostPage({
  params,
}: { params: Promise<{ slug: string }> }) {
  const { slug } = await params; // ← await する
}

4. 本文の見た目はTailwind Typographyに任せる

自前でh2やリストのCSSを書くのは時間の無駄です。Tailwind v4ではグローバルCSSに1行足すだけでプラグインが有効になります。

@import "tailwindcss";
@plugin "@tailwindcss/typography";

あとは本文を囲む要素に prose prose-neutral dark:prose-invert を付ければ、見出し・コード・テーブルが整います。

5. ローカルで確認して公開する

npm run dev    # http://localhost:3000 で確認
npm run build  # 本番ビルドが通るか確認

公開先はVercelが最短です。GitHubにpushして連携すれば、以降は commitするだけで自動デプロイ。独自ドメインも管理画面から数分で繋がります。サーバーの保守が一切要らないので、記事を書くことだけに集中できます。

補足:WordPressのように自分でサーバーを借りて運用する選択肢もありますが、Next.js構成ならまずVercelの無料枠で始め、規模が大きくなってからレンタルサーバーやVPSを検討するのが合理的です。サーバー比較は別記事で詳しく扱います。

やってみた所感

AIエージェントに任せて良かったのは、ボイラープレート(雛形)の生成速度です。create-next-appからSEO設定一式までを淡々と組み上げてくれるので、人間は「どんな記事構成にするか」「どの案件を扱うか」という、本来時間を使うべき所に集中できました。

逆に、paramsのPromise化のようなバージョン依存の罠は、AIでも古い書き方を出すことがあります。npm run build を必ず自分の目で通すこと——これだけは省略してはいけません。

次の記事では、このブログに載せるAIコーディングツール(Cursor / Claude Code / GitHub Copilot)の比較を、実際に同じ課題を解かせた結果付きで書く予定です。

#Next.js#Claude Code#AI開発#アフィリエイト#SEO
← 記事一覧へ