REST API

Base URL: https://jenksguo.xyz。特記ない限り JSON です；GET /api/v1/brief は Markdown を返します（{ markdown } を得るには Accept: application/json を送信します）。機械可読版: 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	—	Liveness と構成。
GET	POST	/mcp	—

エラーと制限

• 400 bad_request、404 not_found、429 rate_limited（ask: 20/min/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 の経験・プロジェクト・コミュニティでの役割・学歴を（新しい順で）一覧表示し、業界タグ、ロールレンズ、種類で任意にフィルタできます。短い形式で返します：title、organisation、period、summary、key result、page 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 — 1 件のエントリを取得

経験・プロジェクト・コミュニティでの役割・学歴エントリを 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?"}'