> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO

> Ontdek hoe SEO werkt in Macaly en hoe uw site presteert in zoekmachines en op social media

Macaly maakt automatisch sites die klaar zijn voor SEO. De SEO-audit laat zien hoe uw site ervoor staat en wat u kunt verbeteren, op uw gepubliceerde site of op een preview van de wijzigingen waar u nog aan werkt.

U hoeft geen plugins te koppelen. Alles is vanaf de basis voor u geregeld en Macaly helpt u met eventuele verbeteringen.

## Hoe SEO werkt in Macaly

Macaly rendert uw pagina's op de server. Zoekmachines zoals Google en Bing, maar ook AI-crawlers, krijgen daardoor de volledige inhoud van de pagina direct in de HTML. Elk project heeft zo vanaf het begin:

* **Betrouwbare indexering**: Uw inhoud staat al vanaf het eerste verzoek in de HTML, dus crawlers kunnen die lezen zonder JavaScript uit te voeren.
* **Schone code**: De HTML-structuur, meta-tags en paginametadata worden automatisch op elke pagina gegenereerd.
* **Zichtbaarheid direct na publicatie**: Uw pagina's zijn zichtbaar vanaf het moment dat u ze publiceert, zonder dat u iets hoeft in te stellen.

Juist hier maakt de gebruikte technologie het verschil. Sommige tools tonen de inhoud pas via JavaScript in de browser, waardoor crawlers die vaak niet zien bij de eerste doorloop. Macaly levert de inhoud direct aan.

## SEO-gezondheidsaudit

<Callout icon="user">
  Beschikbaar in de [**pakketten Pro en Bureaus**](/docs/nl/welcome/pricing)
</Callout>

Op het tabblad SEO in uw [chat](/docs/nl/chat/overview) vindt u de **SEO-gezondheid**-audit. Die controleert uw gepubliceerde site precies zoals zoekmachines en AI-crawlers die zien, geeft er een score aan en vertelt u wat u kunt verbeteren.

<img src="https://mintcdn.com/macaly-41b1d3e9/BPtgr3M1Dg7JgWnn/images/seo-health-audit.png?fit=max&auto=format&n=BPtgr3M1Dg7JgWnn&q=85&s=ae87eec77c211b4b3d5cf863c0ae2a43" alt="SEO-gezondheidsaudit met score, verdeling per categorie en de lijst met problemen" width="2400" height="1674" data-path="images/seo-health-audit.png" />

### Wanneer de audit wordt uitgevoerd

De audit wordt automatisch uitgevoerd telkens wanneer u uw wijzigingen publiceert. Macaly controleert uw gepubliceerde site opnieuw en werkt de resultaten bij.

Wijzigt u iets zonder het te publiceren, dan waarschuwt de audit dat uw project sinds de laatste publicatie is veranderd. Publiceer het opnieuw om actuele resultaten te zien. Daarna kunt u de audit ook handmatig uitvoeren.

### Controleren voordat u publiceert

U hoeft niet te publiceren om te weten hoe uw wijzigingen scoren. Vraag het de agent in de chat, bijvoorbeeld "Voer een SEO-audit uit op de huidige versie". Macaly zet uw huidige bewerkingen op een tijdelijke preview, controleert die en toont het rapport op het tabblad SEO, gemarkeerd als preview-audit.

Het previewrapport weerspiegelt het moment waarop de audit liep. Latere bewerkingen zitten er niet in, dus vraag om een nieuwe audit wanneer u die wilt nakijken. Uw gepubliceerde site en de bijbehorende resultaten blijven ongewijzigd tot u opnieuw publiceert.

### Uw score lezen

Bovenaan ziet u een totaalscore en een verdeling over zeven categorieën:

* **Meta-tags**: Titels, beschrijvingen, canonieke URL's en overige paginametadata.
* **Inhoud**: Koppen, alt-teksten van afbeeldingen en of pagina's genoeg tekst bevatten.
* **Technisch**: Sitemap, robots.txt-bestand, kapotte links en een eigen domein.
* **Social sharing**: Open Graph-tags, favicon en voorbeeldafbeeldingen.
* **Gestructureerde data**: JSON-LD-schema waarmee zoekmachines uw site beter begrijpen.
* **AI-gereedheid**: Hoe goed AI-crawlers bij uw inhoud kunnen en die begrijpen.
* **Prestaties**: Laadsnelheid en stabiliteit (gemeten met PageSpeed Insights).

