Marktplaats Publisher#

Gebruik deze skill voor normale Marktplaats-advertenties: voorbereiden, plaatsen, bewerken, live controleren en lokaal registreren.

De workflow is command-first. Proceduretekst is alleen toelichting. Als een gate faalt, stop je.

Voor kleinere modellen: doe steeds een fase, lees de output, en ga pas door als de vorige fase aantoonbaar geslaagd is. De scripts zijn harde gates; publiceren en UI-invulwerk blijven browserwerk met verificatie, geen blinde submit-flow.

Setup En Modelmodus#

Als de taak installatie, eerste setup of herstel van de skill is, laad references/setup-small-model-nl.md.

Package-identiteit:

• correcte skill/package: marktplaats-publisher;
• oude namen zoals marktplaats, marktplaats-nl-publisher of pvoo/marktplaats zijn niet de doel-skill;
• vereiste runtime: Node.js 18 of nieuwer;
• vereiste smoke-test: npm test vanuit de skillmap.

Voor lichte modellen zoals GPT-4.5 mini of de lokaal beschikbare mini-route geldt dit contract:

• voer steeds precies een gate uit;
• lees de output volledig;
• ga alleen door bij expliciet PASS, self-test ok of exitcode 0 met verwachte output;
• bij failure: repareer een oorzaak, draai dezelfde gate opnieuw, maximaal twee herstelpogingen per foutklasse;
• publiceer, bewerk of submit niets als setup, copy-QA, preflight of probe niet aantoonbaar groen is;
• houd per advertentie een klein statusblok bij met adDir, adJson, description, currentGate, lastCommand, result en nextStep.

Als globale CLI-commando's ontbreken, gebruik vanaf de skillmap de directe fallback:

bash

node ./scripts/marktplaats-place-probe.js --self-test
node ./scripts/marktplaats-copy-qa.js --self-test
node ./scripts/marktplaats-ad-preflight.js --self-test
node ./scripts/marktplaats-live-verify.js --self-test
node ./scripts/marktplaats-register-update.js --self-test

Harde Regels#

• Geen publicatie of inhoudelijke bewerking zonder expliciete opdracht voor die advertentie.
• Geen betaalde opties, bundels, promoties of betaalflow zonder expliciet akkoord.
• Geen cookies, sessietokens, XSRF/auth-waarden, klantdata of lokale privepaden loggen of publiceren.
• Geen captcha, MFA, login challenge, WAF of accountbeveiliging omzeilen.
• Geen tekst plaatsen als copy-QA of preflight faalt.
• Gebruik --allow-* opties alleen bij expliciete, taak-specifieke uitzondering van de gebruiker.
• Publiceerbare advertentietekst mag nooit websiteadressen of domeinachtige tekst bevatten. Verboden zijn onder andere http://, https://, www., e-mailadressen en woorden met bekende domeinextensies zoals .com, .nl, .eu, .org, .net, .de, .be en .io. Merknamen met een domeinextensie, zoals StarTech.com, moeten worden herschreven naar een gewone merknaam zonder punt, bijvoorbeeld StarTech.
• Publiceer of accepteer geen advertentie waarvan de live omschrijving als een grote lap tekst verschijnt. De lokaal geschreven alinea's moeten live aantoonbaar bewaard blijven via alinea's, <br>-achtige regelovergangen of Marktplaats-blokken.
• Na opslaan altijd live verifieren en het lokale register bijwerken.
• Bij UI-drift, browser-hang of onduidelijke formulierstatus: stop, maak een snapshot en rapporteer de blokkade.

Safari Rustig Gebruiken#

Laad references/background-safari-nl.md bij plaats-/bewerkwerk met Safari.

Voorkeursvolgorde:

1. Gebruik gewone HTTP/API/zoek-CLI waar geen login nodig is.
2. Gebruik marktplaats-place-probe --browser-fetch --url ... voor authenticated inspectie zonder zichtbare navigatie.
3. Gebruik marktplaats-place-probe --browser --open-background ... om een pagina in Safari te openen zonder Safari actief te maken.
4. Gebruik zichtbare UI alleen als foto-upload, contenteditable tekst of expliciete controle dat vereist.

