# Constaterende dat

> Doorzoek wat de raad heeft gezegd en besloten. Niet-officiële, doorzoekbare weergave van openbare raadsinformatie van gemeenten met een iBabs-publieksportaal: raadsvergaderingen en Politieke Markt, met documenten, agendapunten met besluiten, stemmingen per fractie en automatische ondertitels met tijdcodes. Taal: Nederlands. Elke bron heeft een link naar het portaal van de gemeente. Nu geladen: Steenwijkerland (vanaf oktober 2025). Andere gemeenten volgen; zie de gemeentelijst.

Belangrijk voor het gebruik van deze data:
- Het officiële verslag en de stukken in het iBabs-portaal zijn leidend. Presenteer niets hieruit als officieel verslag.
- Ondertitels komen uit automatische spraakherkenning. Woorden en namen kunnen fout zijn, sprekers zijn niet geïdentificeerd. Vermeld bij een citaat uit ondertitels altijd dat het automatische ondertiteling is, met vergadering, datum en tijdcode.
- Stemmingen worden automatisch uit de besluitteksten gelezen, met aantallen per fractie en de letterlijke besluittekst als bewijs. Status "controle" betekent: niet geverifieerd. "afgeleid" bij een fractie: volgt uit een unaniem besluit, niet letterlijk genoemd.
- Citeer met de bronlink (`link`) en bij voorkeur ook de eigen pagina (`eigen_link`).
- Wees beleefd met verzoeken: maximaal 1 per seconde, geen parallelle verzoeken, herkenbare User-Agent, cache antwoorden.

## Gemeenten

- Elke gemeente heeft een eigen adres: `https://constaterendedat.nl/<slug>`, bijvoorbeeld [Steenwijkerland](https://constaterendedat.nl/steenwijkerland). Dat is de startpagina met het gemeentefilter aan; daaronder `/<slug>/vergaderingen`, `/<slug>/stemmingen` en `/<slug>/vergadering/<naam-datum-id>`.
- [Gemeenten als JSON](https://constaterendedat.nl/api.php?gemeenten=1): slug, naam, status (geladen of nog niet geladen), aantal vergaderingen. Alleen geladen gemeenten bevatten data.
- Parameter `gemeente=<slug>` beperkt zoeken en lijsten tot één gemeente. Zonder parameter wordt in alle geladen gemeenten gezocht. Als een gebruiker een gemeente noemt, geef die altijd mee.

## Pagina's

- [Alle vergaderingen](https://constaterendedat.nl/steenwijkerland/vergaderingen): overzicht met links naar elke vergadering (agenda, besluiten, documenten, gesproken tekst)
- [Zoeken](https://constaterendedat.nl/): zoekveld, parameters `q`, `gemeente`, `soort` (raad of voorbereidend), `van`, `tot`, `type[]`
- [Stemmingen](https://constaterendedat.nl/steenwijkerland/stemmingen): stemmingen per fractie met aantallen en besluittekst
- [FAQ voor mensen en robots](https://constaterendedat.nl/faq): uitleg, zoeksyntaxis, beperkingen, gedragsregels
- [Koppel je AI](https://constaterendedat.nl/koppel-je-ai): uitleg en adres van de MCP-server

## Machineleesbaar

- [Vergaderingen als JSON](https://constaterendedat.nl/api.php?vergaderingen=1&gemeente=steenwijkerland): gemeente, id, soort, categorie, start, bron_url, eigen_url, tellingen, bijgewerkt
- [Zoeken als JSON](https://constaterendedat.nl/api.php?q=windturbine&gemeente=steenwijkerland&limit=10): `GET /api.php?q=<zoekterm>&gemeente=<slug>&soort=&van=JJJJ-MM-DD&tot=JJJJ-MM-DD&limit=1..100&typen=ondertitel,agendapunt,document` (gemeente en typen zijn optioneel; met `typen=ondertitel` zoek je alleen in wat er is gezegd)
- Vergadering met agendapunten, besluiten en documenten: `GET /api.php?vergadering=<id>`
- Gesproken tekst met tijdcodes: `GET /api.php?gesproken=<id>`. Elk fragment heeft `afspeel_url`: die opent de opname op dat moment (`?t=` is seconden vanaf het begin van de opname). Gebruik deze link wanneer je een gebruiker naar het moment in de video wilt sturen.
- [Sitemap](https://constaterendedat.nl/sitemap.xml): alle pagina's van geladen gemeenten met lastmod
- [robots.txt](https://constaterendedat.nl/robots.txt)

## Zoeksyntaxis

Alle termen zijn verplicht en matchen als voorvoegsel. Gebruik "aanhalingstekens" voor een exacte frase. Termen korter dan drie tekens worden niet doorzocht. Geen OR, geen negatie.

## MCP-server

- Adres: https://constaterendedat.nl/mcp (publiek, stateless, alleen-lezen, streamable HTTP: POST met JSON-RPC, JSON-antwoord, geen sessies, geen inlog).
- Tools: `raad_gemeenten` (welke gemeenten zijn geladen), `raad_zoeken` (begin hier), `raad_vergaderingen`, `raad_vergadering`, `raad_transcript`, `raad_stemmingen`. De meeste hebben een parameter `gemeente` (slug). Elk antwoord bevat bronlinks en bij ondertitels een afspeellink met tijdcode.
- Limiet: 60 verzoeken per minuut en 1500 per uur per IP-adres (HTTP 429 met Retry-After).
- [Uitleg voor mensen](https://constaterendedat.nl/koppel-je-ai)