Screpy’s Checker voor Gestructureerde Gegevens onderzoekt JSON-LD van een openbare pagina of uit geplakte code. De tool vindt parseerfouten, toont gedeclareerde entiteiten en meldt problemen met geselecteerde eigenschappen voor vijf ondersteunde schematypen. Gebruik het rapport om te bepalen wat je moet herstellen en wat een bredere controle nodig heeft. Geldige syntaxis, ondersteunde controles en geschiktheid voor een uitgebreid Google-resultaat zijn afzonderlijke vragen; een groene status beantwoordt ze niet alle drie.
Kies een pagina-URL of geplakte JSON-LD
Selecteer Pagina-URL om een gepubliceerde pagina te onderzoeken, zoals een productdetailpagina of de contactpagina van een bedrijf. Voer het openbare HTTP- of HTTPS-adres van die pagina in in plaats van standaard de homepage: verschillende sjablonen kunnen verschillende markup bevatten. De URL-modus leest de HTML die de pagina terugstuurt. Een privépagina of pagina met wachtwoordbeveiliging levert niet hetzelfde openbare bewijs; een mislukte aanvraag bewijst niet dat de gestructureerde gegevens kapot zijn.
Selecteer Code plakken om een concept, een geëxtraheerd script of HTML die je al hebt te bekijken. Kies JSON-LD voor de JSON zelf, zonder een omringend <script>-element. Kies HTML wanneer je invoer blokken met <script type="application/ld+json"> bevat. Het adres van een los JSON-bestand is geen HTML-pagina; plak de inhoud in JSON-LD-modus. Geplakte invoer is beperkt tot 256 KiB, gemeten in UTF-8-bytes. Het toegestane aantal tekens hangt daardoor van de tekst af.
URL-controles voeren geen JavaScript uit. Markup die na het laden wordt toegevoegd, kan ontbreken in de opgehaalde bron. Google kan dynamisch ingevoegde JSON-LD verwerken, dus een ontbrekend blok in dit rapport bewijst niet dat Google niets ziet. Bekijk de relevante gerenderde markup of gebruik Googles functietest als dat onderscheid belangrijk is. Geplakte code controleert je invoer, maar stelt niet vast wat de gepubliceerde pagina daadwerkelijk levert.
Lees het rapport over gestructureerde gegevens
Begin bij de dekking, bekijk daarna de bevindingen en de entiteitentabel. JSON-LD-blokken telt de scripts die in HTML zijn gevonden; geplakte JSON-LD geldt als één blok. Entiteiten telt de bewaarde objecten met een gedeclareerd type waarvan de JSON succesvol is geparseerd; één script kan meerdere entiteiten bevatten. Syntaxfouten telt verwerkte blokken die niet geparseerd konden worden. Dit zijn verschillende aantallen: een pagina met drie blokken hoeft geen drie entiteiten te hebben. Bij een gedeeltelijk rapport bewijst het aantal gevonden blokken niet dat elk blok is onderzocht.
Elke rij maakt onderscheid tussen Syntax en Bereik. Geldige syntaxis in groen betekent dat de JSON-parser het blok heeft geaccepteerd. Ondersteunde controles in groen betekent dat de entiteit voldeed aan de voorwaarden voor de geselecteerde eigenschapscontroles van deze tool. Lees ook de bevindingen: geen van beide labels bewijst dat alle eigenschappen correct zijn. Rood markeert parseerfouten of foutbevindingen, geel wijst op waarschuwingen en gedeeltelijke dekking, grijs op niet ondersteund of niet beschikbaar bewijs. Lees de geschreven status naast de kleur.
De kolom Pad helpt bij het vinden van geneste objecten. $.author verwijst bijvoorbeeld naar het auteursobject binnen de root, terwijl $.@graph[1] naar het tweede object in een @graph-array verwijst. Paden zijn relatief ten opzichte van hun JSON-LD-blok. Hetzelfde pad kan dus in meerdere scripts voorkomen; de gedownloade JSON bevat bloknummers om ze te onderscheiden.
De kolom Naam leest name, niet de weergave-eigenschap van elk type. Een Article met een geldige headline kan daarom een lege Naam-cel hebben. Bekijk de relevante eigenschap en bevinding voordat je die lege cel als inhoudsfout behandelt.
Herstel JSON-syntaxis vóór eigenschapswaarschuwingen
Een ongeldig blok levert geen betrouwbare bevindingen over entiteiten. Herstel eerst de JSON en voer de controle opnieuw uit voordat je waarschuwingen over ontbrekende eigenschappen interpreteert. Veelvoorkomende oorzaken zijn enkele aanhalingstekens rond namen of tekst, een extra komma na de laatste eigenschap, een ontbrekend sluitend haakje en een niet geëscapet aanhalingsteken in tekst. JSON gebruikt dubbele aanhalingstekens en komma’s tussen leden; RFC 8259 definieert de grammatica.
Deze fictieve Organization is een minimaal syntaxisvoorbeeld voor Code plakken → JSON-LD:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Example Studio",
"url": "https://example.com/"
}
Het voorbeeld bevat de twee eigenschappen waar deze checker bij Organization naar zoekt. Het is geen volledig sjabloon voor een Google-zoekfunctie. Vervang fictieve waarden door correcte paginagegevens en raadpleeg vóór publicatie de eisen van de betreffende functie.
Geldige JSON alleen bewijst niet dat de gestructureerde gegevens bruikbaar zijn. Een losse tekenreeks of een getal kan geldige JSON zijn, maar beschrijft niet de verwachte entiteit; de tool meldt dat de root een object of array nodig heeft. Ook kan een geparseerd object zonder gedeclareerde @type geen entiteitsrijen opleveren. Controleer de werkelijke structuur voordat je eigenschappen toevoegt alleen om meldingen uit het rapport te verwijderen.
Welke schema-eigenschappen worden gecontroleerd?
De Checker voor Gestructureerde Gegevens past geselecteerde controles toe op vijf exacte typen wanneer hun context wordt herkend. Gebruik de tabel om een bevinding te begrijpen, niet als volledige lijst met Schema.org-eigenschappen of verplichte Google-velden.
| Gedeclareerd type | Wat deze checker onderzoekt | Hoe je de bevinding gebruikt |
|---|---|---|
Organization |
Aanwezigheid van name en url |
Controleer of ze de echte organisatie en de juiste website beschrijven. |
LocalBusiness |
Aanwezigheid van name en address |
Bekijk de echte bedrijfsidentiteit en het adres; adresonderdelen worden niet volledig gevalideerd. |
Article |
Aanwezigheid van headline, author, datePublished en image |
Vergelijk de waarden met het artikel en controleer de formaten afzonderlijk. |
Product |
Aanwezigheid van name; of offers, review of aggregateRating is opgegeven |
Gebruik alleen waarheidsgetrouwe, toepasselijke productgegevens. Verzin geen aanbieding of beoordeling om een waarschuwing te verwijderen. |
BreadcrumbList |
Niet lege itemListElement-array; een positieve gehele position en niet lege tekst in name voor elk onderzocht item |
Herstel het genoemde item en controleer daarna het volledige navigatiepad en de bestemmings-URL’s afzonderlijk. |
De meeste controles kijken naar aanwezigheid. Een waarde kan bestaan terwijl de URL, datum, afbeelding, objectstructuur of feitelijke inhoud verkeerd is. Een leeg object kan aan een aanwezigheidscontrole voldoen; waarden met uitsluitend spaties worden niet door elke controle afgewezen. Een ondersteunde status bevestigt dus niet dat een adres, auteur of aanbieding volledig is.
Breadcrumb-controles bekijken ook de geselecteerde itemwaarden, maar stellen niet vast dat posities opeenvolgend of uniek zijn, dat item-URL’s kloppen of dat de volledige ListItem-semantiek correct is. Het rapport bewaart maximaal 100 eigenschapsbevindingen per entiteit. Een lang navigatiepad of een entiteit met veel herhaalde gebreken kan daarna extra beoordeling nodig hebben.
Herstel een bevinding binnen de context van de pagina. Is de auteur van een artikel een persoon, behoud dan de correcte auteursstructuur, ook wanneer de geneste Person buiten het bereik van deze checker valt. Waarheidsgetrouwe markup aanpassen alleen voor groene labels kan het oorspronkelijke probleem verbergen in plaats van oplossen.
Waarom is geldige markup niet ondersteund of gedeeltelijk gecontroleerd?
Niet ondersteund betekent dat de tool zijn geselecteerde eigenschapscontroles niet op die entiteit heeft toegepast. Het betekent niet dat Schema.org het type verbiedt. Een ondersteunde Article kan bijvoorbeeld een geneste Person-auteur bevatten. Article krijgt de geselecteerde controles, maar Person wordt als niet ondersteund getoond, waardoor de dekking gedeeltelijk wordt. Ook Restaurant valt buiten de vijf exact ondersteunde typen, hoewel het een specifieker bedrijfstype is. Behoud het type dat het onderwerp correct beschrijft en gebruik een bredere validator voor de overige controles.
De context kan hetzelfde onderscheid veroorzaken. Deze checker herkent een eenvoudige http://schema.org- of https://schema.org-context, met of zonder afsluitende slash, ook wanneer die van een bovenliggend object wordt overgenomen. Object- of arraycontexten worden niet opgelost. Die vormen kunnen geldig zijn volgens de W3C-specificatie voor JSON-LD-contexten. Als een entiteit meerdere typen declareert, moeten die allemaal tot de ondersteunde set behoren voordat de eigenschapscontroles worden uitgevoerd.
De dekking is ook begrensd. De checker bekijkt de eerste 50 JSON-LD-blokken en bewaart maximaal 500 resultaatrijen, inclusief rijen van ongeldige blokken. Het doorlopen stopt boven 32 nestingsniveaus of 10.000 bezochte waarden per blok. Hierdoor kunnen latere entiteiten ongecontroleerd blijven. Microdata of RDFa die in HTML worden gevonden, maken het rapport eveneens gedeeltelijk, omdat die formaten hier niet worden gevalideerd.
Verdeel grote geplakte invoer in volledige JSON-LD-blokken voor afzonderlijke controles. Knip geen object halverwege door, waardoor een nieuwe syntaxisfout ontstaat. Bewaar de oorspronkelijke bron en noteer welke delen elk rapport dekt. Deze controles worden niet automatisch samengevoegd tot een volledige pagina-audit.
Controleer de pagina nadat je de markup hebt hersteld
Vergelijk de markup eerst met wat een bezoeker op de pagina kan lezen. Controleer identiteiten, datums, adressen, productdetails en eventuele beoordelingen aan de hand van de echte inhoud. Googles richtlijnen voor gestructureerde gegevens vereisen relevante, juiste informatie en naleving van de toepasselijke functie-eisen; een parser kan die feiten niet bevestigen. Voeg geen verzonnen details toe om een eigenschapswaarschuwing weg te werken.
Kies de volgende controle op basis van de onbeantwoorde vraag. Gebruik de Schema.org Markup Validator voor een bredere beoordeling van Schema.org-markup, inclusief Microdata en RDFa. Ook die heeft beperkingen: andere context-URL’s worden niet opgehaald of geïnterpreteerd. Gebruik Googles Test voor uitgebreide resultaten om ondersteunde Google-zoekfuncties en hun gemelde fouten of waarschuwingen te onderzoeken. Slagen voor een test garandeert niet dat Google een uitgebreid resultaat toont.
Als je bedrijfsmarkup voorbereidt, kan de Lokale Bedrijfsschema-generator JSON-LD maken van je echte gegevens. Bekijk de uitvoer vóór publicatie. Specifieke bedrijfstypen en geneste PostalAddress-objecten kunnen in deze checker niet ondersteund blijven; genereren en geselecteerde validatie zijn verschillende taken.
Voer na een correctie de relevante controle opnieuw uit op de gepubliceerde pagina, niet alleen op het concept. Bevestig dat de geleverde markup de bedoelde wijziging bevat en vergelijk de resterende bevindingen. Gebruik JSON downloaden om bloknummers, entiteitspaden, bevindingen en dekking van die uitvoering te bewaren. Bewaar invoer en bereik samen met de export, zodat een andere beoordelaar het bewijs kan begrijpen. Een opgeslagen rapport legt een controle vast; het bewaakt toekomstige sjabloon- of inhoudswijzigingen niet doorlopend.