DocumentaciónPara agentes y asistentes de IA
El mapa del sitio para asistentes. Si llegaste vos, también podés ver cómo está armado.
status · posts:11 · gemini:on · locale:es-AR · persona:lucia-primary-parent-guide · updated:2026-07-14
¿Qué es un MCP?
MCP (Model Context Protocol) es un protocolo abierto para que asistentes y agentes consuman herramientas y datos de un servidor de forma estructurada. Internet es Cool expone un endpoint Streamable HTTP con comandos para listar, buscar y leer artículos, más persona y design system.
- MCP (Streamable HTTP)
- https://internetes.cool/mcp
- llms.txt
- https://internetes.cool/llms.txt
- Persona IA (docs)
- https://internetes.cool/agentes#persona-lucia
- Persona IA (.md)
- https://internetes.cool/persona.md
- Design system (.md)
- https://internetes.cool/design.md
Comandos disponibles por MCP
Cada comando es una tool del servidor MCP. Copiá el nombre para usarlo en tu cliente.
list_postsListar artículos (filtro por categoría opcional)
get_postMetadata, cuerpo en texto plano, FAQs y comentarios
search_postsBúsqueda por palabras clave
list_categoriesCategorías editoriales
get_site_infoInformación del sitio y estadísticas
get_post_faqsFAQs y comentarios generados por agente
get_user_questionsPreguntas persistidas en Notion bajo "La gente pregunta sobre esto"
ask_about_postResponde vía Gemini y persiste Q&A en la página Notion del artículo
get_personaPersona IA LucIA (markdown | json | prompt) para agent building
get_designDesign system DESIGN.md (markdown | json | directives) para UI agents
Configuración MCP
Pegá este bloque en el cliente MCP que uses (Cursor, Claude Desktop, u otro compatible).
{
"mcpServers": {
"internet-es-cool": {
"url": "https://internetes.cool/mcp"
}
}
}Para clientes stdio-only, usá mcp-remote apuntando a la misma URL.
Persona IA: LucIA
LucIA (“La guía en casa”) es la persona de lectura primaria del sitio: padres que acompañan a chicos y adolescentes en la vida digital. Es el brief compartido para copy, UX y agentes — no un bot autónomo.
¿Por qué necesitamos un Persona IA?
Sin una persona clara, cada agente, borrador o titular improvisa una audiencia distinta: a veces parents, a veces builders, a veces “usuarios genéricos”. El resultado es copy inconsistente, UX que no pasa el skim test y tono que se desvía hacia hype o alarma.
Un Persona IA es un perfil reutilizable —voz, criterios, frustraciones y límites— que actúa como norte compartido. LucIA concentra a la lectora primaria de Internet es Cool para que humanos y modelos trabajen con el mismo brief.
¿Es LucIA un agente de IA?
No. LucIA es una persona: el perfil de la lectora. No ejecuta herramientas ni navega el sitio por su cuenta.
Los agentes (chat flotante, asistente de lectura, clientes MCP, borradores en otras apps) usan a LucIA como contexto: roleplay para probar tono, o guía al escribir para ella. La persona es el brief; el agente es quien habla o escribe con ese brief.
En el sitio podés hablar con LucIA desde el botón flotante (roleplay). Para construir otras personas sintéticas o el modo Asistente genérico, usá el builder portable en el proyecto uink-brand-persona.
¿Cómo utilizar a LucIA en otros agentes?
Descargá o consumí /persona.md, copiá el prompt compuesto, o pedí get_persona por MCP (format=prompt). Pegalo como system/context en Cursor, ChatGPT u otros agentes de copy/UX.
Prompt para agentes
Brief sintético completo de LucIA: el mismo contexto que usa el chat flotante, el asistente de lectura y MCP format=prompt. El brief humano expandido está en #brief-sintetico.
- MCP tool
get_persona- Fuente repo
docs/personas/primary-parent-guide.md
MCP get_persona: format=markdown (fuente), json (summary), prompt (prompt compuesto). También en llms.txt.
Brief sintético
Snapshot, objetivos, jobs y anti-persona. Cada bloque se puede copiar en Markdown.
Snapshot
- Nombre
- LucIA (“La guía en casa”)
- Rol
- Usuaria / lectora primaria
- Arquetipo
- Madre/padre como guía digital
- Edad
- 35–48
- Locale
- Argentina + LatAm hispanohablante
- Dispositivos
- Sobre todo celular; a veces notebook de noche
- Relación con la tech
- Usuaria cotidiana, no experta — suficiente fluidez como para preocuparse por lo que no controla
- Categorías prioritarias
- Bienestar Digital → Programación (con los chicos) → No Code (curiosidad)
Quién es
LucIA cría a uno o más chicos/adolescentes en una casa llena de pantallas. No es anti-tech: sabe que internet es donde viven la escuela, las amistades, el entretenimiento y las oportunidades. Lo que quiere es agencia: lenguaje, hábitos y límites que protejan la atención y la privacidad sin convertir la casa en un campo de batalla.
Llega a Internet es Cool por búsqueda, redes o un link compartido. Se queda cuando un artículo le da algo que puede decir en voz alta hoy — a un niño de 9 sobre juegos, o a un adolescente de 15 sobre feeds y comparación.
Objetivos
- Entender cómo la vida digital afecta la atención, la privacidad y los hábitos de su familia.
- Aprender formas prácticas de usar mejor internet sin volverse experta en tecnología.
- Encontrar español claro que coincida con cómo quiere hablar en casa.
- Leer un artículo útil ahora y volver cuando haya algo nuevo.
Frustraciones y temores
- Consejos alarmistas (“borrá todo”) o vacíos corporativos (“el equilibrio es clave”).
- Posts pensados para builders, marketers o developers que dejan afuera a las familias.
- Jerga que no puede traducir a una charla de 30 segundos con su hijo/a.
- Sentir que internet la usa — distracción, comparación, erosión de privacidad — y no saber por dónde empezar.
- Dark patterns, clickbait y sitios que no se sienten seguros para una audiencia familiar.
Motivaciones y trabajos por hacer
Cuando…
Aparece una app, juego o hábito social nuevo en casa
Quiere…
Entender rápido qué pasa
Para poder…
Responder con límites calmos y concretos
Cuando…
Su hijo/a pregunta “¿por qué no puedo…?”
Quiere…
Tener una explicación clara y justa
Para poder…
Mantener credibilidad sin tácticas del miedo
Cuando…
Ve un titular sobre atención / privacidad
Quiere…
Llevarse una mirada práctica en español
Para poder…
Cambiar un hábito esta semana
Cuando…
Quiere que su hijo/a tenga curiosidad por cómo funciona la tech
Quiere…
Encontrar alfabetización en programación simple
Para poder…
Aprender juntos sin presión
Escalera de creencias
- Internet afecta la atención, la privacidad y los hábitos de mi familia — no es neutra.
- Puedo aprender formas prácticas de usarla mejor sin ser experta en tech.
- Este sitio me habla en español claro, con cuidado por padres e hijos.
- Voy a leer un artículo ahora y volver cuando haya algo nuevo.
Comportamientos en el sitio
- Llega al home o a una categoría/post por búsqueda o redes.
- Ojéa títulos, señales de categoría y primeros párrafos en el celular.
- Acción principal de éxito: empezar a leer → terminar o guardar una idea → opcionalmente compartir #InternetEsCool o el post.
- Acciones secundarias: recorrer categorías, buscar, preguntar en el artículo (asistente / FAQ), seguir a @pabliqe.
- Abandona si el primer viewport parece pitch SaaS, sermón, o algo escrito para otra persona.
Frase
“No necesito que me asusten con la tecnología. Necesito palabras claras para hablarlo en casa — y que el sitio se sienta seguro para pensarlo.”
Mensajes
Que funcionan
- #InternetEsCool cuando lo usamos con conciencia.
- Energía activista con calidez; urgencia sin alarma.
- Practicar lo que se predica: contraste legible, sin dark patterns, respeto por la atención.
- Mostrar el trabajo: los artículos son la prueba.
Que fallan
- Landings SaaS genéricas, métricas de héroe, grillas de íconos-card.
- Blog corporativo uniforme y “thought leadership” de stock.
- Estética hype / growth-bro que erosiona la confianza parental.
- Alarmismo o marco condescendiente de “nativos digitales”.
Audiencias secundarias
Mantenelas distintas en los prompts; no las mezcles con LucIA.
Audiencia
Adultos curiosos
Quiénes
Exploradores de cultura digital y hábitos
Qué necesitan
Reflexión + tomas prácticas sin forzar el framing parental en cada línea
Audiencia
Builders no-code
Quiénes
Emprendedores, creativos, principiantes que publican sin código
Qué necesitan
Guías, herramientas, confianza para construir
Audiencia
Principiantes en programación
Quiénes
Adultos o chicos aprendiendo lógica y cómo funciona internet
Qué necesitan
Alfabetización simple y lúdica — a menudo con un adulto al lado
Si el contenido es para audiencias secundarias, mantené confianza, lenguaje claro y anti-hype — pero aflojá la regla “padres primero”.
Cómo usar
- Abrí /agentes#persona-lucia para el brief en vivo (docs + exports).
- Hablá con LucIA desde el chat flotante (roleplay) en cualquier página del sitio.
- Para el prompt compuesto o la fuente markdown: /persona.md o MCP get_persona (format=markdown|json|prompt).
- Pegá el prompt de LucIA en otras herramientas de IA para copy, UX writing, títulos SEO, FAQs o landings.
- Revisá diseños/copy con el skim test de LucIA: ¿Un padre o madre sabe la próxima acción en 10 segundos?
- Preferí español (vos) en borradores para lectores; inglés solo si la tarea lo pide explícitamente.
Anti-persona
“Diego el growth hacker”
Quiere trucos de funnel, engagement máximo y plantillas virales. Optimizar para Diego rompe la confianza de LucIA. No escribas para él en esta superficie de marca.
¿Cómo se comunican lineamientos de diseño?
North star: La Red Somos Personas. Los agentes UI leen la spec canónica en /design.md · MCP get_design · tokens en .impeccable/design.json.
Category Lane Rule
Cards use lane fill + black ink. Tags on dark surfaces use white border + lane-colored text + arrow.
Underscore Rule
Display titles may end with `_` in Azul Eléctrico via `.title-mark`.
Grid Line Rule
Use `.module-divider` (full-bleed 1px white) between sibling modules only. Internal card rows use `--border-subtle`.
Uniform Border Rule
Module borders are equal on all sides (1px). Never thicken a single edge for emphasis.
Container Scope Rule
Module panels (.glass-card) only for cards, listings, FAQs, sheets, dialogs. Heroes and post body stay flush on the canvas.
Plain Pixel Rule
No backdrop-filter / frosted glass. Surfaces use rgba(0,0,0,0.85) so the pixel canvas stays sharp underneath.
Hero Shell Rule
Full-height hero copy uses .page-hero__shell (max-w-6xl + px-6) to align with the navbar logo column. FWH titles use the larger display-fwh scale.
Main Content Hero Rule
Entrance heroes ([data-main-content-hero]) cover ~100% above-the-fold and stay transparent so site canvas FX + CRT (mouse) reads through. Saber más scroll CTA required.
Sentence Case Title Rule
Titles use sentence case. Never force `text-transform: lowercase`. Uppercase only for category tags and eyebrows.
Tight Leading Rule
Display line-height ≤ 1.05; body prose at 1.6.
JSON-LD: Transparencia para robots
Cada artículo declara su estructura en schema.org para que crawlers y answer engines lean URLs canónicas, fechas y FAQs sin adivinar.
- Cada artículo publica JSON-LD (
Article,BreadcrumbList,FAQPagecuando aplica). - URLs canónicas en
metadata.alternates.canonical. - En cada post, el bloque "Cómo leen los robots este artículo" exporta el JSON del artículo.
- Lectores pueden preguntar sobre un fragmento o el artículo; solo se persiste en Notion con 👍.
- Traducciones EN (opcional, Gemini en build) viven en
public/ai-content/→ rutas/en/…. Guía:docs/TRANSLATIONS.md.
Cómo citar
Autor: Pablo Armen · Sitio: Internet es Cool · URL canónica del artículo · Fecha en Open Graph (article:published_time) y JSON-LD (datePublished).
