REST API

Base URL: https://jenksguo.xyz。除特别说明外为 JSON；GET /api/v1/brief 返回 Markdown（发送 Accept: application/json 可获得 { markdown }）。机器可读规范：OpenAPI。

端点

方法	路径	工具	功能说明
GET	/api/v1/brief	get_brief	关于 Jenks Guo 的一页 Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系方式，以及如何进一步了解。
GET	/api/v1/entries	list_experience	列出 Jenks 的经历、项目、社区角色与教育（时间倒序），可按行业标签、角色视角或类型筛选。
GET	/api/v1/entries/{slug}	get_entry	按 slug 获取某条经历、项目、社区角色或教育的长文介绍：概览、Jenks 做了什么、成就、对雇主的意义、关键结果、技能、证明链接。
GET	/api/v1/lenses	list_lenses	雇主可用于审视 Jenks 的角色视角（Head of AI、solution architect、developer advocate、digital marketer、hospitality…），包含电梯陈述、真实差距与证据计数。
GET	/api/v1/search	search_jenks	跨所有条目与文档的关键词搜索。
GET	/api/v1/documents/{name}	get_document	Jenks 的参考文档之一：profile（核心档案）、credentials（教育与认证）、capabilities（能力 → 证据映射）、talks（演讲、播客、写作）、thinking（世界观）。
POST	/api/v1/ask	ask_jenks	向 Ask Jenks 助手提出自然语言问题（角色匹配、咨询范围界定、AI 转型建议、STAR 故事、治理…）。
POST	/api/chat	—	网站小部件使用的流式聊天（纯文本流；events: true 会穿插 \u001e 状态行）。
POST	/api/transcribe	—	语音兜底：转录 base64 音频。
GET	/api/health	—	存活与配置检查。
GET	POST	/mcp	—

错误与限制

• 400 bad_request、404 not_found、429 rate_limited（ask：20/分钟/每 IP），当未配置模型密钥时返回 503。
• GET 端点发送 Access-Control-Allow-Origin: *；POST 端点供服务端代理使用。

get_brief — 获取 Jenks 的简介

关于 Jenks Guo 的一页 Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系方式，以及如何进一步了解。从这里开始。

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

无参数。

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

list_experience — 列出经历

列出 Jenks 的经历、项目、社区角色与教育（时间倒序），可按行业标签、角色视角或类型筛选。返回简要信息：标题、机构、时间段、摘要、关键结果、页面 URL。

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

参数	类型	必填	说明
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	否
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	否
kind	experience · education · community · project	否
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

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

get_entry — 获取单条条目

按 slug 获取某条经历、项目、社区角色或教育的长文介绍：概览、Jenks 做了什么、成就、对雇主的意义、关键结果、技能、证明链接。

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

参数	类型	必填	说明
slug	string	是	条目 slug，例如 xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

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

list_lenses — 列出角色视角

雇主可用于审视 Jenks 的角色视角（Head of AI、solution architect、developer advocate、digital marketer、hospitality…），包含电梯陈述、真实差距与证据计数。

• MCP: list_lenses on https://jenksguo.xyz/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

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

search_jenks — 搜索语料

在所有条目与文档中进行关键词搜索。返回最佳匹配的片段及其 slug。

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

参数	类型	必填	说明
query	string	是

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

get_document — 获取文档

Jenks 的参考文档之一：profile（核心档案）、credentials（教育与认证）、capabilities（能力 → 证据映射）、talks（演讲、播客、写作）、thinking（世界观）。

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

参数	类型	必填	说明
name	profile · credentials · capabilities · talks · thinking	是
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

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

ask_jenks — 询问 Jenks 的助手

向 Ask Jenks 助手提出自然语言问题（角色匹配、咨询范围界定、AI 转型建议、STAR 故事、治理…）。它会在语料上运行自身工具，并以请求的语言作答。受速率限制。

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

参数	类型	必填	说明
question	string	是
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。
history	array	否	可选的早期对话轮次。

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?"}'