API REST

Base URL: https://jenksguo.pages.dev. JSON salvo que se indique; GET /api/v1/brief devuelve Markdown (envía Accept: application/json para { markdown }). Legible por máquinas: OpenAPI.

Endpoints

Método	Ruta	Herramienta	Qué hace
GET	/api/v1/brief	get_brief	Un resumen Markdown de una página sobre Jenks Guo: posicionamiento, rol actual, arco profesional, fortalezas, idiomas, contacto y cómo explorar más.
GET	/api/v1/entries	list_experience	Lista las experiencias, proyectos, roles en la comunidad y educación de Jenks (más recientes primero), opcionalmente filtrados por etiqueta de industria, lente de rol o tipo.
GET	/api/v1/entries/{slug}	get_entry	Redacción extensa de una experiencia, proyecto, rol en la comunidad o entrada de educación por slug: panorama general, qué hizo Jenks, logros, por qué importa para empleadores, resultados clave, habilidades, enlaces de prueba.
GET	/api/v1/lenses	list_lenses	Las lentes de rol a través de las cuales los empleadores pueden ver a Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) con un pitch, brechas honestas y recuentos de evidencia.
GET	/api/v1/search	search_jenks	Búsqueda por palabras clave en cada entrada y documento.
GET	/api/v1/documents/{name}	get_document	Uno de los documentos de referencia de Jenks: profile (perfil central), credentials (educación, certificaciones), capabilities (mapa capacidad → evidencia), talks (charlas, pódcasts, escritura), thinking (punto de vista: siete visiones, cada una explicada en palabras simples con ejemplos, más creencias adicionales).
GET	/api/v1/cv	list_cvs	El CV descargable de Jenks (PDF) — el AI Lead CV — con versión, fecha, una URL PDF estable, una URL de descarga, una imagen de vista previa y versiones anteriores.
GET	/api/v1/cv/{slug}	get_cv	Un CV por slug: título, resumen, versión, la URL PDF estable (siempre la versión actual, p. ej.
GET	/api/v1/arguments	list_arguments	Los argumentos a favor de Jenks por capacidad — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships y liderazgo de programa técnico interproyectos — cada uno con su afirmación, calificador y fortaleza.
GET	/api/v1/arguments/{slug}	get_argument	Un argumento por slug: el argumento formal (premisas → conclusión), evidencia con números (slugs de entradas), estadísticas de mercado con fuentes, límites honestos, objeciones justas con respuestas, ataques falaces (formales e informales) con réplicas y cuándo no aplica el argumento.
POST	/api/v1/ask	ask_jenks	Haz una pregunta en lenguaje natural al asistente Ask Jenks (encaje en un rol, alcance de consultoría, consejos de AI transformation, historias STAR, gobernanza…).
POST	/api/chat	—	Chat en streaming usado por el widget del sitio web (stream de texto plano; events: true intercala líneas de estado \u001e; voice: true pide una respuesta hablada corta).
POST	/api/transcribe	—	Recurso de respaldo de voz: transcribir audio base64.
POST	/api/speak	—	Leer texto en voz alta para el modo de voz del widget: { text, locale } → audio (Inglés: Deepgram Aura-2 'theia', una voz femenina australiana; otros idiomas: un modelo de audio de OpenRouter).
GET	/api/health	—	Estado de vida y configuración.
GET	/cv/{slug}.pdf	—	La versión actual de un CV en PDF (enlace estable; ?download=1 lo descarga). /cv/{slug}/{version}.pdf sirve una versión específica.
GET	/media/{key}	—	Imágenes, videos y PDFs subidos (R2). URLs inmutables; admite Range e If-None-Match.
GET	POST	/mcp	—

Errores y límites

• 400 bad_request, 404 not_found, 429 rate_limited (ask: 20/min/IP), 503 cuando no se configura una clave de modelo.
• Los endpoints GET envían Access-Control-Allow-Origin: *; los endpoints POST son para agentes del lado del servidor.

get_brief — Obtener el brief de Jenks

Un brief en Markdown de una página sobre Jenks Guo: posicionamiento, rol actual, arco profesional, fortalezas, idiomas, contacto y cómo explorar más. Empieza aquí.

• MCP: get_brief en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

Sin argumentos.

curl -s "https://jenksguo.pages.dev/api/v1/brief"

list_experience — Listar experiencia

Lista las experiencias, proyectos, roles en la comunidad y educación de Jenks (más recientes primero), opcionalmente filtrados por etiqueta de industria, lente de rol o tipo. Devuelve formas cortas: título, organización, periodo, resumen, resultado clave, URL de la página.

• MCP: list_experience en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
• CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]

