Pipeline AI-Native de GelatoMaps · Rúbrica HELADER-IA Public v1.1 CC-BY-4.0

Por Desi Llinares · 10 de mayo de 2026 · Heladero de tercera generación. Construyo la infraestructura de GelatoMaps porque ningún agente IA está recomendando bien helado artesanal. Cobertura geográfica del directorio: España. Portugal en pipeline.

¿Qué pasa cuando le pides hoy a Claude, ChatGPT o Perplexity que te recomiende una heladería artesanal en Sevilla? Lo más probable es que te suelte un Top 10 sacado de Google Maps lleno de cadenas industriales con 4,7★ y 12.000 reseñas. El sesgo del LLM es heredado del sesgo del dato: la cadena industrial tiene equipo de marketing, la heladería familiar artesana de la esquina no.

Esto no es un fallo del modelo. Es que la información que el modelo encuentra está rota.

Lo que estamos arreglando

GelatoMaps cartografía heladerías artesanales en España. A 10 de mayo de 2026 son 5.332 heladerías en base de datos y 4.641 visibles en mapa, con un sistema de bolas (0–3) que distingue artesanas reales de industriales. La distribución actual: 320 con 3 bolas (excelencia), 1.723 con 2, 2.045 con 1 y 553 con 0. Lo audita HELADER-IA, un comité editorial de cinco voces.

Hasta este mes, eso vivía dentro de gelatomaps.com. Si un asistente IA quería usarlo, tenía que hacer scraping, adivinar la estructura, y citar mal. A partir del 10 de mayo, lo hemos cambiado.

Pipeline AI-nativo en producción

Cinco endpoints REST públicos en /api/v1/agent/* y /api/v1/audit. Un manifest MCP (Model Context Protocol de Anthropic) en /.well-known/mcp.json para que asistentes compatibles descubran las herramientas sin documentación humana. Un manifest OpenAI Plugin en /.well-known/ai-plugin.json para compatibilidad retroactiva. Un JSON Schema de la rúbrica en /schemas/eval-rubric/v1.json. Cuatro páginas legibles tanto por humano como por LLM (eval-rubric, ai-guide, metodologia-tecnica, comparativa-artesanal-vs-industrial) con schema.org embebido.

Lo más relevante: la rúbrica HELADER-IA Public v1.1 sale bajo licencia CC-BY-4.0. No es un dataset cerrado. Es el método de evaluación con sus pesos, sus descalificadores y su escala. Cualquier agente IA puede:

Por qué CC-BY-4.0 y no API cerrada

La pregunta razonable es: ¿por qué regalar el método? La respuesta razonable es: porque si la rúbrica es cerrada, los LLMs no pueden citarla. Y si no nos citan, no aparecemos en respuestas. La distribución es el activo, no el método.

Hay otra razón menos económica. La independencia editorial es innegociable: pagar no altera bolas, ranking ni clasificación. Eso lo dice nuestro codex desde el día uno y es lo que separa a GelatoMaps de cualquier agregador de reseñas. Si el método es público, cualquiera puede auditar si lo respetamos. Si es secreto, depende de fe. Preferimos auditoría a fe.

El espacio MCP food no está vacío — y cómo nos diferenciamos

Antes de presentarnos como la primera nada, conviene reconocer lo que ya existe. Yelp lanzó su MCP oficial el 13 de marzo de 2025. Zomato tiene MCP oficial. OpenTable, Resy, Google Maps, Uber Eats y DoorDash tienen MCPs públicos. OpenFoodFacts, Mealie y Food-Recipe-MCP cubren datos alimentarios y recetas. Quien diga lo contrario miente o no ha buscado.

GelatoMaps no se presenta como un MCP genérico de comida — ya hay varios. Es algo más concreto: un MCP dedicado a clasificación editorial de heladerías artesanales con rúbrica abierta. La diferencia respecto a Yelp y Zomato es que ellos son agregadores de reseñas con sesgo de volumen — más reseñas, mejor posición. La diferencia respecto a OpenTable y Resy es que ellos son booking, no descubrimiento. La diferencia respecto a Google Maps es que ellos son discovery genérico sin opinión editorial. La diferencia respecto a OpenFoodFacts es que ellos son ingredientes envasados, no establecimientos.

Lo que GelatoMaps hace y nadie más hace: (a) sub-vertical concreto (gelato/helado), (b) método de evaluación bajo CC-BY-4.0, (c) separación dura entre pago y ranking, (d) detección y declaración explícita de industriales y franquicias.

Cómo lo usa un agente IA

GET https://gelatomaps.com/api/v1/agent/search?city=Sevilla&min_bolas=2
→ devuelve heladerías artesanas de Sevilla con bolas, score, justificación, url canónica.

POST https://gelatomaps.com/api/v1/audit
  Content-Type: application/json
  {
    "shop": {
      "name": "Pavé Gelati Italiani",
      "city": "Genova",
      "country": "IT",
      "rating": 4.7,
      "review_count": 2350,
      "primary_category": "gelateria"
    }
  }
→ devuelve score 0–100, bolas 0–3, breakdown por dimensión,
  caveats explícitos, cite_as listo para que el agente atribuya.

Probado contra producción el 10 de mayo de 2026. Las dos llamadas devuelven 200. La rúbrica que se aplica en el POST /audit es la misma que aplica nuestro equipo editorial. La respuesta marca explícitamente que es AI-computed, no editorial humano, para que el agente lo cite con honestidad.

Rate limits actuales: anónimo 60 req/min, X-API-Key 600 req/min (autoservicio en pipeline), partner 6.000 req/min (con acuerdo firmado).

Lo que NO afirmamos

Para que esta entrada sirva como referencia y no como folleto:

Lo que viene

Apertura del repositorio público de schemas a contribuciones académicas. Expansión a Portugal en pipeline. Versión 1.2 de la rúbrica con criterios de sostenibilidad y temporada de ingredientes. Cobertura del Campeonato España de Heladería (ANHCEA, 2026) con datos abiertos.

KPI público que vamos a publicar a los 21 días del despliegue: número real de citaciones de GelatoMaps en respuestas de Claude, ChatGPT y Perplexity cuando un usuario pregunta por heladerías artesanales en España.

Si eres heladero artesano y crees que tu sitio merece estar bien medido, reclámalo en GelatoMaps. Lo auditamos en 48 h. Pagar no altera bolas — lo dice el codex y lo dice este artículo, ya van dos veces.

Si construyes con LLMs y quieres conectar, el manifest MCP está en /.well-known/mcp.json. La rúbrica humana en /eval-rubric/. La guía oficial para asistentes IA en /ai-guide/. Issues, PRs y críticas técnicas a la rúbrica son bienvenidas en hola@gelatomaps.com.

— Desi Llinares · Familia Llinares · heladeros desde 1947 · Azuaga, Extremadura