v1.0

Piqqr voor AI & Developers

Integreer 190.000+ Nederlandse autolistings in je AI-assistent, chatbot of applicatie. Via onze MCP server of REST API.

MCP Server

Gebruik onze Model Context Protocol server met Claude Desktop, Claude Code, of elke MCP-compatible client.

Setup guide

REST API

Zoek, filter en haal autodata op via onze REST API. Momenteel in beta — vraag een API key aan voor toegang.

API docs

MCP Server

De Piqqr MCP server biedt 3 tools waarmee AI-assistenten auto's kunnen zoeken, vergelijken en persoonlijk mobiliteitsadvies kunnen geven.

Quick Start — Claude Desktop

Voeg het volgende toe aan je Claude Desktop configuratie (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "piqqr": {
      "command": "npx",
      "args": ["-y", "piqqr-mcp-server"],
      "env": {}
    }
  }
}

Of via SSE (remote)

SSE endpoint

GET https://piqqr.nl/mcp/sse

// De SSE transport kan gebruikt worden door elke
// MCP-compatible client die SSE ondersteunt.
// Rate limit: 60 requests per minuut.

Beschikbare Tools

search_cars

Zoek en vergelijk auto's in Nederland — koop, occasion, private lease en zakelijke lease. Doorzoekt 190.000+ listings.

Parameters

makestringAutomerk, bijv. "Volkswagen"

modelstringModel, bijv. "Golf"

typeenum"occasion" | "new" | "private_lease" | "business_lease"

max_pricenumberMax prijs (koop) of maandbedrag (lease)

fuel_typeenum"petrol" | "diesel" | "electric" | "hybrid"

min_yearnumberBouwjaar vanaf

max_mileagenumberMax kilometerstand

citystringStad of regio

limitnumberAantal resultaten (1-20, default 10)

Voorbeeld

// "Zoek een elektrische auto op lease onder €400/mnd"
{
  "name": "search_cars",
  "arguments": {
    "fuel_type": "electric",
    "type": "private_lease",
    "max_price": 400,
    "limit": 5
  }
}

autoscan_advice

Persoonlijk advies of lease of kopen beter past. Gebaseerd op de Piqqr Autoscan.

Parameters

situationenumrequired"particulier" | "zzp" | "zakelijk"

monthly_budgetnumberrequiredMaandbudget in euro (200-2000)

annual_kmenumrequired"10000" | "15000" | "20000" | "25000"

car_typeenumrequired"stadsauto" | "gezinsauto" | "suv" | "sportief" | "geen_voorkeur"

fuel_preferenceenumrequired"benzine" | "diesel" | "elektrisch" | "hybride" | "geen_voorkeur"

durationenumrequired"1-2_jaar" | "3-4_jaar" | "5+_jaar" | "weet_niet"

Voorbeeld

// "Ik ben ZZP'er, budget €500/mnd, rij 20k km/jaar,
//  zoek een SUV, hybride, voor 3-4 jaar"
{
  "name": "autoscan_advice",
  "arguments": {
    "situation": "zzp",
    "monthly_budget": 500,
    "annual_km": "20000",
    "car_type": "suv",
    "fuel_preference": "hybride",
    "duration": "3-4_jaar"
  }
}

get_car_details

Haal volledige details op van een auto, inclusief RDW-data en lease-voorwaarden.

Parameters

listing_idstringrequiredHet Piqqr listing ID (UUID)

Voorbeeld

// Haal details op van een specifieke listing
{
  "name": "get_car_details",
  "arguments": {
    "listing_id": "a1b2c3d4-e5f6-..."
  }
}

// Retourneert: merk, model, variant, prijs, specs,
// foto's, dealer info, RDW data, lease voorwaarden

REST API

Doorzoek 190.000+ Nederlandse autolistings via onze REST API.

De Piqqr API is momenteel in beta

Vraag een API key aan om toegang te krijgen. Dit voorkomt misbruik en geeft ons inzicht in hoe de API gebruikt wordt. We sturen je de key zo snel mogelijk toe.

Endpoint

GET

GET https://piqqr.nl/api/public/search

Parameters (query string):
  make      - Automerk (bijv. "volkswagen")
  model     - Model (bijv. "golf")
  type      - "private_lease" | "zakelijk_lease" | "occasion" | "koop"
  maxPrice  - Maximum prijs in euro
  fuel      - "petrol" | "diesel" | "electric" | "hybrid"
  limit     - Max resultaten (default 20, max 50)

Rate limit: 60 requests per minuut per IP
Cache: 5 minuten

Voorbeeld

curl

curl "https://piqqr.nl/api/public/search?make=tesla&type=private_lease&maxPrice=500"

# Response:
{
  "results": [
    {
      "id": "abc-123",
      "make": "Tesla",
      "model": "Model 3",
      "price_eur": 449,
      "year": 2024,
      "fuel_type": "electric",
      "listing_type": "private_lease",
      "piqqr_url": "https://piqqr.nl/aanbod/abc-123"
    }
  ],
  "total": 42,
  "filters_applied": {
    "make": "tesla",
    "type": "private_lease",
    "maxPrice": 500
  }
}

Interactieve API Docs OpenAPI Spec

AI Plugin Manifest

Voor AI-systemen die het OpenAI plugin-formaat ondersteunen, bieden we een manifest aan:

/.well-known/ai-plugin.json

{
  "schema_version": "v1",
  "name_for_human": "Piqqr Auto Zoeken",
  "name_for_model": "piqqr_auto_search",
  "description_for_model": "Search Dutch car listings including buy,
    occasion, private lease and business lease. Filter by make,
    model, price, fuel type. Returns structured car data.",
  "api": {
    "type": "openapi",
    "url": "https://piqqr.nl/api/public/openapi.json"
  },
  "auth": { "type": "none" }
}

Klaar om te bouwen?

Begin direct met onze MCP server of REST API. Heb je vragen? Neem contact met ons op.

Probeer de Autoscan Contact opnemen