koopje-search
Search koopje.ai for Belgian second-hand deals and auctions. Skill: koopje-search Owner: antarcticaice Summary: Search koopje.ai for Belgian second-hand deals and auctions. Tags: latest:1.0.17 Version history: v1.0.17 | 2026-10-07T07:18:27.600Z | auto - Added "auctim" to the list of supported auction-house sources. - Minor documentation updates to reflect the expanded source coverage. - Removed the obsolete skill-card.md file. v1.0.16 | 2026-10-02T14:36:56.562Z | auto - Added
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.17
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.17release · observed Oct 7, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s170rf08skjvq3c8ct6ptsyjy58dn6we:koopje-search- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-antarcticaice-koopje-search/snapshot"
Documentation
CLAWHUB
147,909 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: koopje-search
description: Search koopje.ai for Belgian second-hand deals and auctions.
version: 1.0.17
author: Lukas, koopje.ai
license: MIT
metadata:
openclaw:
requires:
env:
- KOOPJE_API_KEY
hermes:
tags: [koopje, search, second-hand, belgium, api]
---
# koopje.ai search API
Search ~155k Belgian second-hand listings and live auctions via the
koopje.ai REST API. The index aggregates 2dehands.be, auction houses,
Troc.com, Think Twice, De Striep Promo, Marktplaats, Zoekertjes.be and Belgian car dealers, plus user ads:
| source | what it is |
|---|---|
| `2dehands` | private sellers on 2dehands.be (Belgium's largest marketplace) |
| `trader` | professional occasion sellers on 2dehands.be |
| `troc` | Troc.com second-hand store inventory (Belgian stores) |
| `thinktwice` | Think Twice vintage chain webshop Think2.eu (fixed price, kringloop) |
| `strieppromo` | De Striep Promo Belgian strip shop, second-hand wall (fixed price, tweedehands) |
| `marktplaats` | Belgian listings on Marktplaats.nl |
| `zoekertjes` | free classifieds on Zoekertjes.be |
| `kringwinkel` | Kringwinkel.be thrift webshop (fixed price) + veilingsite (auction lots); one source, `listing_type` splits them |
| `user` | user-submitted own ads (live at `https://koopje.ai/<category>/<slug>-<id>`, 30-day expiry) |
| car-dealer domains | Belgian cars carry their dealer/platform as source: `autoscout24.be`, `gocar.be`, `mazdastock.be`, `vroom.be`, `autohero.com`, `irisautocenter.be`, `autocadre.com` (resolved from listings, never the aggregator) |
| auction-house slugs | auction lots carry their house as source: `alleveilingen`, `vavato`, `troostwijk`, `auctelia`, `belga-veilingen`, `vlavem`, `auctionport`, `openbare-verkopen`, `bopa`, `hammertime`, `veilbalie`, `komerco`, `lussis`, `bell-auction`, `industrial-auctions`, `appelboom`, `auctim` (house name also in `seller_name`) |
Every result also carries `listing_type`: `veiling` (any auction house),
`kringloop` (Troc.com + Kringwinkel shop) or `tweedehands` (everything
else) — repeatable for multiselect, independent of source.
## When to use
Triggers: finding, comparing or pricing used items ("tweedehands",
"koopjes", "second-hand"), auction lots ("veiling"), or Belgian
marketplace listings — e.g. "find a used bike in Gent", "wat kost een
tweedehands espresso-machine?", "similar to <listing url>".
## Prerequisites
- `KOOPJE_API_KEY` env var, a `kk_...` key from koopje.ai (account →
"API keys"; shown once at creation).
## How to call
All endpoints: `https://koopje.ai`, auth header on every request:
`Authorization: Bearer $KOOPJE_API_KEY`. JSON responses, CORS enabled.
### POST-free quickstart — GET /v1/search
```
curl -s "https://koopje.ai/v1/search?q=vintage+stoel&price_max=200&limit=5" \
-H "Authorization: Bearer $KOOPJE_API_KEY"
```
Key parameters (full list in `references/api.md`):
| param | notes |
|---|---|
| `q` | required, natural language or keywords (Dutch works best) |
| _meta.json
{
"ownerId": "kn75qdj5yqrfxrwjd9tq8atz8n8dnsea",
"slug": "koopje-search",
"version": "1.0.17",
"publishedAt": 1791357507600
}references/api.md
# koopje.ai /v1 API reference
Base: `https://koopje.ai` — all requests need `Authorization: Bearer kk_...`.
All responses JSON; `/v1/*` sends `Access-Control-Allow-Origin: *`.
Errors: 401 missing/invalid key · 401 revoked key · 400 invalid params ·
429 rate limited.
## GET /v1/search
Semantic + keyword search over the unified index.
| param | type | required | description |
|---|---|---|---|
| `q` | string | yes | natural language or keywords (Dutch works best) |
| `type` | string | no | `auto` (default) · `neural` · `keyword` |
| `source` | string | no | exact origin: `2dehands` (2dehands.be platform incl. traders) · `troc` · `thinktwice` (Think Twice vintage) · `marktplaats` · `zoekertjes` · `kringwinkel` (thrift webshop + veilingsite, split by `listing_type`) · car-dealer domain (`autoscout24.be`, `gocar.be`, `mazdastock.be`, `vroom.be`, `autohero.com`, `irisautocenter.be`, `autocadre.com`) · auction house slug (`vavato`, `troostwijk`, `auctelia`, `belga-veilingen`, `vlavem`, `auctionport`, `openbare-verkopen`, `bopa`, `hammertime`, `veilbalie`, `komerco`, `lussis`, `bell-auction`, `industrial-auctions`, `appelboom`, `auctim`) · legacy bucket aliases: `2dehands`/`trader` → all tweedehands, `veiling` → all auctions |
| `listing_type` | string | no | `tweedehands` (all second-hand) · `veiling` (all auction lots, every auction house) · `kringloop` (thrift stores) — repeatable for multiselect |
| `price_min` | number | no | minimum price in euro |
| `price_max` | number | no | maximum price in euro |
| `no_price` | bool | no | `0` hides listings without a price (default `1` shows them) |
| `limit` | number | no | default 24; max 100 (`keyword`) or 50 (`neural`/`auto`) |
| `offset` | number | no | skip N results ("toon meer" pagination) |
| `postcode` | string | no | 4-digit Belgian postcode ("2000") — results filtered to `max_km` around it and annotated with `_distance_km` |
| `lat` / `lng` | number | no | raw user coordinates (alternative to `postcode`) |
| `max_km` | number | no | radius in km around the user location (omit = no limit). Listings without any locatable city/coords are excluded when a location filter is active |
`hasMore` is exact (server gathers limit+1 survivors past availability /
title-dedup filters) — page with `offset` while it is true.
Response:
```json
{
"requestId": "…",
"resolvedSearchType": "auto",
"hasMore": true,
"results": [
{
"url": "https://www.2dehands.be/v/…",
"title": "…",
"description": "short snippet",
"price_value": 60.0,
"price_text": "60 EUR",
"location": "Borgerhout",
"source": "2dehands",
"thumbnail_url": "…",
"_score": 0.83
}
]
}
```
`source` values in results: `2dehands` (private sellers on 2dehands.be),
`trader` (professional occasion sellers on 2dehands.be), `troc` (Troc.com
store inventory), `thinktwice` (Think Twice vintage webshop), `strieppromo` (De Striep Promo second-hand strips), `marktplaats` (Belgian listings on Mskill-card.md
## Description: Search koopje.ai for Belgian second-hand deals and auctions. This skill is ready for commercial/non-commercial use. ## Publisher: [antarcticaice](https://clawhub.ai/user/antarcticaice) ### License/Terms of Use: MIT-0 ## Use Case: Shoppers and agents search and compare Belgian second-hand listings and auction lots, inspect listing details, and optionally manage saved or owned listings with the user's permission. ### Deployment Geography for Use: Global (search coverage focuses on Belgian listings) ## Known Risks and Mitigations: Risk: Searches and location details are sent to koopje.ai using the user's API key. Mitigation: Use only when the user intends to share the search and any provided location details with koopje.ai. Risk: Saving, removing, renewing, or publishing listings can change the user's account or make an ad public. Mitigation: Require an explicit request and final confirmation before each account-changing action, especially for public listings or precise coordinates. ## Reference(s): - [ClawHub skill release](https://clawhub.ai/antarcticaice/skills/koopje-search) - [koopje.ai API documentation](https://koopje.ai/api) - [Included API reference](references/api.md) ## Skill Output: **Output Type(s):** [Text, Markdown, Shell commands] **Output Format:** [Markdown summaries with listing links and optional API examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Results include available prices, locations, and original listing sources.] ## Skill Version(s): 1.0.17 (source: server release metadata and frontmatter) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/antarcticaice/skills/koopje-search",
"sourceUrl": "https://clawhub.ai/antarcticaice/skills/koopje-search",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:44:37.914Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-antarcticaice-koopje-search/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-antarcticaice-koopje-search/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T10:44:37.914Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceUrl": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:44:37.914Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.17",
"href": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceUrl": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-07T07:18:27.600Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-antarcticaice-koopje-search/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-antarcticaice-koopje-search/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.17",
"description": "- Added \"auctim\" to the list of supported auction-house sources. - Minor documentation updates to reflect the expanded source coverage. - Removed the obsolete skill-card.md file.",
"href": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceUrl": "https://clawhub.ai/antarcticaice/koopje-search",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-07T07:18:27.600Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
