feat: add legal page and update sitemap

- Implement bot-optimized legal page with appropriate og:tags
- Add legal page URL to sitemap
- Update documentation to include legal page in routes

Author: MarkusNeusinger

api/routers/seo.py

@@ -71,6 +71,7 @@ async def get_sitemap(db: AsyncSession | None = Depends(optional_db)):
         '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
         "  <url><loc>https://pyplots.ai/</loc></url>",
         "  <url><loc>https://pyplots.ai/catalog</loc></url>",
+        "  <url><loc>https://pyplots.ai/legal</loc></url>",
     ]
 
     # Add spec URLs (overview + all implementations)
@@ -131,6 +132,19 @@ async def seo_catalog():
     )
 
 
+@router.get("/seo-proxy/legal")
+async def seo_legal():
+    """Bot-optimized legal page with correct og:tags."""
+    return HTMLResponse(
+        BOT_HTML_TEMPLATE.format(
+            title="Legal | pyplots.ai",
+            description="Legal notice, privacy policy, and transparency information for pyplots.ai",
+            image=DEFAULT_HOME_IMAGE,
+            url="https://pyplots.ai/legal",
+        )
+    )
+
+
 @router.get("/seo-proxy/{spec_id}")
 async def seo_spec_overview(spec_id: str, db: AsyncSession | None = Depends(optional_db)):
     """Bot-optimized spec overview page with collage og:image."""

docs/reference/plausible.md

@@ -42,6 +42,7 @@ https://pyplots.ai/{category}/{value}/{category}/{value}/...
 |-----|-------------|
 | `/` | Home page (no filters) |
 | `/catalog` | Catalog page (alphabetical spec list) |
+| `/legal` | Legal notice, privacy policy, transparency |
 | `/{spec_id}` | Spec overview page (grid of all implementations) |
 | `/{spec_id}/{library}` | Spec detail page (single library implementation) |
 | `/interactive/{spec_id}/{library}` | Interactive fullscreen view (HTML plots) |

docs/reference/seo.md

@@ -137,6 +137,7 @@ Backend endpoints that serve HTML with correct meta tags for bots.
 |----------|---------|----------|
 | `GET /seo-proxy/` | Home page | Default (`og-image.png`) |
 | `GET /seo-proxy/catalog` | Catalog page | Default |
+| `GET /seo-proxy/legal` | Legal page | Default |
 | `GET /seo-proxy/{spec_id}` | Spec overview | Collage (2x3 grid) |
 | `GET /seo-proxy/{spec_id}/{library}` | Implementation | Single branded |
 
@@ -253,6 +254,7 @@ Dynamic XML sitemap for search engine indexing.
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url><loc>https://pyplots.ai/</loc></url>
   <url><loc>https://pyplots.ai/catalog</loc></url>
+  <url><loc>https://pyplots.ai/legal</loc></url>
   <!-- For each spec with implementations: -->
   <url><loc>https://pyplots.ai/{spec_id}</loc></url>
   <url><loc>https://pyplots.ai/{spec_id}/{library}</loc></url>
@@ -264,8 +266,9 @@ Dynamic XML sitemap for search engine indexing.
 
 1. Home page (`/`)
 2. Catalog page (`/catalog`)
-3. Spec overview pages (`/{spec_id}`) - only if spec has implementations
-4. Implementation pages (`/{spec_id}/{library}`) - all implementations
+3. Legal page (`/legal`)
+4. Spec overview pages (`/{spec_id}`) - only if spec has implementations
+5. Implementation pages (`/{spec_id}/{library}`) - all implementations
 
 ### nginx Proxy