Documentación técnica

Polarweb para agentes de IA

Esta página es el service-doc del catálogo de API de Polarweb: la versión para humanos de lo que un agente lee en /.well-known/. Todo lo que enlaza aquí abajo responde de verdad — nada de endpoints fantasma.

Leer la web sin renderizarla

/llms.txt y /llms-full.txt resumen Polarweb en texto plano. Cualquier página pública, además, negocia contenido: una petición GET con cabecera Accept: text/markdown devuelve esa misma página en Markdown (frontmatter con título y descripción, cuerpo real) en vez de HTML. Sin esa cabecera, el HTML sigue siendo la respuesta por defecto.

curl -s https://polarweb.io/precios/ -H "Accept: text/markdown"

Actuar en la página (WebMCP)

Esta landing registra herramientas WebMCP (navigator.modelContext.registerTool) para las acciones clave: ir a una sección, ir a precios o ir al registro. Un agente con acceso al navegador puede invocarlas igual que cualquier otra tool; el alta de cuenta en sí siempre pasa por el formulario y el consentimiento de la persona.

Consultar datos sin navegador (MCP de solo lectura)

/.well-known/mcp/server-card.json describe un servidor MCP de solo lectura (Streamable HTTP, sin autenticación) con tres tools: qué es Polarweb, planes y precios, y la galería pública de webs de ejemplo. Las mismas fuentes de datos que usa esta web, nunca un dato inventado aparte.

Skills publicadas

/.well-known/agent-skills/index.json lista los SKILL.md que describen, en lenguaje llano, lo que un agente puede hacer de verdad con Polarweb: entender la plataforma, consultar precios y guiar el alta de una web.

Autenticación

La mayor parte de lo anterior es de lectura pública y no necesita autenticarse. Para actuar en nombre de una cuenta real del panel, ver /auth.md.