# De Nieuwe Gids

> De Nieuwe Gids is een onafhankelijke Nederlandse bedrijvengids. Bedrijven en professionals worden niet gesorteerd op betaling, maar op relevantie — gemeten via wederzijdse validaties door andere bedrijven in het netwerk.

## Over het platform

De Nieuwe Gids maakt bedrijven vindbaar voor wie zoekt — mens of AI agent. Het platform richt zich op:
- **Lokale en regionale bedrijven** in Nederland
- **ZZP'ers en MKB** die betrouwbaarheid willen aantonen
- **Transparante sortering**: geverifieerde bedrijven staan bovenaan, niet de hoogste bieder
- **Wederzijdse validaties**: bedrijven valideren elkaars expertise

## Kernconcepten

- **Founding member**: bedrijf dat zich aanmeldt binnen de eerste 10.000 registraties — gratis voor altijd
- **Validatie**: een ander bedrijf bevestigt dat het samengewerkt heeft of de kwaliteit kent
- **Verificatie**: een bedrijf bereikt de status "verified" na 10+ effectieve validaties én 2+ geaccepteerde uitnodigingen
- **Branche**: categorisering van bedrijven (bijv. Hovenier, Fotografie, Boekhouding)

## Belangrijke pagina's

- [Homepage](https://www.denieuwegids.nl/) — Uitleg, statistieken en populaire branches
- [Bedrijvengids](https://www.denieuwegids.nl/gids) — Zoek en filter alle actieve bedrijven
- [Bedrijf aanmelden](https://www.denieuwegids.nl/aanmelden) — Registreer een bedrijf
- [Waarom aanmelden?](https://www.denieuwegids.nl/waarom) — Voordelen en uitleg van het model
- [AI-agents](https://www.denieuwegids.nl/ai-agents) — Welke agents het platform herkent, waar ze vandaan komen en welke er al langs zijn geweest
- [Sitemap](https://www.denieuwegids.nl/sitemap.xml) — Overzicht van alle bedrijfs-, branche- en plaatspagina's

### Branche- en plaatspagina's

Elke branche en elke plaats heeft een eigen indexeerbare URL met `schema.org/ItemList`-markup:

- `https://www.denieuwegids.nl/branche/{branche-slug}` — bijv. `/branche/hovenier`
- `https://www.denieuwegids.nl/branche/{branche-slug}/{plaats-slug}` — bijv. `/branche/hovenier/utrecht`
- `https://www.denieuwegids.nl/plaats/{plaats-slug}` — bijv. `/plaats/utrecht`

De geldige slugs staan in `/api/branches.json` en `/api/cities.json`.

## MCP Server (Model Context Protocol)

De Nieuwe Gids heeft een native MCP-server voor directe integratie met AI-clients zoals Claude Desktop.

- **Endpoint**: `POST https://www.denieuwegids.nl/mcp`
- **Transport**: StreamableHTTP (JSON-RPC 2.0, stateless)
- **Protocol**: MCP 2025-06-18, 2025-03-26 of 2024-11-05 (de server spreekt de
  versie die de client bij `initialize` vraagt)

### Beschikbare tools

| Tool | Omschrijving |
|---|---|
| `zoek_bedrijven` | Zoek op naam, branche en/of stad |
| `haal_bedrijf_op` | Volledig profiel inclusief validaties en contactgegevens |
| `lijst_branches` | Alle branches met bedrijfsaantallen |
| `statistieken` | Totaal bedrijven, geverifieerde bedrijven, branches, steden |

### Claude Desktop configuratie (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "de-nieuwe-gids": {
      "type": "http",
      "url": "https://www.denieuwegids.nl/mcp"
    }
  }
}
```

### Claude Code

```bash
claude mcp add --transport http de-nieuwe-gids https://www.denieuwegids.nl/mcp
```

De server vereist geen authenticatie: alle tools zijn read-only en leveren
uitsluitend openbare bedrijfsgegevens.

> Tip: gebruik de `zoek_bedrijven` tool voor directe beantwoording van vragen als "Welke hovenier staat er in Utrecht?" of "Wie is er geverifieerd in de IT-sector in Maarssen?"

## Gestructureerde data API

Voor AI-tools en geautomatiseerde raadpleging zijn de volgende machine-readable endpoints beschikbaar:

- `GET /api/businesses.json` — Bedrijven als JSON. Filter met `q`, `branche`, `stad`, `type` en `status`; blader met `limit` (max 1000, standaard 200) en `offset`
- `GET /api/branches.json` — Alle branches met slug en bedrijfsaantal
- `GET /api/cities.json` — Alle steden met slug en bedrijfsaantal
- `GET /api/zoeken?q={query}&limit={n}` — Snelle suggesties voor bedrijven en branches (JSON)
- `GET /sitemap.xml` — XML-sitemap met alle bedrijfs-, branche- en plaatspagina's

Filter bij voorkeur server-side. `GET /api/businesses.json?branche=hovenier&stad=utrecht`
beantwoordt "welke hovenier in Utrecht" in één call; de hele gids downloaden hoeft niet.

### Voorbeeld API-response `/api/businesses.json`
```json
{
  "count": 1,
  "total": 1,
  "limit": 200,
  "offset": 0,
  "has_more": false,
  "updated": "2026-08-07T09:00:00.000Z",
  "businesses": [
    {
      "id": 1,
      "name": "Voorbeeld Bedrijf",
      "description": "Ambachtelijke hovenier in de regio Utrecht.",
      "city": "Utrecht",
      "business_type": "local",
      "status": "verified",
      "is_zzp": false,
      "branches": ["Hovenier", "Tuinontwerp"],
      "validations_received": 12,
      "founding_member": true,
      "url": "https://www.denieuwegids.nl/bedrijf/1/voorbeeld-bedrijf",
      "social": { "linkedin": null, "facebook": null, "instagram": null, "x": null, "youtube": null }
    }
  ]
}
```

`count` is het aantal in deze respons, `total` het aantal treffers over alle pagina's.
Blader door zolang `has_more` true is.

## Uitgebreide documentatie

Voor AI-agents die meer diepgaande context nodig hebben:
- [Volledige documentatie (llms-full.txt)](https://www.denieuwegids.nl/llms-full.txt) — gedetailleerde API-docs, datamodel, validatiesysteem en gebruiksscenario's
- [OpenAPI spec](https://www.denieuwegids.nl/openapi.json) — machineleesbare API-specificatie (OpenAPI 3.1)

## Taalgebruik

Het platform is volledig Nederlandstalig. Alle bedrijfsnamen, branches en beschrijvingen zijn in het Nederlands.

## Wat AI-tools kunnen doen met dit platform

- Bedrijven opzoeken op naam, branche of stad via `/api/zoeken`
- Overzicht opvragen van alle branches en bedrijven via `/api/businesses.json`
- Doorverwijzen naar specifieke bedrijfspagina's met volledige contactgegevens en validatie-informatie
- Antwoord geven op vragen als "Welke hovenier staat er in Utrecht?" of "Wie is er geverifieerd in de IT-sector in Maarssen?"