Elke categorie heeft een eigen score, zodat u in één oogopslag ziet waar u sterk staat en waar nog ruimte voor verbetering is. Groen betekent dat alles in orde is, oranje wijst op ruimte voor verbetering en rood signaleert iets dat direct uw aandacht verdient.

### Problemen om op te lossen

Onder de totaalscore vindt u de lijst met problemen. Bij elk probleem ziet u tot welke categorie het behoort en hoeveel pagina's het betreft.

Problemen hebben twee niveaus:

* **Fouten** (rood) zijn ernstigere problemen die uw site afremmen, bijvoorbeeld een ontbrekende titel of een zeer trage laadtijd.
* **Waarschuwingen** (oranje) zijn aanbevelingen die uw site sterker maken, bijvoorbeeld een titel buiten de ideale lengte of een ontbrekende afbeelding voor social sharing.

Controles die in orde zijn, staan onderaan de lijst, zodat die alleen toont wat echt uw aandacht nodig heeft.

### Problemen herstellen met AI

U hoeft problemen niet handmatig op te lossen. Macaly stuurt ze rechtstreeks naar de agent in uw chat.

* **Alles herstellen met AI** geeft de hele lijst in één keer aan de agent. Die werkt de lijst door en voert de wijzigingen uit.
* **Herstellen met AI** bij een specifiek probleem stuurt alleen dat probleem naar de agent.

Zodra de agent klaar is, publiceert u uw project opnieuw, zodat de audit uw gepubliceerde site controleert en de resultaten bijwerkt.

<Note>
  De herstelacties worden uitgevoerd door de agent in uw chat, dus ze verbruiken credits net als elk ander verzoek. Het uitvoeren van de audit zelf is gratis en telt niet mee voor limieten.
</Note>

## Zoekweergave

<Callout icon="user">
  Beschikbaar in de [**pakketten Pro en Bureaus**](/docs/nl/welcome/pricing)
</Callout>

Onderaan het tabblad SEO in uw [chat](/docs/nl/chat/overview) vindt u een lijst met alle pagina's van uw project, inclusief de titel en beschrijving die in Google-zoekresultaten worden gebruikt.

Elke pagina wordt getoond als een voorbeeld van een zoekresultaat, zodat u de titel, de beschrijving en de afbeelding ziet die mensen krijgen wanneer de link wordt gedeeld.

<img src="https://mintcdn.com/macaly-41b1d3e9/BPtgr3M1Dg7JgWnn/images/seo-search-appearance.png?fit=max&auto=format&n=BPtgr3M1Dg7JgWnn&q=85&s=bb28bbd6bed59ce6dba8a7f232fa6f62" alt="Zoekweergave met een paginavoorbeeld en de site-assets" width="2400" height="1674" data-path="images/seo-search-appearance.png" />

Pagina's uit dynamische paden, zoals een sjabloon voor een blogartikel, staan apart in de lijst en zijn alleen-lezen. Hun metadata wordt door uw code gegenereerd, dus vraag de agent als u die wilt wijzigen.

### Een pagina bewerken

Klik bij een pagina op **Bewerken** om de instellingen te openen:

* **Titel**: De kop die in zoekresultaten wordt getoond.
* **Beschrijving**: De tekst onder de titel.

Het **Social media-voorbeeld** rechts wordt tijdens het bewerken bijgewerkt en laat zien hoe de pagina eruitziet wanneer die wordt gedeeld. Met de knop **Uploaden** voegt u een eigen afbeelding toe, met de knop **Resetten** keert u terug naar de oorspronkelijke afbeelding. De afbeelding mag PNG, JPG of GIF zijn, tot 5 MB, bij voorkeur 1200×630 px.

Klik daarna op **Wijzigingen opslaan**. Als de agent aan het werk is, zijn bewerkingen tijdelijk gepauzeerd.

<Note>
  De titel en beschrijving hebben geen lengtelimiet, maar de SEO-audit markeert titels buiten 30 tot 60 tekens en beschrijvingen buiten 50 tot 160 tekens als probleem. Bij het opslaan worden de wijzigingen in uw project geschreven, dus publiceer ze zodat ze uw gepubliceerde site en de volgende audit bereiken.
