@opendata.cat/mcp-server 0.0.11 → 0.0.13

package/README.md

@@ -154,6 +154,12 @@ Prompts predefinits que guien l'LLM pas a pas per fer analisis completes:
 | `compara_municipis` | Compara dos municipis en totes les dades disponibles | `municipi_a`, `municipi_b` |
 | `descobreix_dades` | Mapa complet de dades obertes sobre un tema | `tema` |
 | `analisi_bombers` | Actuacions dels Bombers: emergencies, distribucio, tendencies | `comarca` (opcional) |
+| `novetats` | Datasets actualitzats mes recentment | `portal` (opcional) |
+| `datasets_populars` | Datasets mes consultats pels usuaris | — |
+| `explorar_portal` | Guia completa d'un portal: categories, exemples, destacats | `portal` |
+| `dades_municipi` | Fitxa completa d'un municipi amb totes les dades disponibles | `municipi` |
+| `datasets_temps_real` | Datasets amb dades en temps real o actualitzacio frequent | — |
+| `resum_portals` | Visio panoramica de tots els portals de dades obertes | — |
 
 ## Exemples d'us
 
@@ -167,6 +173,12 @@ Un cop configurat, pots fer preguntes al teu LLM com:
 - *"Quines dades obertes hi ha sobre educacio a Catalunya?"* → prompt `descobreix_dades`
 - *"Dona'm les ultimes dades de pressupostos de Reus"* → prompt `pressupostos_municipals`
 - *"Analitza les actuacions dels Bombers al Valles"* → prompt `analisi_bombers`
+- *"Quines novetats hi ha en dades obertes?"* → prompt `novetats`
+- *"Quins son els datasets mes consultats?"* → prompt `datasets_populars`
+- *"Explora'm el portal de la Generalitat"* → prompt `explorar_portal`
+- *"Quines dades obertes te Sabadell?"* → prompt `dades_municipi`
+- *"Quines dades en temps real hi ha?"* → prompt `datasets_temps_real`
+- *"Dona'm un resum de tots els portals"* → prompt `resum_portals`
 
 ## Com funciona
 
@@ -181,6 +193,24 @@ Usuari → LLM → MCP opendata.cat → API opendata.cat (cataleg)
 
 No emmagatzema ni fa de proxy de dades. Cada consulta va directament a la font oficial.
 
+## API REST
+
+A mes del servidor MCP, opendata.cat ofereix una API REST publica per accedir al cataleg de datasets:
+
+| Endpoint | Descripcio |
+|----------|-----------|
+| `GET /api/datasets.php?q=...` | Cerca datasets per text lliure |
+| `GET /api/dataset.php?id=...` | Detall complet d'un dataset |
+| `GET /api/categories.php` | Categories i portals amb comptadors |
+| `GET /api/portals.php` | Portals de transparencia (1.769) |
+| `GET /api/stats.php` | Estadistiques agregades |
+| `GET /api/mcp-stats.php` | Metriques d'us del MCP |
+| `POST /api/mcp` | Servidor MCP (Streamable HTTP) |
+
+Documentacio interactiva (Swagger): **[opendata.cat/api/docs.html](https://opendata.cat/api/docs.html)**
+
+Especificacio OpenAPI: [`opendata.cat/api/openapi.json`](https://opendata.cat/api/openapi.json)
+
 ## Sobre opendata.cat
 
 [opendata.cat](https://opendata.cat) es una associacio catalana sense anim de lucre fundada el 2012 (registre 47468) dedicada a promoure la transparencia i l'acces a la informacio publica. Treballa en tres eixos: **estandarditzacio** de formats i protocols, **formacio** especialitzada per a professionals i administracions, i **collaboracio** publico-privada per a l'obertura de dades.
@@ -194,8 +224,9 @@ Les contribucions son benvingudes! Per afegir un nou portal de dades obertes:
 
 ## Changelog
 
-### v0.0.11 (2026-04-13)
-- 8 prompts predefinits: embassaments, trens FGC temps real, qualitat aire, accidents, pressupostos, compara municipis, descobreix dades, bombers
+### v0.0.12 (2026-04-13)
+- 14 prompts predefinits (8 analisi + 6 descobriment)
+- Nous prompts: novetats, datasets_populars, explorar_portal, dades_municipi, datasets_temps_real, resum_portals
 - Crawler incremental: UPSERT en lloc de TRUNCATE, no perd dades si un portal falla
 - Backup automatic despres de cada carrega
 

package/dist/index.js

@@ -12,7 +12,7 @@ import { queryCido } from "./clients/cido.js";
 import { queryOpendatasoft } from "./clients/opendatasoft.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.11",
+    version: "0.0.12",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -92,6 +92,26 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
         }
         else if (dataset.api_type === "opendatasoft") {
             const data = await queryOpendatasoft(dataset.api_endpoint, filters, search, limit, offset);
+            // Detect GTFS-RT protobuf files
+            const first = data.records[0];
+            const fileField = first?.file;
+            if (fileField?.filename?.endsWith(".pb") || fileField?.filename?.endsWith(".pbf")) {
+                const dsMatch = dataset.api_endpoint.match(/dataset=([^&]+)/);
+                const baseMatch = dataset.api_endpoint.match(/(https?:\/\/[^/]+)/);
+                const infoUrl = baseMatch ? `${baseMatch[1]}/explore/dataset/${dsMatch?.[1] ?? ""}/information/` : dataset.api_endpoint;
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                dataset: dataset.name,
+                                format: "Protocol Buffers (GTFS-RT)",
+                                message: "Aquest dataset conté dades en format Protocol Buffers (.pb), un format binari per a transport públic en temps real (GTFS Realtime). No es pot llegir directament com a text/JSON. Per usar-lo cal un decoder GTFS-RT (ex: gtfs-realtime-bindings).",
+                                filename: fileField.filename,
+                                download_url: infoUrl,
+                            }, null, 2),
+                        }],
+                };
+            }
             results = data.records;
         }
         else {
@@ -315,6 +335,124 @@ server.prompt("analisi_bombers", "Analitza les actuacions dels Bombers de la Gen
             }],
     };
 });
