REST API

Base URL: https://jenksguo.pages.dev。除非另有註明為 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（演講、Podcast、寫作）、thinking（觀點：七個視角，以白話與範例說明，另含進一步主張）。
GET	/api/v1/cv	list_cvs	Jenks 可下載的履歷（PDF）— AI Lead 履歷 — 含版本、日期、穩定 PDF 連結、下載連結、預覽圖與早期版本。
GET	/api/v1/cv/{slug}	get_cv	依 slug 取得單一履歷：標題、摘要、版本、穩定 PDF 連結（永遠指向目前版本，例如
GET	/api/v1/arguments	list_arguments	依能力彙整支持 Jenks 的論證 — AI transformation、agentic systems、leadership、enterprise integration、DevRel、Web3 partnerships 與跨專案技術計畫領導 — 各自含主張、限定條件與強度。
GET	/api/v1/arguments/{slug}	get_argument	依 slug 取得單一論證：形式論證（前提 → 結論）、含數據的證據（條目 slugs）、具來源的市場統計、誠實的限制、合理反對與回應、謬誤攻擊（形式與非形式）及回覆，以及不適用情境。
POST	/api/v1/ask	ask_jenks	以自然語言向 Ask Jenks 助理發問（職務適配、顧問範疇、AI transformation 建議、STAR 故事、治理…）。
POST	/api/chat	—	供網站小工具使用的串流聊天（純文字串流；events: true 會夾帶 \u001e 狀態行；voice: true 要求簡短語音回覆）。
POST	/api/transcribe	—	語音後備：轉寫 base64 音訊。
POST	/api/speak	—	為小工具的語音模式朗讀文字：{ text, locale } → audio（English：Deepgram Aura-2 'theia'，澳洲女性聲；其他語言：OpenRouter audio model）。
GET	/api/health	—	存活度與組態。
GET	/cv/{slug}.pdf	—	以 PDF 提供履歷的目前版本（穩定連結；?download=1 直接下載）。/cv/{slug}/{version}.pdf 可取得特定版本。
GET	/media/{key}	—	上傳的圖片、影片與 PDF（R2）。不可變連結；支援 Range 與 If-None-Match。
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.pages.dev/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

無參數。

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

list_experience — 列出經歷

列出 Jenks 的經歷、專案、社群角色與學歷（新到舊），可選擇依產業標籤、角色視角或類型篩選。回傳精簡資訊：標題、組織、期間、摘要、關鍵成果、頁面 URL。

• MCP: list_experience on https://jenksguo.pages.dev/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.pages.dev/api/v1/entries"

get_entry — 取得單一條目

依 slug 取得單一經歷、專案、社群角色或學歷的長篇說明：概述、Jenks 的作為、成就、對雇主的重要性、關鍵成果、技能與佐證連結。

• MCP: get_entry on https://jenksguo.pages.dev/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.pages.dev/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.pages.dev/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

參數	類型	必填	說明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻譯欄位的語言（預設 en）。

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

search_jenks — 全文搜尋

跨所有條目與文件進行關鍵字搜尋。回傳最佳相符片段與其 slugs。

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

參數	類型	必填	說明
query	string	是

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

get_document — 取得文件

Jenks 的參考文件之一：profile（核心檔案）、credentials（學歷與證照）、capabilities（能力 → 證據地圖）、talks（演講、Podcast、寫作）、thinking（觀點：七個視角，以白話與範例說明，另含進一步主張）。

• MCP: get_document on https://jenksguo.pages.dev/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.pages.dev/api/v1/documents/credentials"

list_cvs — 列出 Jenks 的履歷

Jenks 可下載的履歷（PDF）— AI Lead 履歷 — 含版本、日期、穩定 PDF 連結、下載連結、預覽圖與早期版本。若需關於其 Web3 經驗的問題，使用 get_cv 並以 slug web3 可取得 AI 與 Web3 履歷（此處不列出）。

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

參數	類型	必填	說明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻譯欄位的語言（預設 en）。

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

get_cv — 取得單一履歷

依 slug 取得單一履歷：標題、摘要、版本、穩定 PDF 連結（永遠為目前版本，例如 https://jenksguo.pages.dev/cv/ai.pdf）、下載連結與所有版本。使用 ai 取得 AI Lead 履歷；當他人詢問其 Web3 經驗時，使用 web3 取得 AI 與 Web3 履歷。

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

參數	類型	必填	說明
slug	string	是	ai（AI Lead 履歷）或 web3（AI 與 Web3 履歷，供 Web3 問題）
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻譯欄位的語言（預設 en）。

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

list_arguments — 列出支持 Jenks 的論證

依能力彙整支持 Jenks 的論證 — AI transformation、agentic systems、leadership、enterprise integration、DevRel、Web3 partnerships 與跨專案技術計畫領導 — 各自含主張、限定條件與強度。

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

參數	類型	必填	說明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻譯欄位的語言（預設 en）。

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

get_argument — 取得單一論證（含反對意見）

依 slug 取得單一論證：形式論證（前提 → 結論）、含數據的證據（條目 slugs）、具來源的市場統計、誠實的限制、合理反對與回應、謬誤攻擊（形式與非形式）及回覆，以及不適用情境。用來檢驗而非僅推銷 Jenks 的適配性。

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

參數	類型	必填	說明
slug	string	是	ai-transformation、agentic-systems、leadership、enterprise-integration、devrel、web3-partnerships 或 technical-program-leadership
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻譯欄位的語言（預設 en）。

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

ask_jenks — 詢問 Jenks 的助理

以自然語言向 Ask Jenks 助理發問（職務適配、顧問範疇、AI transformation 建議、STAR 故事、治理…）。它會對整個語料運行自身工具，並以請求語言作答。受速率限制。

• MCP: ask_jenks on https://jenksguo.pages.dev/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.pages.dev/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'