Files

colinislit 7df92dd2fb feat(blog): enhance blog functionality and SEO

- Added a new '/blog' route to middleware for improved navigation.
- Updated sitemap to dynamically include blog posts and series URLs.
- Enhanced blog page metadata with Open Graph and Twitter card information.
- Implemented structured data for blog posts and series to improve SEO.
- Removed outdated blog post "Week 1: De Kickoff" from content.
- Introduced optional OG image field in blog frontmatter for better sharing visuals.

2026-01-01 10:56:34 +01:00

6.8 KiB

Raw Permalink Blame History

SEO Audit & Aanbevelingen - AI Speedrun

Datum: 2025-01-27
Auditor: SEO Specialist
Website: aispeedrun.vercel.app

Executive Summary

De website heeft een solide basis voor SEO met goede metadata, sitemap en robots.txt. Er zijn echter belangrijke verbeteringen mogelijk op het gebied van structured data, Open Graph images, en content optimalisatie.

✅ Wat Goed Is

Basis Metadata: Goede title templates en descriptions in root layout
Robots.txt: Correct geconfigureerd met sitemap referentie
Sitemap: Dynamisch gegenereerd met documentatie releases
Structured Data: Basis Organization en WebSite schema aanwezig
Open Graph: Basis OG tags aanwezig op homepage
Canonical URLs: Aanwezig op homepage
Alt Tags: Aanwezig op meeste images
Semantic HTML: Goed gebruik van article, header, nav tags

🔴 Kritieke Verbeteringen (Hoge Prioriteit)

1. Blog Posts Ontbreken in Sitemap

Probleem: Blog posts worden niet toegevoegd aan de sitemap, waardoor ze mogelijk niet geïndexeerd worden.

Impact: Hoog - Blog content is belangrijk voor SEO

Oplossing: Update app/sitemap.ts om alle blog posts toe te voegen

2. Blog Posts Missen Open Graph Images

Probleem: Blog posts hebben geen OG images, wat de social sharing vermindert.

Impact: Hoog - Slechte social previews = minder clicks

Oplossing: Voeg OG image support toe aan blog post metadata

3. Blog Posts Missen Canonical URLs

Probleem: Geen canonical URLs op individuele blog posts.

Impact: Medium - Kan duplicate content issues veroorzaken

Oplossing: Voeg canonical URL toe aan blog post metadata

4. Blog Posts Missen Article Structured Data

Probleem: Geen Article schema.org markup op blog posts.

Probleem: Hoog - Gemiste kans voor rich snippets in Google

Oplossing: Voeg Article schema toe aan blog post pages

5. Blog Posts Missen Author Metadata

Probleem: Geen author informatie in blog post metadata.

Impact: Medium - Minder context voor zoekmachines

Oplossing: Voeg author metadata toe aan blog posts

🟡 Belangrijke Verbeteringen (Medium Prioriteit)

6. Breadcrumbs Structured Data

Probleem: Geen breadcrumb navigation met structured data.

Impact: Medium - Kan rich snippets opleveren in Google

Oplossing: Implementeer breadcrumb component met BreadcrumbList schema

7. Blog Series Metadata

Probleem: Blog series pagina's missen uitgebreide metadata.

Impact: Medium - Series pagina's kunnen beter ranken

Oplossing: Voeg uitgebreide metadata toe aan series pages

8. Documentatie Metadata

Probleem: Documentatie pagina's missen mogelijk specifieke metadata.

Impact: Medium - Documentatie is waardevolle content

Oplossing: Controleer en verbeter documentatie metadata

9. Image Optimization

Probleem: Mogelijk niet alle images hebben alt tags of zijn geoptimaliseerd.

Impact: Medium - Images zijn belangrijk voor SEO

Oplossing: Audit alle images en voeg alt tags toe waar nodig

10. Internal Linking

Probleem: Mogelijk onvoldoende interne links tussen gerelateerde content.

Impact: Medium - Helpt met crawlability en ranking

Oplossing: Voeg gerelateerde posts/artikelen secties toe

🟢 Nice-to-Have Verbeteringen (Lage Prioriteit)

11. FAQ Structured Data

Probleem: Geen FAQ schema waar relevant (bijv. op homepage of contact pagina).

Impact: Laag - Kan rich snippets opleveren

Oplossing: Voeg FAQ schema toe waar relevant

12. Review/Rating Schema

Probleem: Geen review schema voor testimonials (als die er zijn).

Impact: Laag - Kan rich snippets opleveren

Oplossing: Voeg Review schema toe indien relevant

13. Video Schema

Probleem: Als er video content is, ontbreekt VideoObject schema.

Impact: Laag - Alleen relevant als er video's zijn

Oplossing: Voeg VideoObject schema toe indien van toepassing

14. Performance Metrics

Probleem: Geen specifieke performance optimalisaties voor Core Web Vitals.

Impact: Laag - Performance is ranking factor

Oplossing: Monitor en optimaliseer Core Web Vitals

15. hreflang Tags

Probleem: Geen hreflang tags (maar waarschijnlijk niet nodig als alleen NL).

Impact: Laag - Alleen nodig bij meertaligheid

Oplossing: Voeg toe als je meerdere talen toevoegt

📋 Implementatie Prioriteiten

Fase 1 (Direct - Deze Week)

✅ Blog posts toevoegen aan sitemap
✅ Open Graph images voor blog posts
✅ Canonical URLs voor blog posts
✅ Article structured data voor blog posts
✅ Author metadata voor blog posts

Fase 2 (Binnen 2 Weken)

✅ Breadcrumbs structured data
✅ Blog series metadata verbeteren
✅ Image alt tags audit
✅ Internal linking verbeteren

Fase 3 (Binnen Maand)

✅ FAQ schema waar relevant
✅ Performance optimalisaties
✅ Content optimalisatie (keywords, headings)

🔍 Technische Details per Verbetering

1. Blog Posts in Sitemap

// app/sitemap.ts
import { getAllPosts } from '@/lib/mdx/blog'

// In sitemap functie:
const posts = await getAllPosts()
const postUrls = posts.map((post) => ({
  url: `${baseUrl}/blog/serie/${post.seriesId}/${post.slug}`,
  lastModified: new Date(post.frontmatter.date),
  changeFrequency: 'monthly' as const,
  priority: 0.7,
}))

2. Open Graph Images voor Blog Posts

// app/(marketing)/blog/serie/[serieId]/[slug]/page.tsx
// In generateMetadata:
openGraph: {
  images: [
    {
      url: post.frontmatter.image || `${siteUrl}/og-blog-default.png`,
      width: 1200,
      height: 630,
      alt: post.frontmatter.title,
    },
  ],
}

3. Article Structured Data

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Post Title",
  "author": {
    "@type": "Person",
    "name": "Colin van der Heijden"
  },
  "datePublished": "2024-11-19",
  "publisher": {
    "@type": "Organization",
    "name": "AI Speedrun"
  }
}

4. Breadcrumbs

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://aispeedrun.vercel.app"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://aispeedrun.vercel.app/blog"
    }
  ]
}

📊 Monitoring & Validatie

Na implementatie, valideer met:

Google Search Console
Google Rich Results Test
Facebook Sharing Debugger
Twitter Card Validator
Schema.org Validator

📝 Notities

Website is primair in het Nederlands - hreflang niet nodig tenzij meertaligheid wordt toegevoegd
Blog content is sterk - focus op technische SEO om dit te ondersteunen
Build-in-public aanpak is uniek - kan gebruikt worden voor content marketing SEO

6.8 KiB Raw Permalink Blame History