Saltar al contenido

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.

Comandos disponibles por MCP

Cada comando es una tool del servidor MCP. Copiá el nombre para usarlo en tu cliente.

  • list_posts

    Listar artículos (filtro por categoría opcional)

  • get_post

    Metadata, cuerpo en texto plano, FAQs y comentarios

  • search_posts

    Búsqueda por palabras clave

  • list_categories

    Categorías editoriales

  • get_site_info

    Información del sitio y estadísticas

  • get_post_faqs

    FAQs y comentarios generados por agente

  • get_user_questions

    Preguntas persistidas en Notion bajo "La gente pregunta sobre esto"

  • ask_about_post

    Responde vía Gemini y persiste Q&A en la página Notion del artículo

  • get_persona

    Persona IA LucIA (markdown | json | prompt) para agent building

  • get_design

    Design 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, FAQPage cuando 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).

← Volver al inicio