Usa la REST API

Conceptos básicos

• URL base: https://jenksguo.xyz/api/v1
• Sin autenticación para endpoints públicos. Las respuestas son JSON salvo que se indique lo contrario.
• Los endpoints GET permiten solicitudes de orígenes cruzados. POST /api/v1/ask está limitado por IP.
• Listas completas de parámetros: Referencia de la REST API.

Obtener el brief

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

El mismo brief está disponible como archivo en https://jenksguo.xyz/brief.md.

Listar entradas, filtradas

Todo el trabajo de Web3:

curl -s "https://jenksguo.xyz/api/v1/entries?tag=web3"

Solo roles de comunidad y gobernanza:

curl -s "https://jenksguo.xyz/api/v1/entries?kind=community"

Combina filtros: ?tag=consulting&lens=ai-transformation-consultant. Las tags son it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community y creative.

Obtener una entrada, traducida

curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist?locale=zh"

Locales compatibles: en (predeterminado), zh, zh-hant, ja, fr, es, eo. Los títulos oficiales de los puestos y los nombres de las organizaciones permanecen en inglés en todos los locales.

Buscar

curl -s "https://jenksguo.xyz/api/v1/search?q=hackathons"

Los resultados son pasajes con el slug de la entrada o documento del que proceden. Continúa con /api/v1/entries/{slug}.

Leer un documento

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

Documentos: profile, credentials, capabilities, talks, thinking.

Preguntar al asistente

curl -s https://jenksguo.xyz/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question": "What has Jenks built with AI agents?", "locale": "en"}'

Añade turnos anteriores con "history": [{"role": "user", "content": "…"}, {"role": "assistant", "content": "…"}]. Si recibes 429, espera un minuto.

Ejemplo: crear una nota de lista corta con jq

Los campos de la respuesta se enumeran en la Referencia de la REST API.

curl -s "https://jenksguo.xyz/api/v1/entries?lens=developer-advocate" \
  | jq -r '.entries[] | "- \(.title) — \(.org) (\(.period)): \(.summary)"'

Alternativas estáticas

Si solo necesitas archivos, estos nunca cambian de forma y se almacenan bien en caché: /llms.txt, /llms-full.txt, /experience.json, /resume.json y /openapi.json.