# Bonn-Recherche

> Öffentliche, schreibgeschützte Recherche-Infrastruktur zur Bonner Kommunalpolitik.
> Quellen: Ratsinformationssystem der Stadt Bonn (Vorlagen, Sitzungen, Tagesordnungen,
> Beschlüsse, Dokumente) sowie Presse (Stadt Bonn, General-Anzeiger, WDR,
> Radio Bonn/Rhein-Sieg). Alle Treffer verweisen auf die Originalquelle.

## API
- HTML-Recherche (für KI-Webmodi, ohne Tool-Anbindung) — Aliase /research, /search, /suche:
  https://mcp.linkebonn.de/research?q=Nord
  https://mcp.linkebonn.de/research?q=Wohnen
  https://mcp.linkebonn.de/research?q=Open%20Source
  https://mcp.linkebonn.de/research?q=Hitzeschutz
  https://mcp.linkebonn.de/research?q=Radweg
  https://mcp.linkebonn.de/themen (Themenübersicht) · https://mcp.linkebonn.de/quellen (Quellenübersicht)
  https://mcp.linkebonn.de/dokumente?q=Radweg (gespeicherte Dokumenttexte, zitierfähig)
- Capabilities (zuerst aufrufen): https://mcp.linkebonn.de/api/capabilities
- Thematische Suche: https://mcp.linkebonn.de/api/search?q=Radweg+Brüser+Damm&limit=5
- Beschlüsse: https://mcp.linkebonn.de/api/decisions?q=Digitalisierung&date_from=2022-01-01
- Vorlagen: https://mcp.linkebonn.de/api/motions?q=Hitzeschutz
- Sitzungen: https://mcp.linkebonn.de/api/sessions?limit=10
- Dokumente (Original-PDFs): https://mcp.linkebonn.de/api/documents?q=Fahrradstrassen
- Vorgangsverlauf: https://mcp.linkebonn.de/api/procedure/12345
- Presse: https://mcp.linkebonn.de/api/presse?q=Theater+Bad+Godesberg
- OpenAPI: https://mcp.linkebonn.de/openapi.json
- MCP (Streamable HTTP): https://mcp.linkebonn.de/mcp
- Health: https://mcp.linkebonn.de/health

## Recherche-Ablauf
1. /api/capabilities oder /themen lesen (Bestand und Einstiege)
2. /research?q=Begriff (HTML) oder /api/search?q=Begriff (JSON)
3. Details: /dokumente?q=Begriff, /dokument/ID, /sitzung/ID, /api/motions?q=Begriff
4. Weiterblättern: ?limit=10&offset=10 · Filter: quelle=ratsdaten|presse, date_from, date_to

## Wenn eine Adresse nicht abrufbar ist
- Über verlinkte Einstiege gehen: /themen (Themen, Gremien, Sitzungen, Dokumente)
- Pfad-Variante statt Query: /research/Nord entspricht /research?q=Nord
- JSON statt HTML: /api/search?q=Nord
- Anleitung: /anleitung

## Markdown-Zugänge (für KI-Systeme)
- Beliebige Recherche als Markdown: /research.md?q=Begriff (oder /research/Begriff.md)
- Vollständige Link-Sammlung des Bestands: /links.md
- Presse-Zugang: /presse.md
- Alternativ per Header: Accept: text/markdown auf jeder Recherche-URL
- Maschinenlesbare Aktionen: /agents.json

## Notes
- Read-only, kein API-Key, Rate-Limit 60/min.
- Keine generativen Antworten — die API liefert Fakten, Beziehungen und Quellen.
- data_quality: original (Quelle) | derived (abgeleitet) | heuristic (prüfen).
- Kein Zugriff auf nichtöffentliche Tagesordnungspunkte oder interne Daten.

## Capabilities (live)
```json
{
 "service": "Bonn-Recherche",
 "base_url": "https://mcp.linkebonn.de",
 "mcp_endpoint": "https://mcp.linkebonn.de/mcp",
 "openapi": "https://mcp.linkebonn.de/openapi.json",
 "auth": "none (public, read-only)",
 "rate_limit_per_minute": 60,
 "data_sources": [
  {
   "id": "ratsinformationssystem",
   "name": "Ratsinformationssystem der Stadt Bonn",
   "url": "https://www.bonn.sitzung-online.de",
   "content": "Vorlagen/Anträge, Sitzungen, Tagesordnungen, Beschlüsse und Abstimmungen, Dokumente (PDF)"
  },
  {
   "id": "presse",
   "name": "Stadt Bonn, General-Anzeiger, WDR, Radio Bonn/Rhein-Sieg",
   "content": "Pressemitteilungen und Medienberichte, Original-URLs"
  }
 ],
 "coverage": {
  "motions": {
   "count": 24200,
   "recorded_from": "2026-02-27",
   "recorded_to": "2026-10-15",
   "note": "created_at is the recording date, not the political date"
  },
  "sessions": {
   "count": 1383,
   "from": "2019-10-31",
   "to": "2027-10-14"
  },
  "agenda_items": {
   "count": 81068,
   "with_decision_result": 49413,
   "note": "captured from 2026-07 onwards"
  },
  "documents": {
   "count": 8485
  },
  "committees": {
   "count": 223
  },
  "press": {
   "count": null,
   "note": "press index growing; see search_presse"
  },
  "semantic_index_chunks": 88783
 },
 "known_limitations": [
  "Non-public ('N') agenda items are excluded.",
  "No invented facts: missing values are reported as unknown or not_found.",
  "Vote results and speaker attributions come from official documents only.",
  "Press items are indexed as excerpts; full text is available via the original URL.",
  "Political procedure links are formal (ALLRIS ids) where possible; press links are heuristic."
 ],
 "recommended_flow": [
  "1. get_capabilities",
  "2. search_bonn (broad) or search_motions/search_decisions (targeted)",
  "3. get_motion / get_session / get_document for details",
  "4. trace_procedure for the documented history of a motion",
  "5. get_related_items / get_recent_changes for context and updates"
 ],
 "web_access": {
  "html": [
   "https://mcp.linkebonn.de/research?q=Begriff",
   "https://mcp.linkebonn.de/themen",
   "https://mcp.linkebonn.de/quellen",
   "https://mcp.linkebonn.de/dokumente?q=Begriff",
   "https://mcp.linkebonn.de/sitzung/ID",
   "https://mcp.linkebonn.de/dokument/ID"
  ],
  "markdown": [
   "https://mcp.linkebonn.de/research.md?q=Begriff",
   "https://mcp.linkebonn.de/research/Begriff.md",
   "https://mcp.linkebonn.de/links.md",
   "https://mcp.linkebonn.de/presse.md",
   "https://mcp.linkebonn.de/anleitung"
  ],
  "json": [
   "https://mcp.linkebonn.de/api/search?q=Begriff",
   "https://mcp.linkebonn.de/api/decisions?q=Begriff",
   "https://mcp.linkebonn.de/api/dokumente?q=Begriff",
   "https://mcp.linkebonn.de/api/sources"
  ],
  "agents_json": "https://mcp.linkebonn.de/agents.json",
  "llms_txt": "https://mcp.linkebonn.de/llms.txt",
  "note_filters": "quelle=ratsdaten|presse, date_from/date_to (YYYY-MM-DD), limit, offset",
  "note_markdown": "Markdown auch per Header 'Accept: text/markdown' auf jeder Recherche-URL"
 }
}
```