seo: add WebAPI + APIReference schema.org JSON-LD to docs

SiteStructuredData now emits a WebAPI block covering the full SharpAPI
REST API (name, description, documentation URL, termsOfService, provider).
New ApiReferenceJsonLd component emits APIReference (TechArticle subtype)
on every /api-reference/* page, using the MDX frontmatter title and
description. Covers all 35 existing endpoint pages automatically.

Author: Mlaz-code

app/[lang]/[[...mdxPath]]/page.tsx

@@ -1,6 +1,6 @@
 import { generateStaticParamsFor, importPage } from 'nextra/pages'
 import { useMDXComponents } from '../../../mdx-components'
-import { PageBreadcrumb } from '../../../components/StructuredData'
+import { ApiReferenceJsonLd, PageBreadcrumb } from '../../../components/StructuredData'
 
 export const generateStaticParams = generateStaticParamsFor('mdxPath')
 
@@ -34,9 +34,19 @@ export default async function Page(props) {
   const pathname = params.mdxPath
     ? `/${params.lang}/${params.mdxPath.join('/')}`
     : `/${params.lang}`
+  const isApiRef = params.mdxPath?.[0] === 'api-reference'
+  const pageUrl = `https://docs.sharpapi.io${pathname}`
+
   return (
     <>
       <PageBreadcrumb pathname={pathname} title={metadata?.title as string | undefined} />
+      {isApiRef && metadata?.title && (
+        <ApiReferenceJsonLd
+          title={String(metadata.title)}
+          description={String(metadata.description ?? '')}
+          url={pageUrl}
+        />
+      )}
       <Wrapper toc={toc} metadata={metadata}>
         <MDXContent {...props} params={params} />
       </Wrapper>

components/StructuredData.tsx

@@ -3,7 +3,11 @@
  *
  * Emitted on every docs page via app/[lang]/layout.tsx:
  *   - Organization (sitewide)
- *   - WebSite with SearchAction (enables in-search sitelinks search box)
+ *   - WebSite (sitewide)
+ *   - WebAPI (sitewide — describes the SharpAPI REST API as a machine-readable entity)
+ *
+ * Emitted per API reference page via app/[lang]/[[...mdxPath]]/page.tsx:
+ *   - APIReference (TechArticle subtype) for each /api-reference/* page
  *
  * BreadcrumbList is generated per-page from the pathname; see PageBreadcrumb.
  */
@@ -41,10 +45,58 @@ export function SiteStructuredData() {
           'publisher': { '@type': 'Organization', 'name': 'SharpAPI', 'url': MAIN_URL },
         })}
       />
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={jsonLd({
+          '@context': 'https://schema.org',
+          '@type': 'WebAPI',
+          'name': 'SharpAPI REST API',
+          'description': 'Real-time sports betting odds API with +EV detection, arbitrage alerts, and SSE streaming across 43 sportsbooks.',
+          'url': `${SITE_URL}/en/api-reference/overview`,
+          'documentation': SITE_URL,
+          'termsOfService': `${MAIN_URL}/terms`,
+          'provider': {
+            '@type': 'Organization',
+            'name': 'SharpAPI',
+            'url': MAIN_URL,
+          },
+        })}
+      />
     </>
   )
 }
 
+interface ApiReferenceJsonLdProps {
+  title: string
+  description: string
+  url: string
+}
+
+export function ApiReferenceJsonLd({ title, description, url }: ApiReferenceJsonLdProps) {
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={jsonLd({
+        '@context': 'https://schema.org',
+        '@type': 'APIReference',
+        'name': title,
+        'description': description,
+        'url': url,
+        'isPartOf': {
+          '@type': 'WebAPI',
+          'name': 'SharpAPI REST API',
+          'url': `${SITE_URL}/en/api-reference/overview`,
+          'provider': {
+            '@type': 'Organization',
+            'name': 'SharpAPI',
+            'url': MAIN_URL,
+          },
+        },
+      })}
+    />
+  )
+}
+
 interface PageBreadcrumbProps {
   pathname: string
   title?: string