+// ===== PROMPTS DE DESCOBRIMENT =====
+server.prompt("novetats", "Mostra els datasets actualitzats més recentment als portals de dades obertes de Catalunya.", { portal: z.string().optional().describe("Filtrar per portal: generalitat, barcelona, diba, aoc, reus, girona, fgc") }, ({ portal }) => {
+    const filtreText = portal ? ` al portal ${portal}` : "";
+    return {
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Mostra els datasets de dades obertes de Catalunya actualitzats més recentment${filtreText}.\n\n`
+                        + "1. Usa list_portals per veure els portals disponibles\n"
+                        + `2. Usa search_datasets amb termes generals${portal ? ` i portal '${portal}'` : ""} per obtenir datasets\n`
+                        + "3. Per als primers 10 resultats, usa get_dataset_info per veure la data d'última actualització (last_updated)\n"
+                        + "4. Ordena per data d'actualització (més recent primer)\n"
+                        + "5. Presenta una taula amb: nom, portal, categoria, última actualització, formats\n"
+                        + "6. Destaca els que s'han actualitzat en els últims 7 dies\n\n"
+                        + "L'objectiu és descobrir quines dades es mantenen actives i actualitzades.",
+                },
+            }],
+    };
+});
+server.prompt("datasets_populars", "Mostra els datasets més consultats pels usuaris del MCP.", () => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: "Mostra els datasets de dades obertes de Catalunya més consultats pels usuaris.\n\n"
+                    + "1. Usa search_datasets amb termes populars: 'embassament', 'qualitat aire', 'transport', 'pressupost', 'població'\n"
+                    + "2. Per cada cerca, agafa el primer resultat i usa get_dataset_info per obtenir detalls\n"
+                    + "3. Presenta un rànquing dels datasets més rellevants amb:\n"
+                    + "   - Nom i portal\n"
+                    + "   - Descripció breu\n"
+                    + "   - Camps disponibles\n"
+                    + "   - Última actualització\n"
+                    + "4. Per al top 3, fes una consulta amb query_dataset (limit: 3) per mostrar una mostra de dades reals\n"
+                    + "5. Suggereix preguntes interessants que es podrien fer a cada dataset\n\n"
+                    + "L'objectiu és inspirar l'usuari amb les possibilitats de les dades obertes.",
+            },
+        }],
+}));
+server.prompt("explorar_portal", "Explora un portal de dades obertes: quants datasets té, categories, exemples de cada tipus.", { portal: z.string().describe("Portal a explorar: generalitat, barcelona, diba, aoc, reus, girona, fgc") }, ({ portal }) => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: `Fes una exploració completa del portal de dades obertes '${portal}'.\n\n`
+                    + "1. Usa list_portals per obtenir el nombre total de datasets\n"
+                    + "2. Usa list_categories per veure les categories disponibles al portal\n"
+                    + `3. Usa search_datasets amb portal '${portal}' i limit 50 per veure tots els datasets\n`
+                    + "4. Agrupa-los per categoria i presenta una taula resum\n"
+                    + "5. Per a cada categoria, tria el dataset més interessant i usa get_dataset_info per mostrar-ne els camps\n"
+                    + "6. Destaca:\n"
+                    + "   - Datasets amb dades en temps real o actualització freqüent\n"
+                    + "   - Datasets amb molts camps (rics en dades)\n"
+                    + "   - Datasets únics que no es troben a altres portals\n\n"
+                    + "Presenta el portal com una guia completa per a un nou usuari.",
+            },
+        }],
+}));
+server.prompt("dades_municipi", "Descobreix totes les dades obertes disponibles sobre un municipi concret de Catalunya.", { municipi: z.string().describe("Nom del municipi (ex: 'Sabadell', 'Girona', 'Manresa')") }, ({ municipi }) => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: `Descobreix totes les dades obertes disponibles sobre el municipi de ${municipi}.\n\n`
+                    + `1. Usa search_datasets amb '${municipi}' (limit: 50) per trobar tots els datasets\n`
+                    + "2. Agrupa per portal i categoria\n"
+                    + "3. Per als datasets més rellevants, usa get_dataset_info per veure detalls\n"
+                    + "4. Fes query_dataset (limit: 3) als 2-3 datasets més interessants per mostrar dades reals\n"
+                    + "5. Usa related_datasets per trobar dades complementàries d'altres portals\n"
+                    + "6. Presenta un resum en format fitxa municipal:\n"
+                    + "   - Població (si hi ha dades)\n"
+                    + "   - Pressupost (si hi ha dades)\n"
+                    + "   - Equipaments, transport, medi ambient...\n"
+                    + `   - Què falta: quins temes no tenen dades obertes\n\n`
+                    + `L'objectiu és donar un retrat complet de ${municipi} a través de les dades obertes.`,
+            },
+        }],
+}));
+server.prompt("datasets_temps_real", "Llista els datasets que ofereixen dades en temps real o actualització freqüent.", () => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: "Descobreix quins datasets de dades obertes de Catalunya ofereixen dades en temps real o actualització molt freqüent.\n\n"
+                    + "1. Usa search_datasets amb termes com 'temps real', 'GTFS', 'realtime' per trobar datasets en viu\n"
+                    + "2. Usa search_datasets amb portal 'fgc' per trobar dades de transport en temps real\n"
+                    + "3. Usa search_datasets amb 'qualitat aire estacions' per trobar mesures en directe\n"
+                    + "4. Usa search_datasets amb 'embassament' i 'cabal' per trobar dades hídriques en viu\n"
+                    + "5. Per cada dataset trobat, usa get_dataset_info per verificar la freqüència d'actualització\n"
+                    + "6. Presenta una llista organitzada per tema:\n"
+                    + "   - Transport: trens FGC, trànsit, bicing...\n"
+                    + "   - Medi ambient: aire, aigua, meteorologia...\n"
+                    + "   - Altres en temps real\n"
+                    + "7. Per als 3 més interessants, fes query_dataset per mostrar les últimes dades\n\n"
+                    + "L'objectiu és que l'usuari sàpiga quines dades pot consultar 'ara mateix'.",
+            },
+        }],
+}));
+server.prompt("resum_portals", "Resum general de tots els portals: quants datasets, quins temes, quins formats.", () => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: "Fes un resum complet de tots els portals de dades obertes de Catalunya.\n\n"
+                    + "1. Usa list_portals per obtenir la llista amb comptadors\n"
+                    + "2. Usa list_categories per veure les categories de cada portal\n"
+                    + "3. Presenta una taula comparativa:\n"
+                    + "   - Nom del portal, URL, nombre de datasets\n"
+                    + "   - Tipus d'API (Socrata, CKAN, REST, Opendatasoft)\n"
+                    + "   - Categories principals\n"
+                    + "   - Tipus de dades destacades\n"
+                    + "4. Per cada portal, destaca el dataset més singular o interessant\n"
+                    + "5. Indica quins portals tenen dades en temps real\n"
+                    + "6. Suggereix per a cada portal una pregunta interessant que es podria respondre amb les seves dades\n\n"
+                    + "L'objectiu és donar una visió panoràmica de l'ecosistema de dades obertes català.",
+            },
+        }],
+}));
 async function main() {
     const mode = process.argv.includes("--http") ? "http" : "stdio";
     const port = parseInt(process.env.MCP_PORT || "3100", 10);
@@ -333,7 +471,7 @@ async function main() {
             // Health check
             if (req.url === "/health") {
                 res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.11" }));
+                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.12" }));
                 return;
             }
             // MCP endpoint

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",