</Note>

### Site-assets

Twee bestanden gelden voor uw hele site:

* **App-icoon (favicon)**: Het kleine icoon op het tabblad van de browser en bij de favorieten. Accepteert ICO- of SVG-bestanden tot 100 kB.
* **Social media-afbeelding**: De standaardafbeelding die wordt gebruikt wanneer uw site wordt gedeeld. Accepteert PNG, JPG of GIF tot 5 MB, bij voorkeur 1200×630 px. Pagina's zonder eigen afbeelding gebruiken deze.

Klik op een kaart om een nieuwe afbeelding te uploaden, of op het oogpictogram om het huidige bestand te bekijken. Ontbreekt een van de afbeeldingen, dan verschijnt naast de kop de knop **Genereren**, die de agent vraagt om die op basis van uw project te maken.

### SEO voor het eerst instellen

Heeft uw project nog geen metadata, dan ziet u in plaats van de paginalijst de knop **SEO instellen**. Die vraagt de agent om titels en beschrijvingen voor uw bestaande pagina's te schrijven en een app-icoon en social media-afbeelding toe te voegen.

## Veelgestelde vragen

<AccordionGroup>
  <Accordion title="Hoe gaat Macaly om met SEO?">
    Macaly maakt sites die vriendelijk zijn voor zoekmachines. Rendering op de server, schone HTML en meta-tags regelt Macaly voor u. Zodra u uw project publiceert, geeft de SEO-audit uw site een score en vertelt wat u kunt verbeteren. U kunt meta-tags, paginatitels en beschrijvingen ook bewerken in **Instellingen → SEO**.
  </Accordion>

  <Accordion title="Waarom kan ik de SEO-audit niet uitvoeren?">
    De audit op het tabblad SEO controleert uw gepubliceerde site en blijft daarom vergrendeld tot u publiceert. Wilt u eerder een score, vraag de agent in de chat dan om een SEO-audit; hij controleert dan een preview van uw huidige wijzigingen.
  </Accordion>

  <Accordion title="Mijn SEO-audit lijkt verouderd. Hoe komt dat?">
    De audit weerspiegelt uw laatst gepubliceerde versie. Heeft u sindsdien iets gewijzigd, publiceer uw project dan opnieuw en de auditresultaten worden vernieuwd. U kunt de agent ook vragen om uw niet-gepubliceerde wijzigingen op een preview te controleren.
  </Accordion>

  <Accordion title="Wat is AI-gereedheid?">
    AI-gereedheid meet hoe goed AI-crawlers, bijvoorbeeld die van ChatGPT, Claude of Perplexity, bij uw site kunnen en die begrijpen. Er wordt gecontroleerd of uw inhoud direct op de pagina staat en niet pas via JavaScript wordt geladen, of AI-crawlers niet worden geblokkeerd en of er een llms.txt-bestand beschikbaar is om ze te sturen. Macaly rendert uw pagina's automatisch op de server.
  </Accordion>

  <Accordion title="Hoe verbeter ik mijn SEO-score?">
    Werk de lijst met problemen door, eerst de fouten en daarna de waarschuwingen. Gebruik de knop Alles herstellen met AI om alle problemen in één keer aan de agent te geven, of pak ze een voor een aan. Publiceer daarna uw wijzigingen en de score wordt bij de volgende audit bijgewerkt.
  </Accordion>

  <Accordion title="Mijn site verschijnt niet in Google-zoekresultaten. Wat kan ik doen?">
    Google-indexering kost tijd, vaak dagen tot weken. Om dit te versnellen, dient u uw site-URL in bij Google Search Console op search.google.com/search-console. U kunt uw URL ook op social media delen, aangezien Google links crawlt die het elders op het web vindt.
  </Accordion>

  <Accordion title="Kan ik een Macaly-site insluiten in een andere website via een iframe?">
    Technisch gezien ja, door uw gepubliceerde Macaly-URL in een iframe te gebruiken. De inhoud van iframes wordt echter slecht geïndexeerd door zoekmachines, wat een negatief effect heeft op uw SEO. Een betere aanpak is om Macaly als zelfstandige site te gebruiken met een eigen domein.
  </Accordion>
</AccordionGroup>
