SEO と GEO

Blume サイトがどのようにして見つけられるのか — 一方では検索エンジンとソーシャルプラットフォームに、他方ではコーディングエージェントと AI アシスタントに — そしてそれぞれの領域がどこで設定されるのかを説明します。

検索エンジンと AI エージェントは、ドキュメントに対して同じものを求めています。各ページが何を述べているのか、ページ同士がどう関連しているのか、そして誰が公開しているのかについての、クリーンで機械可読な情報です。Blume はこの 2 つを 1 つの発見可能性レイヤーとして扱います。メタデータ、ソーシャルカード、フィード、構造化データは、あなたをランク付けするクローラーのために機能します。llms.txt、生の Markdown、JSON API、MCP サーバー、ディスカバリーマニフェストは、あなたについての質問に答えるエージェントのために機能します。そしてその中間にあるファイル（robots.txt、サイトマップ、JSON-LD）は、その両方に読まれます。

そのほとんどはデフォルトで有効になっており、設定は不要です。調整項目は blume.config.ts の 2 つのキーの下にあります。検索エンジンとソーシャルプラットフォームが見るものを扱う seo と、エージェントが見るものを扱う agents です。

seo: {
  og: { enabled: true },
  rss: { enabled: true, types: ["blog", "changelog"] },
  sitemap: true,
  robots: true,
  structuredData: true,
  x: { handle: "@acme" },
},
agents: {
  llmsTxt: true,
  mcp: { enabled: false },
},

これらの大半は、絶対的なサイト URL があるとより効果を発揮します。deployment.site を設定することで、フィード、OG 画像、canonical、サイトマップ、JSON-LD、そしてすべてのエージェントマニフェストが完全な URL を出力できるようになります。一部の領域（Open Graph 画像、サイトマップ、RSS フィード、AI カタログ）は、これが設定されるまで無効のままです。

ビルドが出力するもの

領域	場所	デフォルト	ガイド
`<head>` メタデータ、canonical、X カード	すべてのページ	有効	メタデータ
ソーシャル共有画像	`/og/<route>.png`	サイト URL がある場合に有効	Open Graph 画像
schema.org JSON-LD	すべてのページ	有効	構造化データ
RSS フィード	`/<type>/rss.xml`	サイト URL がある場合に有効	RSS フィード
`sitemap.xml`、`robots.txt`、コンテンツシグナル	サイトルート	有効	サイトマップと robots
`llms.txt`、`llms-full.txt`	サイトルート	有効	llms.txt
生の Markdown ミラー、コンテンツネゴシエーション、Copy as Markdown、Open in chat	`/<route>.md`	有効	エージェント向け Markdown
JSON API とその OpenAPI 記述	`/api/docs/…`、`/openapi.json`	有効	JSON API
MCP サーバー	`/mcp`	オプトイン、サーバー出力	MCP サーバー
`agent-readability.json`、`Link` ヘッダー、API カタログ、AI カタログ（ARD）、WebMCP	サイトルート、`/.well-known/…`	有効	エージェントディスカバリー
エージェントスキル、Web Bot Auth キー	`/.well-known/…`	オプトイン	エージェントディスカバリー

生成されるファイルはすべて、あなた自身が用意したファイルに道を譲ります。robots.txt、sitemap.xml、llms.txt、openapi.json、agent-readability.json を public/ に置けば、Blume はその代わりにあなたのファイルを配信します。

ページ内の アシスタント は、別の場所でドキュメント化されている唯一の AI 機能です。これは発見のための領域ではなく読者向けのプロダクト機能であるため、ai の下で設定され、設定の下に配置されています。

動作の確認

blume audit はビルド済みサイトをクロールし、タイトル、説明文、canonical、Open Graph と X カード、hreflang、サイトマップ、robots.txt、構造化データについてレポートします。--url でデプロイ先を指定すると、レスポンスヘッダー、設定済みのリダイレクト、DNS ベースのエージェントディスカバリーも併せてチェックできます。