REST API

Base URL: https://jenksguo.xyz。除非另有註明，預設為 JSON；GET /api/v1/brief 會回傳 Markdown（若送出 Accept: application/json，則回傳 { markdown }）。機器可讀版本：OpenAPI。

Endpoints

方法	路徑	工具	功能說明
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（演講、Podcast、寫作）、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：每 IP 每分鐘 20 次）、當未設定模型金鑰時回傳 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（演講、Podcast、寫作）、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?"}'