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 の1ページ Markdown ブリーフです：ポジショニング、現職、キャリアの流れ、強み、言語、連絡先、さらに深掘りする方法をまとめています。
GET	/api/v1/entries	list_experience	Jenks の経験、プロジェクト、コミュニティでの役割、学歴を一覧します（新しい順）。業界タグ、ロールレンズ、種類で任意にフィルタできます。
GET	/api/v1/entries/{slug}	get_entry	スラッグで指定した1件の経験・プロジェクト・コミュニティ役割・学歴の長文まとめです：概要、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 の参照ドキュメントの1つです：profile（コアプロフィール）、credentials（学歴・認定）、capabilities（ケイパビリティ → エビデンス対応表）、talks（登壇・ポッドキャスト・執筆）、thinking（見解：7つの視点を平易な言葉と例で説明し、加えて他の信念）。
GET	/api/v1/cv	list_cvs	Jenks のダウンロード可能な CV（PDF）— AI Lead CV — のバージョン、日付、安定した PDF URL、ダウンロード URL、プレビュー画像、過去バージョンを返します。
GET	/api/v1/cv/{slug}	get_cv	スラッグで指定した1つの CV：タイトル、要約、バージョン、安定した PDF URL（常に現行バージョン。例：
GET	/api/v1/arguments	list_arguments	ケイパビリティ別の Jenks の主張です — AI transformation、agentic systems、leadership、enterprise integration、DevRel、Web3 partnerships、プロジェクト横断のテクニカルプログラムリード — それぞれについて主張、限定条件、強さを示します。
GET	/api/v1/arguments/{slug}	get_argument	スラッグで指定した1つの主張：形式的な議論（前提 → 結論）、数値付きエビデンス（エントリのスラッグ）、出典付き市場統計、正直な限界、公平な異論とその応答、誤謬に基づく攻撃（形式・非形式）への応答、および適用されない状況を含みます。
POST	/api/v1/ask	ask_jenks	Ask Jenks アシスタントに自然言語で質問します（ロール適合、コンサルティングのスコーピング、AI 変革の助言、STAR 事例、ガバナンス など）。
POST	/api/chat	—	ウェブサイトのウィジェットで使われるストリーミングチャットです（プレーンテキストのストリーム；events: true で \u001e ステータス行が挿入されます；voice: true は短い音声返信を要求します）。
POST	/api/transcribe	—	音声フォールバック：base64 音声を文字起こしします。
POST	/api/speak	—	ウィジェットの音声モード向けにテキストを読み上げます: { text, locale } → audio（英語：Deepgram Aura-2 'theia'、オーストラリア英語の女性声；その他の言語：OpenRouter の音声モデル）。
GET	/api/health	—	稼働状況と構成の確認です。
GET	/cv/{slug}.pdf	—	CV の現行バージョンの PDF です（安定リンク；?download=1 でダウンロード）。/cv/{slug}/{version}.pdf で特定バージョンを配信します。
GET	/media/{key}	—	画像・動画・PDF のアップロード（R2）。不変 URL。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 の1ページ 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 — エントリを1件取得

スラッグで指定した1件の経験、プロジェクト、コミュニティでの役割、学歴の長文まとめです：概要、Jenks が行ったこと、成果、雇用主にとっての意義、主要な結果、スキル、証拠リンク。

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

引数	型	必須	補足
slug	string	はい	エントリのスラッグ。例: 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 — コーパス検索

すべてのエントリとドキュメントを横断するキーワード検索です。最も適合するパッセージとそのスラッグを返します。

• 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 の参照ドキュメントの1つです：profile（コアプロフィール）、credentials（学歴・認定）、capabilities（ケイパビリティ → エビデンス対応表）、talks（登壇・ポッドキャスト・執筆）、thinking（見解：7つの視点を平易な言葉と例で説明し、加えて他の信念）。

• 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 の CV 一覧

Jenks のダウンロード可能な CV（PDF）— AI Lead CV — のバージョン、日付、安定した PDF URL、ダウンロード URL、プレビュー画像、過去バージョンを返します。Web3 の経験についての質問には、slug web3 の get_cv で AI and Web3 CV（ここには一覧表示しません）を取得します。

• 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 — CV を1件取得

スラッグで指定した1つの CV：タイトル、要約、バージョン、安定した PDF URL（常に現行バージョン。例: https://jenksguo.pages.dev/cv/ai.pdf）、ダウンロード URL、すべてのバージョン。AI Lead CV には ai を、Web3 経験を尋ねられた場合は web3 を使用します（AI and Web3 CV）。

• 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 CV）または web3（AI and Web3 CV。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 — 1つの主張（異論付き）を取得

スラッグで指定した1つの主張：形式的な議論（前提 → 結論）、数値付きエビデンス（エントリのスラッグ）、出典付き市場統計、正直な限界、公平な異論とその回答、誤謬に基づく攻撃（形式・非形式）への応答、およびその主張が当てはまらない場合です。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 変革の助言、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?"}'