API REST

Base URL: https://jenksguo.xyz. 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 breve de una página en Markdown sobre Jenks Guo: posicionamiento, rol actual, trayectoria profesional, fortalezas, idiomas, contacto y cómo explorar más.
GET	/api/v1/entries	list_experience	Lista las experiencias, proyectos, roles comunitarios y educación de Jenks (de más reciente a más antiguo), opcionalmente filtrados por etiqueta de industria, lente de rol o tipo.
GET	/api/v1/entries/{slug}	get_entry	Redacción extensa y detallada de una experiencia, proyecto, rol comunitario 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 conteos de evidencia.
GET	/api/v1/search	search_jenks	Búsqueda por palabra 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 (cosmovisión).
POST	/api/v1/ask	ask_jenks	Haz una pregunta en lenguaje natural al asistente Ask Jenks (encaje en el rol, alcance de consultoría, asesoría de transformación de IA, historias STAR, gobernanza…).
POST	/api/chat	—	Chat en streaming usado por el widget del sitio web (flujo de texto plano; events: true intercala líneas de estado \u001e).
POST	/api/transcribe	—	Respaldo de voz: transcribe audio base64.
GET	/api/health	—	Vivacidad y configuración.
GET	POST	/mcp	—

Errores y límites

• 400 bad_request, 404 not_found, 429 rate_limited (ask: 20/min/IP), 503 cuando no se ha configurado 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 breve de una página en Markdown sobre Jenks Guo: posicionamiento, rol actual, trayectoria profesional, fortalezas, idiomas, contacto y cómo explorar más. Empieza aquí.

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

Sin argumentos.

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

list_experience — Listar experiencia

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

• MCP: list_experience en https://jenksguo.xyz/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 los campos traducidos (predeterminado en).

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

get_entry — Obtener una entrada

Redacción extensa y detallada de una experiencia, proyecto, rol comunitario 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.xyz/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 los campos traducidos (predeterminado en).

curl -s "https://jenksguo.xyz/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 conteos de evidencia.

• MCP: list_lenses en https://jenksguo.xyz/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 los campos traducidos (predeterminado en).

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

search_jenks — Buscar en el corpus

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

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

Argumento	Tipo	Obligatorio	Notas
query	string	sí

curl -s "https://jenksguo.xyz/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 (cosmovisión).

• MCP: get_document en https://jenksguo.xyz/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 los campos traducidos (predeterminado en).

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

ask_jenks — Preguntar al asistente de Jenks

Haz una pregunta en lenguaje natural al asistente Ask Jenks (encaje en el rol, alcance de consultoría, asesoría de transformación de IA, 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.xyz/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 los campos traducidos (predeterminado en).
history	array	no	Turnos anteriores opcionales.

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