fix(seo): canonical self-deindexing on /docs/*, truthful llms.txt, real sitemap dates, RSS feed, breadcrumbs, per-article OG images

- /docs subpages canonicalized to /docs and had no descriptions; each now
  uses pageMetadata with its own path (was: Google could index at most one)
- llms.txt claimed Team EUR 149, RBAC/SLA and BYO-cloud that do not exist;
  regenerated from lib/seo.ts truth + new llms-full.txt with docs content
- sitemap stamped lastModified=now on every request; now real per-route dates
  from new lib/articles.ts registry (single source for guides index/sitemap/RSS)
- new /feed.xml RSS 2.0 route + alternates link in root layout
- articleJsonLd: image (per-guide opengraph-image via lib/og-article.tsx),
  Person author, wordCount; new breadcrumbJsonLd on guides + docs
- GSC verification via NEXT_PUBLIC_GSC_VERIFICATION (documented in .env.example)
- dropped fabricated Enterprise EUR 499 offer from SoftwareApplication JSON-LD
- article-shell: OL/Table/Note primitives for upcoming articles

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXUwmPVRTD8AKQtio6gCN5
This commit is contained in:
Marco Sadjadi
2026-07-08 23:00:02 +02:00
parent 3dc65e4f4d
commit cba45402ce
25 changed files with 652 additions and 75 deletions

View File

@@ -6,12 +6,26 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'API reference — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'API reference',
description:
'REST API reference for the BuildMyMCPServer control plane — auth, server CRUD, build streaming, templates and the OAuth 2.1 endpoints.',
path: '/docs/api-reference',
});
export default function ApiReference() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'API reference', path: '/docs/api-reference' },
])}
/>
<DocsTitle kicker="Reference">API reference</DocsTitle>
<DocsLead>
Every endpoint on the control plane. Authenticated routes use the session cookie set by

View File

@@ -8,12 +8,26 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'Authoring tools — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'Authoring tools',
description:
'How to write prompts that generate good MCP tools — naming, input schemas, credentials, and how the generated TypeScript is checked before it ships.',
path: '/docs/authoring',
});
export default function Authoring() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'Authoring tools', path: '/docs/authoring' },
])}
/>
<DocsTitle kicker="Build">Authoring tools</DocsTitle>
<DocsLead>
What you write in the prompt is what Claude turns into TypeScript. Better prompts mean

View File

@@ -8,12 +8,26 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'MCP concepts — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'MCP concepts',
description:
'What Model Context Protocol is: tools, resources and prompts, the Streamable HTTP transport, and how a client discovers and calls a server.',
path: '/docs/concepts',
});
export default function Concepts() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'MCP concepts', path: '/docs/concepts' },
])}
/>
<DocsTitle kicker="Get started">MCP concepts</DocsTitle>
<DocsLead>
Model Context Protocol is an open standard from Anthropic for connecting AI assistants to

View File

@@ -1,6 +1,13 @@
import { DocsTitle, DocsLead, DocsH2, DocsP, Mono } from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'FAQ — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'Docs FAQ',
description:
'Answers on generated-code safety, secrets handling, build failures, quotas and self-hosting for BuildMyMCPServer.',
path: '/docs/faq',
});
const ITEMS: { q: string; a: React.ReactNode }[] = [
{
@@ -56,6 +63,13 @@ const ITEMS: { q: string; a: React.ReactNode }[] = [
export default function Faq() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'FAQ', path: '/docs/faq' },
])}
/>
<DocsTitle kicker="Reference">FAQ</DocsTitle>
<DocsLead>Common questions, direct answers.</DocsLead>
<div className="space-y-7">

View File

@@ -8,12 +8,26 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'OAuth 2.1 flow — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'OAuth 2.1 flow',
description:
'How every generated MCP server is protected: OAuth 2.1 with PKCE, Dynamic Client Registration (RFC 7591) and Resource Indicators (RFC 8707), walked through request by request.',
path: '/docs/oauth',
});
export default function OAuthDocs() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'OAuth 2.1 flow', path: '/docs/oauth' },
])}
/>
<DocsTitle kicker="Auth">OAuth 2.1 flow</DocsTitle>
<DocsLead>
Every generated server is an OAuth 2.1 Resource Server. The control plane is the

View File

@@ -9,8 +9,14 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { pageMetadata } from '@/lib/seo';
export const metadata = { title: 'Quickstart — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'Quickstart',
description:
'From first prompt to a live OAuth-protected MCP server in five minutes — sign in, describe your tool, confirm the plan, watch the build stream, install in your client.',
path: '/docs',
});
export default function Quickstart() {
return (

View File

@@ -8,12 +8,26 @@ import {
DocsCode,
Mono,
} from '@/components/docs-page';
import { JsonLd } from '@/components/json-ld';
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
export const metadata = { title: 'Self-hosting — BuildMyMCPServer docs' };
export const metadata = pageMetadata({
title: 'Self-hosting',
description:
'Run the BuildMyMCPServer control plane yourself — bring your own Postgres, Redis and Docker host, plus the production sandboxing flags for generated containers.',
path: '/docs/self-hosting',
});
export default function SelfHosting() {
return (
<>
<JsonLd
data={breadcrumbJsonLd([
{ name: 'Home', path: '/' },
{ name: 'Docs', path: '/docs' },
{ name: 'Self-hosting', path: '/docs/self-hosting' },
])}
/>
<DocsTitle kicker="Build">Self-hosting</DocsTitle>
<DocsLead>
The control plane and generator are open. Bring your own Postgres, Redis, Docker host and