Regels:

• activeer Safari niet onnodig en open geen extra schermen bovenop het werk van de gebruiker;
• gebruik een bestaande of dedicated Marktplaats-tab; kies tabs op URL/ad-id, niet op schermpositie;
• herstel of laat de actieve gebruikerscontext ongemoeid waar mogelijk;
• log geen cookies, tokens, XSRF-waarden, contactgegevens of browserprofielinformatie;
• bij login/captcha/MFA/WAF, betaalroute, UI-drift of onduidelijke status: stop, schrijf een snapshot en rapporteer.

Lokale Bestanden#

Werk per advertentie in:

text

~/Documents/OpenClaw/Data/marktplaats/<slug>/ad.json
~/Documents/OpenClaw/Data/marktplaats/<slug>/description.md
~/Documents/OpenClaw/Data/marktplaats/<slug>/photos/

Centraal register:

text

~/Documents/OpenClaw/Data/marktplaats/advertenties.json

ad.json moet minimaal bevatten: titel, prijs, conditie, levering, categorie/categoryIds, biddingAllowed, descriptionFile, imageDir of foto's, URL/adId zodra live, en copyQuality.

Verplichte Pipeline#

1. Schrijf De Omschrijving#

Schrijf een feitelijke Nederlandse tekst van ongeveer 3200-3500 tekens.

Moet bevatten:

• merk/model of herkenbare productnaam;
• productsoort;
• staat/conditie en wat wel/niet getest is;
• concrete zichtbare kenmerken;
• toepassing en compatibiliteit;
• ophalen/verzenden, prijs en bieden;
• natuurlijke zoekvarianten in gewone zinnen;
• minimaal een, en bij voorkeur niet meer dan twee, subtiele productrelevante typefout-/schrijfvarianten in gewone zinnen. Voorbeeld: buiten antenne naast buitenantenne.

Niet doen:

• geen websiteadressen, domeinachtige merknamen, www.-tekst, URL's of e-mailadressen;
• geen Zoektermen:, Keywords: of SEO: footer;
• geen lange comma-keyworddump;
• geen claims over werking, garantie of compleetheid zonder bewijs.

2. Copy-QA#

Altijd draaien voordat Marktplaats wordt ingevuld of opgeslagen:

bash

marktplaats-copy-qa ./description.md \
  --require "<merk-of-model>" \
  --require "<productsoort>" \
  --variant "<natuurlijke zoekvariant>" \
  --ad-json ./ad.json

Stop als dit geen PASS geeft. De command schrijft copyQuality inclusief descriptionSha256 naar ad.json.

Herhaal --variant alleen voor een tweede minimale variant als die natuurlijk in de omschrijving past. Gebruik geen losse typefoutenlijst.

Copy-QA faalt bij URL's, www.-tekst, e-mailadressen en domeinachtige tekst zoals startech.com, ook als er geen protocol voor staat.

3. Preflight#

Altijd draaien na copy-QA en voor browser/UI-werk:

bash

marktplaats-ad-preflight --ad-json ./ad.json --require-bidding-allowed

Gebruik --require-bidding-allowed wanneer bieden aan moet staan. Stop bij failure.

Preflight controleert onder andere:

• verplichte advertentievelden;
• omschrijving bestaat en is niet gewijzigd na copy-QA;
• copy-QA is geslaagd;
• publiceerbare advertentietekst bevat geen URL's, www.-tekst, e-mailadressen of domeinachtige tekst;
• foto's bestaan;
• biedeninstelling indien vereist.

4. Formulier Probe#

Inspecteer Marktplaats voordat je invult. Kies de minst storende route die genoeg bewijs geeft.

Met browser-fetch:

bash

marktplaats-place-probe --browser-fetch --url "https://www.marktplaats.nl/plaats/..." --save ./snapshot-place.json

Als Safari niet de actieve app hoeft te worden, open de plaatsingspagina op de achtergrond en probe daarna dezelfde Safari-context:

bash

marktplaats-place-probe --browser \
  --open-background "https://www.marktplaats.nl/plaats/..." \
  --save ./snapshot-place.json

