Koppel je eigen AI-assistent.

Zoek tweedehands en veilingen zonder koopje.ai te openen — gewoon vanuit de assistent die je al gebruikt. In vijf minuten klaar, geen technische kennis nodig.

Stap 1

Haal je persoonlijke API key op

Je assistent heeft een API key nodig om namens jou te mogen zoeken. Zo haal je hem:

  1. Maak een gratis account en log in.
  2. Open je dashboard → API keys → Nieuwe API key.
  3. Kopieer de code (begint met kk_…). Je ziet hem maar één keer, dus bewaar hem meteen.

Gratis en fair use: normaal zoeken kan volop, de uitgebreide AI-antwoorden maximaal een paar keer per minuut. Kom je eroverheen, dan zegt hij dat er gewoon bij — er gaat niets stuk.

Stap 2

Kies je assistent

OpenClaw of Hermes

Gebruik je OpenClaw of Hermes? Dan is één bericht genoeg. Kopieer onderstaande tekst, plak hem in je assistent en druk op enter. Hij installeert alles zelf, vraagt om je API key en test de verbinding.

Installeer de koopje.ai-zoekskill, zodat je tweedehands advertenties en veilingkavels in België kunt doorzoeken.

1. Download https://koopje.ai/skill/koopje-search/SKILL.md en https://koopje.ai/skill/koopje-search/references/api.md
2. Bewaar ze als een skill met het API-referentiebestand in een references-submap, op de standaard skills-locatie van je platform (OpenClaw: ~/.openclaw/workspace/skills/koopje-search/ — Hermes: ~/.hermes/skills/web/koopje-search/).
3. Vraag me om mijn KOOPJE_API_KEY (begint met kk_) als je die nog niet hebt, en test de verbinding met GET https://koopje.ai/v1/stats en header Authorization: Bearer <mijn API key>.
4. Bevestig in één zin wat je installeerde en hoeveel er te doorzoeken valt (total uit /v1/stats).
Liever zelf installeren via de terminal? 
mkdir -p ~/.openclaw/workspace/skills/koopje-search/references
curl -s -o ~/.openclaw/workspace/skills/koopje-search/SKILL.md \
  https://koopje.ai/skill/koopje-search/SKILL.md
curl -s -o ~/.openclaw/workspace/skills/koopje-search/references/api.md \
  https://koopje.ai/skill/koopje-search/references/api.md
export KOOPJE_API_KEY="kk_plak_hier_je_key"
mkdir -p ~/.hermes/skills/web/koopje-search/references
curl -s -o ~/.hermes/skills/web/koopje-search/SKILL.md \
  https://koopje.ai/skill/koopje-search/SKILL.md
curl -s -o ~/.hermes/skills/web/koopje-search/references/api.md \
  https://koopje.ai/skill/koopje-search/references/api.md
export KOOPJE_API_KEY="kk_plak_hier_je_key"

ChatGPT

Met een betaald ChatGPT-abonnement (Plus of Pro) maak je je eigen koopje-assistent. Zonder abonnement kan ChatGPT helaas geen externe diensten aanroepen.

  1. Ga naar ChatGPT → GPT's ontdekken → + Maken.
  2. Open het tabblad Configureren, scroll naar Acties en kies Importeren via URL. Plak daar deze link:
    https://koopje.ai/openapi.json
  3. Bij Verificatie kies je API key → type Bearer, en plak je je kk_…-key uit stap 1.
  4. Geef hem nog een instructie mee, bijvoorbeeld: “Antwoord altijd in het Nederlands, met prijs, plaats en link per resultaat.”

Je API key staat in jouw GPT — deel hem dus alleen met mensen die hem mogen gebruiken.

Claude Code

Gebruik je Claude Code? Kopieer onderstaand bericht, plak het in Claude Code en druk op enter. Hij installeert alles zelf, vraagt om je API key en test de verbinding.

Installeer de koopje.ai-zoekskill, zodat je tweedehands advertenties en veilingkavels in België kunt doorzoeken.

1. Download https://koopje.ai/skill/koopje-search/SKILL.md en https://koopje.ai/skill/koopje-search/references/api.md
2. Bewaar ze als een skill met het API-referentiebestand in een references-submap, op je standaard skills-locatie (~/.claude/skills/koopje-search/).
3. Vraag me om mijn KOOPJE_API_KEY (begint met kk_) als je die nog niet hebt, en test de verbinding met GET https://koopje.ai/v1/stats en header Authorization: Bearer <mijn API key>.
4. Bevestig in één zin wat je installeerde en hoeveel er te doorzoeken valt (total uit /v1/stats).
Liever zelf installeren via de terminal? 
mkdir -p ~/.claude/skills/koopje-search/references
curl -s -o ~/.claude/skills/koopje-search/SKILL.md \
  https://koopje.ai/skill/koopje-search/SKILL.md
curl -s -o ~/.claude/skills/koopje-search/references/api.md \
  https://koopje.ai/skill/koopje-search/references/api.md
export KOOPJE_API_KEY="kk_plak_hier_je_key"

Codex

Gebruik je Codex? Kopieer onderstaand bericht, plak het in Codex en druk op enter. Hij installeert alles zelf, vraagt om je API key en test de verbinding.

Installeer de koopje.ai-zoekskill, zodat je tweedehands advertenties en veilingkavels in België kunt doorzoeken.

1. Download https://koopje.ai/skill/koopje-search/SKILL.md en https://koopje.ai/skill/koopje-search/references/api.md
2. Bewaar ze als een skill met het API-referentiebestand in een references-submap, op je standaard skills-locatie.
3. Vraag me om mijn KOOPJE_API_KEY (begint met kk_) als je die nog niet hebt, en test de verbinding met GET https://koopje.ai/v1/stats en header Authorization: Bearer <mijn API key>.
4. Bevestig in één zin wat je installeerde en hoeveel er te doorzoeken valt (total uit /v1/stats).

n8n

Draai je eigen n8n? Importeer onze kant-en-klare koopjesagent: een AI-agent met twee koopje.ai-tools (zoeken en details ophalen). Eén keer je API key koppelen en chatten maar.

  1. Open onze kant-en-klare template op n8n.io en klik Use workflow.
  2. In n8n: Workflows → ⋯ → Import from clipboard en plak de workflow.
  3. Maak in n8n een Bearer Auth-credential: Credentials → New → Bearer Auth, en plak je kk_…-key uit stap 1 als Token.
  4. Open de twee tool-nodes (Zoek koopjes en Haal details op) en selecteer de credential bij Credential to connect with. Je key staat nergens in de workflow zelf.
  5. Open OpenRouter Chat Model en selecteer je model-credential — OpenRouter heeft gratis modellen om mee te beginnen.
  6. Open de chat in n8n en stel je vraag, bijvoorbeeld: “zoek een tweedehands e-bike onder €800 in Gent”.

De agent onthoudt het gesprek via Simple Memory — doorvragen in dezelfde chat kan dus gewoon.

Stap 3

Stel een proefvraag

Is alles gelukt? Stel je assistent dan bijvoorbeeld deze vraag:

zoek een tweedehands e-bike onder €800 in Gent

Krijg je advertenties terug met een prijs, een plaats en een link? Dan werkt alles. Vraag daarna gerust door — je assistent onthoudt het gesprek.