BuildShip SEO & Core Web Vitals 2026

# Doc endpoint shape: https://<workspaceID>.buildship.run/<path>
curl -X POST "https://008vd0.buildship.run/story-gen" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "An enchanted garden", "style": "Brothers Grimm" }'

# Response: the workflow Flow Output, e.g.
#   { "cover": { "title": "..." }, "pages": [ ... ] }
# It is application/json. Google indexes rendered HTML, so this URL is not a page.

// app/story/[id]/page.tsx, Next.js Server Component (runs on the server)
export default async function Story({ params }) {
  // Server-side fetch of the BuildShip workflow endpoint
  const res = await fetch(`https://008vd0.buildship.run/story-gen?id=${params.id}`,
    { next: { revalidate: 3600 } });
  const data = await res.json(); // the workflow's Flow Output (JSON)

  return (
    <article>
      <h1>{data.cover.title}</h1>      {/* real HTML text Google can index */}
      <p>{data.cover.subtitle}</p>
      <script type="application/ld+json"
        dangerouslySetInnerHTML={{ __html: JSON.stringify({
          '@context': 'https://schema.org', '@type': 'Article', headline: data.cover.title,
        }) }} />
    </article>
  );
}

// BuildShip Script node, validate the Authorization header before doing work
export default async function authGate({ authorization }, { env }) {
  if (authorization !== `Bearer ${env.WORKFLOW_KEY}`) {
    return { status: 401, body: { error: 'Unauthorized' } };
  }
  return { status: 200, ok: true }; // continue to the rest of the workflow
}
// Docs use a Branch node for the same check: validate the Authorization header,
// return an HTTP 200 (OK) for authorized requests, 401 otherwise.