Argumento	Tipo	Obligatorio	Notas
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	no
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	no
kind	experience · education · community · project	no
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/entries"

get_entry — Obtener una entrada

Redacción extensa de una experiencia, proyecto, rol en la comunidad o entrada de educación por slug: panorama general, qué hizo Jenks, logros, por qué importa para empleadores, resultados clave, habilidades, enlaces de prueba.

• MCP: get_entry en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries/{slug}?locale=
• CLI: jenks get <slug>

Argumento	Tipo	Obligatorio	Notas
slug	string	sí	Slug de la entrada, p. ej. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist"

list_lenses — Listar lentes de rol

Las lentes de rol a través de las cuales los empleadores pueden ver a Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) con un pitch, brechas honestas y recuentos de evidencia.

• MCP: list_lenses en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

Argumento	Tipo	Obligatorio	Notas
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/lenses"

search_jenks — Buscar en el corpus

Búsqueda por palabras clave en cada entrada y documento. Devuelve los pasajes con mejor coincidencia con sus slugs.

• MCP: search_jenks en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

Argumento	Tipo	Obligatorio	Notas
query	string	sí

curl -s "https://jenksguo.pages.dev/api/v1/search"

get_document — Obtener un documento

Uno de los documentos de referencia de Jenks: profile (perfil central), credentials (educación, certificaciones), capabilities (mapa capacidad → evidencia), talks (charlas, pódcasts, escritura), thinking (punto de vista: siete visiones, cada una explicada en palabras simples con ejemplos, más creencias adicionales).

• MCP: get_document en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/documents/{name}?locale=
• CLI: jenks doc <name>

Argumento	Tipo	Obligatorio	Notas
name	profile · credentials · capabilities · talks · thinking	sí
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/documents/credentials"

list_cvs — Listar los CV de Jenks

El CV descargable de Jenks (PDF) — el AI Lead CV — con versión, fecha, una URL PDF estable, una URL de descarga, una imagen de vista previa y versiones anteriores. Para preguntas sobre su experiencia en Web3, get_cv con el slug web3 devuelve el AI and Web3 CV (no listado aquí).

• MCP: list_cvs en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv?locale=
• CLI: jenks cv

Argumento	Tipo	Obligatorio	Notas
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/cv"

get_cv — Obtener un CV

Un CV por slug: título, resumen, versión, la URL PDF estable (siempre la versión actual, p. ej. https://jenksguo.pages.dev/cv/ai.pdf), la URL de descarga y todas las versiones. Usa ai para el AI Lead CV; usa web3 para el AI and Web3 CV cuando alguien pregunte por su experiencia en Web3.

• MCP: get_cv en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv/{slug}?locale=
• CLI: jenks cv <slug> [--download] [-o file.pdf]

Argumento	Tipo	Obligatorio	Notas
slug	string	sí	ai (el AI Lead CV) o web3 (el AI and Web3 CV, para preguntas de Web3)
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"

list_arguments — Listar el caso a favor de Jenks

Los argumentos a favor de Jenks por capacidad — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships y liderazgo de programa técnico interproyectos — cada uno con su afirmación, calificador y fortaleza.

• MCP: list_arguments en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments?locale=
• CLI: jenks argue

Argumento	Tipo	Obligatorio	Notas
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/arguments"

get_argument — Obtener un argumento, con objeciones

Un argumento por slug: el argumento formal (premisas → conclusión), evidencia con números (slugs de entradas), estadísticas de mercado con fuentes, límites honestos, objeciones justas con respuestas, ataques falaces (formales e informales) con réplicas y cuándo no aplica el argumento. Úsalo para poner a prueba el encaje de Jenks, no solo para promocionarlo.

• MCP: get_argument en https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments/{slug}?locale=
• CLI: jenks argue <slug>

Argumento	Tipo	Obligatorio	Notas
slug	string	sí	ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships o technical-program-leadership
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).

curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"

ask_jenks — Preguntarle al asistente de Jenks

Haz una pregunta en lenguaje natural al asistente Ask Jenks (encaje en un rol, alcance de consultoría, consejos de AI transformation, historias STAR, gobernanza…). Ejecuta sus propias herramientas sobre el corpus y responde en el idioma solicitado. Con límite de tasa.

• MCP: ask_jenks en https://jenksguo.pages.dev/mcp
• REST: POST /api/v1/ask
• CLI: jenks ask "<question>"

Argumento	Tipo	Obligatorio	Notas
question	string	sí
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (por defecto en).
history	array	no	Turnos anteriores opcionales.

curl -s -X POST https://jenksguo.pages.dev/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'