feat(seo): canonical, social cards, robots and sitemap

App/app/layout.tsx

@@ -2,9 +2,43 @@ import type { Metadata } from 'next';
 import Web3Providers from '../components/Web3Providers';
 import './styles.css';
 
+const SITE_URL = 'https://knowledge.perkos.xyz';
+const TITLE = 'PerkOS Knowledge — a shared knowledge commons for people and their agents';
+const DESCRIPTION =
+  'A shared knowledge commons. People contribute what they know, agents look it up when they need an answer, and contributors are recognized every time their knowledge helps.';
+
 export const metadata: Metadata = {
-  title: 'PerkOS Knowledge',
-  description: 'A shared knowledge commons. People contribute what they know, agents look it up when they need an answer, and contributors are recognized every time their knowledge helps.',
+  metadataBase: new URL(SITE_URL),
+  title: {
+    default: TITLE,
+    template: '%s · PerkOS Knowledge',
+  },
+  description: DESCRIPTION,
+  applicationName: 'PerkOS Knowledge',
+  alternates: {
+    canonical: '/',
+  },
+  openGraph: {
+    type: 'website',
+    url: SITE_URL,
+    siteName: 'PerkOS Knowledge',
+    title: TITLE,
+    description: DESCRIPTION,
+    locale: 'en_US',
+    images: [{ url: '/og.png', width: 1200, height: 630, alt: 'PerkOS Knowledge, a shared knowledge commons' }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: TITLE,
+    description: DESCRIPTION,
+    site: '@perk_os',
+    images: ['/og.png'],
+  },
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: { index: true, follow: true, 'max-image-preview': 'large', 'max-snippet': -1 },
+  },
   other: {
     'talentapp:project_verification':
       '6312cbdecd6b0d974fb841350d907866a1bc2ed3a10c7ac2057d9b747a3ef7ef662b202d1a8fcedc67ada1a5cc3d5cbddaf052fc7952b9a911c7c0fca1d4a572',

App/app/page.tsx

@@ -15,9 +15,48 @@ const apiCards = [
 
 const rails = ['Open source', 'Self-hostable', 'MCP', 'Qdrant', 'Postgres', 'Firebase', 'Docker'];
 
+// Structured data so search engines and assistants can describe the service
+// without guessing. Keep it to what the page itself claims.
+const structuredData = {
+  '@context': 'https://schema.org',
+  '@graph': [
+    {
+      '@type': 'WebSite',
+      '@id': 'https://knowledge.perkos.xyz/#website',
+      url: 'https://knowledge.perkos.xyz',
+      name: 'PerkOS Knowledge',
+      description:
+        'A shared knowledge commons. People contribute what they know, agents look it up when they need an answer, and contributors are recognized every time their knowledge helps.',
+      inLanguage: 'en',
+      publisher: { '@id': 'https://perkos.xyz/#organization' }
+    },
+    {
+      '@type': 'Organization',
+      '@id': 'https://perkos.xyz/#organization',
+      name: 'PerkOS',
+      url: 'https://perkos.xyz'
+    },
+    {
+      '@type': 'SoftwareApplication',
+      name: 'PerkOS Knowledge',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      url: 'https://knowledge.perkos.xyz',
+      description:
+        'A searchable knowledge commons that people and AI agents share. Answers come back with their sources, private notes stay private, and contributors are recognized when their knowledge helps.',
+      isAccessibleForFree: true
+    }
+  ]
+};
+
 export default function Home() {
   return (
     <main>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(structuredData) }}
+      />
+
       <section className="hero">
         <SiteNav />
 

App/app/robots.ts

@@ -0,0 +1,16 @@
+import type { MetadataRoute } from 'next';
+
+// Only the landing is meant to be indexed. The dashboard and admin views are
+// wallet-gated, and everything under /api, /knowledge and /skill is an
+// endpoint for agents, not a page for readers.
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+      disallow: ['/admin', '/dashboard', '/api/', '/knowledge/', '/skill/', '/healthz']
+    },
+    sitemap: 'https://knowledge.perkos.xyz/sitemap.xml',
+    host: 'https://knowledge.perkos.xyz'
+  };
+}

App/app/sitemap.ts

@@ -0,0 +1,14 @@
+import type { MetadataRoute } from 'next';
+
+const SITE = 'https://knowledge.perkos.xyz';
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  return [
+    {
+      url: SITE,
+      lastModified: new Date(),
+      changeFrequency: 'weekly',
+      priority: 1
+    }
+  ];
+}