# Facility Finder

> Facility Finder is het platform voor facilitaire dienstverlening in Nederland. Organisaties vinden hier dienstverleners voor schoonmaak, beveiliging, catering, groenvoorziening, technisch onderhoud en meer.

## Over Facility Finder

Facility Finder verbindt opdrachtgevers met facilitaire dienstverleners. Het platform biedt een overzicht van bedrijven die facilitaire diensten aanbieden, georganiseerd per categorie (zoals schoonmaak, beveiliging, catering) en per vorm van dienstverlening (zoals facilitair management, detachering, ZZP).

## Structuur

De site is als volgt georganiseerd:

- `/fm-marketplace` - Marketplace met alle dienstverleners, categorieen en vormen
- `/bedrijven/{slug}` - Individuele bedrijfspagina's met profiel, diensten en vestigingen
- `/bedrijven/{slug}/{categorie-slug}` - Bedrijf met specifieke dienstcategorie
- `/fm-marketplace/categorie/{slug}` - Overzicht van dienstverleners per categorie
- `/fm-marketplace/vorm/{slug}` - Overzicht van dienstverleners per vorm
- `/inspiratie` - Overzicht inspiratieartikelen (spotlights, experts, use-cases, platform-updates)
- `/inspiratie/{slug}` - Individueel inspiratieartikel (volledige tekst server-side beschikbaar)
- `/kaart` - Interactieve kaart met alle dienstverleners
- `/dienstverleners` - Informatie voor dienstverleners
- `/opdrachtgevers` - Informatie voor opdrachtgevers

## API voor AI-assistenten

Facility Finder biedt twee API's waarmee AI-assistenten direct data kunnen opvragen:

### MCP (Model Context Protocol)
- Endpoint: https://www.facilityfinder.nl/api/mcp
- Transport: Streamable HTTP (JSON-RPC 2.0)
- Discovery: https://www.facilityfinder.nl/.well-known/mcp.json

### OpenAI GPT Actions (REST API)
- OpenAPI Spec: https://www.facilityfinder.nl/.well-known/openapi.json
- Base URL: https://www.facilityfinder.nl/api/gpt/{tool_name}
- Geschikt voor: Custom GPTs, Langchain, en andere OpenAI-compatible agents

### Beschikbare tools
- `zoek_dienstverleners` — Zoek op naam, categorie, locatie of vorm
- `bedrijf_details` — Haal volledig bedrijfsprofiel op
- `lijst_categorieen` — Alle dienstcategorieën
- `lijst_vormen` — Alle vormen van dienstverlening
- `vergelijk_dienstverleners` — Vergelijk bedrijven binnen een categorie
- `lijst_specialismes` — Alle specialismes per categorie (bijv. Gevelreiniging, Brandbeveiliging)
- `bedrijven_per_specialisme` — Alle bedrijven die een specifiek specialisme aanbieden

## Gestructureerde JSON (AI-bots, zonder /api/)

Publieke JSON met dezelfde opbouw (vorm, categorie, specialismes) voor **betaalde**, **gratis** (geclaimde) en **unclaimed** profielen:

- Geclaimd bedrijf: `https://www.facilityfinder.nl/data/dienstverlener/bedrijf/{slug}`  
  Voorbeeld: `/data/dienstverlener/bedrijf/facilicom-solutions`
- Unclaimed: `https://www.facilityfinder.nl/data/dienstverlener/unclaimed/{slug-of-id}`  
  Zelfde sleutel als in `/claim/...` (slug als die in de database staat, anders numeriek id).

### Sitemaps

- **Hoofdsitemap (index)**: `https://www.facilityfinder.nl/sitemap.xml`
- **Inspiratie** (hub + alle gepubliceerde artikelen): `https://www.facilityfinder.nl/sitemap-inspiratie.xml`

### Sitemap voor AI-bots (alleen `/data/...`)

Alle `/data/...` URLs staan in een aparte sitemap specifiek voor AI-bots:

- **AI-sitemap**: `https://www.facilityfinder.nl/sitemap-data.xml`

Deze sitemap is **niet** opgenomen in de hoofdsitemap (`/sitemap.xml`) zodat traditionele zoekmachines (Google, Bing) deze URLs niet crawlen. De JSON-responses bevatten ook een `X-Robots-Tag: noindex` header.

## Uitgebreide versie

Voor meer detail, inclusief alle categorieen en bedrijvenaantallen, zie: https://www.facilityfinder.nl/llms-full.txt

## Contact

- Website: https://www.facilityfinder.nl
- E-mail: info@facilityfinder.nl