Als de juiste Marktplaats-tab al open staat:

bash

marktplaats-place-probe --browser --save ./snapshot-place.json

Stop als:

• login/captcha/MFA/WAF verschijnt;
• betaalde route verplicht lijkt;
• formulierstructuur onduidelijk is;
• foto-upload of bundelkeuze niet te verifieren is;
• security.challengeSignals login, captcha, MFA, WAF of betaal-/promotiesignalen toont.

5. Plaats Of Bewerk#

Vul Marktplaats pas na groene copy-QA en preflight.

Controleer voor submit/save:

• titel;
• prijs;
• bieden toegestaan indien gevraagd;
• conditie;
• levering;
• foto-aantal;
• gratis/basic route;
• laatste zin van de omschrijving zichtbaar in het formulier;
• alinea's zichtbaar in het omschrijvingsveld; gebruik bij voorkeur het zichtbare rich-text/contenteditable veld en geen directe hidden-field submit voor de omschrijving.

Gebruik geen blinde coordinate-clicks. Gebruik DOM/events of een expliciet UI-element met verificatie voor en na.

Gebruik geen directe hidden-field submit of platte URLSearchParams-post voor de omschrijving tenzij live-verificatie daarna bewijst dat alinea's bewaard zijn. Als Marktplaats de tekst ondanks correcte inhoud als een doorlopende lap toont, is de advertentie niet klaar.

6. Live Verify#

Na opslaan of plaatsen moet de live advertentie gecontroleerd worden.

Als fetch genoeg tekst bevat:

bash

marktplaats-live-verify --ad-json ./ad.json --url "https://www.marktplaats.nl/seller/view/..." --update-ad-json

Als de pagina dynamisch is, sla eerst zichtbare/live tekst op en verifieer die:

bash

marktplaats-live-verify --ad-json ./ad.json --text ./live-text.txt --update-ad-json

Stop als:

• begin van de omschrijving ontbreekt;
• laatste zin ontbreekt;
• omschrijving dubbel staat;
• Zoektermen: of keyworddump live zichtbaar is;
• live advertentietekst alsnog websiteadressen of domeinachtige tekst bevat;
• live omschrijving geen aantoonbare alinea-/regelstructuur heeft.

7. Register Update#

Werk na live verificatie het centrale register bij:

bash

marktplaats-register-update \
  --ad-json ./ad.json \
  --central-json ~/Documents/OpenClaw/Data/marktplaats/advertenties.json \
  --note "Live gecontroleerd na plaatsing/bewerking."

Run register-updates sequentieel. Het script gebruikt een lock en faalt als een tweede update tegelijk hetzelfde centrale register probeert te schrijven.

De register-update hoort standaard te falen als live-verificatie ontbreekt of faalde. Gebruik --allow-unverified alleen voor niet-gepubliceerde conceptadministratie en vermeld waarom in --note.

Bestaande Advertentie Bewerken#

Voor elke inhoudelijke tekstbewerking geldt dezelfde pipeline:

bash

marktplaats-copy-qa ./description.md --require "<term1>" --require "<term2>" --variant "<variant>" --ad-json ./ad.json
marktplaats-ad-preflight --ad-json ./ad.json --require-bidding-allowed
# bewerk via Marktplaats UI/DOM
marktplaats-live-verify --ad-json ./ad.json --url "<live-url>" --update-ad-json
marktplaats-register-update --ad-json ./ad.json --central-json ~/Documents/OpenClaw/Data/marktplaats/advertenties.json

Als live fetch de tekst niet ziet, gebruik --text ./live-text.txt met tekst uit de browser/accessibility snapshot.

Test De Skill#

bash

npm test

Deze test moet groen zijn voordat je publiceert naar ClawHub.

Naslag#

• Publieke uitleg: README.md
• Langere handleiding: references/handleiding-nl.md
• Engelse guide: references/guide-en.md
• Robuuste checklist: references/robust-posting-checklist.md
• Setup voor kleine modellen: references/setup-small-model-nl.md
• Rustige Safari/background-flow: references/background-safari-nl.md