ドキュメント / reference
MCP ツール
公開および管理用 MCP サーバー上のすべてのツール、引数と例つき。
サーバー
| サーバー | URL | 認証 |
|---|---|---|
| Public | https://jenksguo.pages.dev/mcp |
なし |
| Admin | https://jenksguo.pages.dev/mcp/admin |
Authorization: Bearer <agent token> (jgx_agt_…, スコープ付き) |
| Local (stdio) | jenks mcp / jenks mcp --admin |
env JENKSGUO_ADMIN_TOKEN(管理用) |
トランスポート: Streamable HTTP、ステートレス、JSON-RPC 2.0 over POST(プロトコル 2025-06-18)です。いずれかの URL への GET はディスカバリードキュメントを返します。サーバー名は jenksguo、バージョンは 1.4.0 です。
curl -s https://jenksguo.pages.dev/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brief","arguments":{}}}'
公開ツール
get_brief — Jenks のブリーフを取得
Jenks Guo について 1 ページの Markdown ブリーフです: ポジショニング、現在の役割、キャリアの流れ、強み、言語、連絡先、さらに深く知るための方法をまとめています。ここから始めてください。
- MCP:
get_briefonhttps://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_experienceonhttps://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 件のエントリを取得
経験、プロジェクト、コミュニティでの役割、学歴エントリを slug で指定して長文の解説を取得します: 概要、Jenks が行ったこと、成果、採用側にとっての重要性、主要結果、スキル、証拠リンクを含みます。
- MCP:
get_entryonhttps://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、ソリューションアーキテクト、デベロッパーアドボケイト、デジタルマーケター、ホスピタリティ…)を、ピッチ、正直な不足点、エビデンス件数とともに返します。
- MCP:
list_lensesonhttps://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 — コーパスを検索
すべてのエントリとドキュメントを対象にキーワード検索します。最も一致する本文抜粋とその slug を返します。
- MCP:
search_jenksonhttps://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_documentonhttps://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 と Web3 の CV(ここには一覧表示されません)を返します。
- MCP:
list_cvsonhttps://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 — 1 件の CV を取得
slug で指定した 1 つの CV を返します: タイトル、要約、バージョン、安定した PDF URL(常に最新版。例: https://jenksguo.pages.dev/cv/ai.pdf)、ダウンロード URL、および全バージョンです。AI Lead CV には ai を、Web3 経験について尋ねられた場合は web3 を使用します(AI と Web3 の CV)。
- MCP:
get_cvonhttps://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 と 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 トランスフォーメーション、エージェンティックシステム、リーダーシップ、エンタープライズ統合、DevRel、Web3 パートナーシップ、プロジェクト横断のテクニカルプログラムリード — それぞれ主張、限定条件、強度を含みます。
- MCP:
list_argumentsonhttps://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 つの主張を反論つきで取得
slug で指定した 1 つの主張です: 形式的な議論(前提 → 結論)、数値付きの証拠(エントリ slug)、出典付きの市場統計、正直な限界、公平な異論と回答、誤謬(形式・非形式)への応答、この主張が当てはまらない場合を含みます。Jenks の適合性を検証するために使用してください(宣伝のためだけでなく)。
- MCP:
get_argumentonhttps://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_jenksonhttps://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?"}'
管理ツール
admin_whoami — 自分の情報を確認
資格情報を確認します: あなたが誰か(SSO メールまたはエージェントトークン名)、スコープ、トークンの有効期限、公開(GitHub)の設定状況を返します。
- MCP:
admin_whoamionhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/whoami(agent token) - スコープ:
read - CLI:
jenks admin whoami
引数はありません。
curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_audit_log — 監査ログ
直近の管理アクション(新しい順)を返します: 誰が(SSO メールまたはエージェントトークン)、何を、どのファイル、ブランチ、ホスト、結果。エージェントトークンは自分のアクションのみ閲覧できます。
- MCP:
admin_audit_logonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/audit?limit=&token=(agent token) - スコープ:
read - CLI:
jenks admin audit [--limit 50]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
limit |
integer | いいえ | |
token |
string | いいえ | このエージェントトークン ID のみ(人間ユーザー向け) |
curl -s "https://jenksguo.pages.dev/api/admin/audit" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_schema — コンテンツスキーマ
コンテンツモデルです: エントリのフィールドとルール、タグ、レンズ、種類、書き込み可能なパス、ドキュメント、編集規約。書き込む前にお読みください。
- MCP:
admin_schemaonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/schema(agent token) - スコープ:
read - CLI:
jenks admin schema
引数はありません。
curl -s "https://jenksguo.pages.dev/api/admin/schema" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_list_files — コンテンツファイル一覧
ブランチ上の編集可能なコンテンツファイルを一覧表示します(パス、サイズ、sha)。content/corpus/experiences のように 1 つのフォルダ配下に限定できます。
- MCP:
admin_list_filesonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/files?dir=&branch=(agent token) - スコープ:
read - CLI:
jenks admin ls [dir]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
dir |
string | いいえ | 例: content/corpus/projects(既定: すべてのコンテンツ) |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s "https://jenksguo.pages.dev/api/admin/files" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_read_file — コンテンツファイルを読む
コンテンツファイルの生の Markdown/JSON ソース(および sha)を読み取ります。path を渡すか、エントリ、レンズ、スキルには slug を指定します。
- MCP:
admin_read_fileonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/file?path=&slug=&branch=(agent token) - スコープ:
read - CLI:
jenks admin get <slug|path>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s "https://jenksguo.pages.dev/api/admin/file" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_validate — 変更を検証
コミットせずに、ファイル内容をコンテンツスキーマに対して検証します。問題のリストを返します(空 = 有効)。
- MCP:
admin_validateonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/validate(agent token) - スコープ:
read - CLI:
jenks admin validate <path> <file>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | はい | |
content |
string | はい |
curl -s -X POST https://jenksguo.pages.dev/api/admin/validate \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>"}'
admin_write_file — コンテンツファイルを作成・更新
単一のコンテンツファイルを検証してコミットします(新規作成または置換)。公開は自動です: CI が変更されたエントリをすべての言語に再翻訳し、ビルド・デプロイします(main → jenksguo.pages.dev と jenksguo.xyz、dev → dev.jenksguo.xyz)。数分で反映されます。
- MCP:
admin_write_fileonhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/file(agent token) - スコープ:
content(ブランチmainの場合はpublishも) - CLI:
jenks admin put <path> <file> -m <message>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | はい | |
content |
string | はい | |
message |
string | はい | コミットメッセージ |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'
admin_delete_file — コンテンツファイルを削除
コミットメッセージ付きで 1 つのコンテンツファイルを削除します(例: エントリの削除)。Git の履歴により復元可能です。
- MCP:
admin_delete_fileonhttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/file?path=&message=&branch=(agent token) - スコープ:
content(ブランチmainの場合はpublishも) - CLI:
jenks admin rm <path> -m <message>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | はい | |
message |
string | はい | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X DELETE https://jenksguo.pages.dev/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","message":"<message>"}'
admin_commit_changes — 複数ファイルを一括コミット
複数のファイル変更を 1 回のコミットとして検証・コミットします。各変更は {path, content} または {path, delete: true} の形式です。
- MCP:
admin_commit_changesonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/changes(agent token) - スコープ:
content(ブランチmainの場合はpublishも) - CLI:
jenks admin commit <changes.json> -m <message>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
changes |
array | はい | |
message |
string | はい | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X POST https://jenksguo.pages.dev/api/admin/changes \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"changes":"<changes>","message":"<message>"}'
admin_ai_edit — AI による編集案の下書き
平易な英語の指示から、サイトのモデルに 1 つのコンテンツファイルを書き直させます。提案された内容、差分、検証問題を返します。コミットはしません — レビュー後に admin_write_file を呼んでください。
- MCP:
admin_ai_editonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/ai-edit(agent token) - スコープ:
content - CLI:
jenks admin ai-edit <slug|path> "<instruction>" [--apply]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
instruction |
string | はい | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
content |
string | いいえ | 下書き元とする未保存のファイル本文(既定: 保存済みファイル)。 |
curl -s -X POST https://jenksguo.pages.dev/api/admin/ai-edit \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"instruction":"<instruction>"}'
admin_read_translation — 翻訳を読む
別言語での 1 つのコンテンツファイルを読み取ります: 英語のソースフィールド、現在の翻訳とそのステータス(最新、古い、手作業で編集、未訳)。エントリ、レンズ、CV、主張、見解ページ、学歴、講演、ドキュメントで機能します。言語: zh, zh-hant, ja, fr, es, eo。
- MCP:
admin_read_translationonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/translation?path=&slug=&locale=&branch=(agent token) - スコープ:
read - CLI:
jenks admin tr get <slug|path> <locale>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
locale |
zh · zh-hant · ja · fr · es · eo |
はい | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s "https://jenksguo.pages.dev/api/admin/translation" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_translation — 翻訳を編集
別言語(zh, zh-hant, ja, fr, es, eo)で 1 つのコンテンツファイルのテキストを書き込みます(例: より良い中国語の要約)。変更するフィールドのみを指定してください。まず admin_read_translation でフィールド名を確認してください。Markdown は英語の見出し、コードブロック、リンクを維持する必要があります。英語が変更されるまで編集は保持され、その後その言語は自動的に再翻訳されます。英語がソースです: 変更は admin_write_file で行ってください。
- MCP:
admin_write_translationonhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/translation(agent token) - スコープ:
content(ブランチmainの場合はpublishも) - CLI:
jenks admin tr put <slug|path> <locale> <fields.json> -m <message>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
locale |
zh · zh-hant · ja · fr · es · eo |
はい | |
fields |
object | はい | 例: {"summary": "…", "body": "## …"} |
message |
string | いいえ | コミットメッセージ |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/translation \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","fields":"<fields>"}'
admin_read_copy — サイト文言を読む
指定言語でのサイトのインターフェース文言です — メニュー、ページタイトル、1 行のページ導入文、ヒーロー見出し、ボタン、SEO 説明 — を key → text として返し、英語(および zh-hant 向けには中国語)を併記します。hero や career などの prefix で絞り込めます。
- MCP:
admin_read_copyonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/copy?locale=&prefix=&branch=(agent token) - スコープ:
read - CLI:
jenks admin copy get <locale> [prefix]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
はい | |
prefix |
string | いいえ | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s "https://jenksguo.pages.dev/api/admin/copy" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_copy — サイト文言を編集
1 つの言語のインターフェース文言を変更します: values は key → text("" はあなたの編集を削除)。en と zh は手書きのソースです: 英語の変更は ja, fr, es, eo に自動翻訳されます — zh も設定してください。他言語での編集は、ソース文言が変わるまで保持されます。{placeholders} はそのままにしてください。
- MCP:
admin_write_copyonhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/copy(agent token) - スコープ:
content(ブランチmainの場合はpublishも) - CLI:
jenks admin copy set <locale> <key> "<text>" -m <message>
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
はい | |
values |
object | はい | 例: {"hero.sub": "…"} |
message |
string | いいえ | |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/copy \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","values":"<values>"}'
admin_deploy_status — デプロイ状況
直近の CI 実行(translate → build → deploy)のステータス、ブランチ、コミット、リンクを返します。
- MCP:
admin_deploy_statusonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/deploys?branch=(agent token) - スコープ:
read - CLI:
jenks admin deploys
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s "https://jenksguo.pages.dev/api/admin/deploys" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_promote — dev を本番に昇格
dev ブランチを main にマージし、dev.jenksguo.xyz でプレビューされていたすべてを本番サイト(jenksguo.pages.dev と jenksguo.xyz)に公開します。
- MCP:
admin_promoteonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/promote(agent token) - スコープ:
publish - CLI:
jenks admin promote
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
message |
string | いいえ |
curl -s -X POST https://jenksguo.pages.dev/api/admin/promote \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_publish_cv — 新しい CV バージョンを公開
CV(ai、web3、または新しい slug)の新しい PDF をアップロードし、1 手順で最新版として反映します: PDF はメディアライブラリに保存され、前バージョンは CV の履歴に移動(引き続きダウンロード可能)、変更はコミットされ(CI が公開)。オプションでプレビュー画像や新しいタイトル/要約も設定できます。安定 URL /cv/
- MCP:
admin_publish_cvonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/cv(agent token) - スコープ:
content+media(ブランチmainの場合はpublishも) - CLI:
jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
slug |
string | はい | ai、web3、または新しいケバブケース ID |
version |
string | はい | 例: 2026.10 |
filename |
string | いいえ | |
data |
string | いいえ | PDF バイト列、base64 |
url |
string | いいえ | data の代替: PDF の https URL |
preview |
string | いいえ | オプション: 既にアップロード済みの /media/… な 1 ページ目画像 |
title |
string | いいえ | |
summary |
string | いいえ | |
message |
string | いいえ | コミットメッセージ |
branch |
main · dev |
いいえ | main は本番サイト(jenksguo.pages.dev とミラー jenksguo.xyz)を公開、dev は dev.jenksguo.xyz でプレビュー(既定: main)。 |
curl -s -X POST https://jenksguo.pages.dev/api/admin/cv \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"slug":"<slug>","version":"<version>"}'
admin_list_media — メディア一覧
アップロード済みの画像、動画、PDF を一覧表示します(新しい順): URL、種類、サイズ、寸法、代替テキスト、貼り付け用 Markdown、各ファイルを使用しているエントリを返します。
- MCP:
admin_list_mediaonhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/media?prefix=&cursor=&limit=(agent token) - スコープ:
read - CLI:
jenks admin media ls [prefix]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
prefix |
string | いいえ | 2026/10 などのキー接頭辞 |
cursor |
string | いいえ | |
limit |
integer | いいえ |
curl -s "https://jenksguo.pages.dev/api/admin/media" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_upload_media — メディアをアップロード
画像(webp, jpg, png, gif, avif, svg)、動画(mp4, webm)、PDF を最大 25 MB まで Cloudflare R2 に保存し、公開用の /media/… URL と Markdown を取得します。filename と base64 の data を送るか、インポート用に公開 https の url を指定します。ファイルは URL で即時に公開されます。コンテンツから参照するには admin_write_file を使用します。REST エンドポイントは multipart/form-data(フィールド名 file)も受け付けます。
- MCP:
admin_upload_mediaonhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/media(agent token) - スコープ:
media - CLI:
jenks admin media upload <file|https-url> [--alt "…"]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
filename |
string | いいえ | 元のファイル名。URL の可読部分になります。 |
data |
string | いいえ | ファイルバイト列、base64(data: URL プレフィックス可)。 |
url |
string | いいえ | data の代替: サーバーがダウンロードする https URL。 |
alt |
string | いいえ | 代替テキスト: 画像が示す内容(スクリーンリーダーとボット向け)。 |
width |
integer | いいえ | |
height |
integer | いいえ |
curl -s -X POST https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_update_media — メディアの代替テキストを更新
アップロード済みファイルに保存された代替テキスト(コンテンツに挿入する際の既定の alt)を変更します。
- MCP:
admin_update_mediaonhttps://jenksguo.pages.dev/mcp/admin - REST:
PATCH /api/admin/media(agent token) - スコープ:
media - CLI:
jenks admin media alt <key> "<alt text>"
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
key |
string | はい | メディアキーまたは URL(例: 2026/10/xero-talk-1a2b3c4d5e.webp) |
alt |
string | はい |
curl -s -X PATCH https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>","alt":"<alt>"}'
admin_delete_media — メディアを削除
アップロード済みファイルを完全に削除します。公開中のコンテンツがまだ使用している間は拒否されます(ただし force が true の場合を除く)。コンテンツファイルと異なり git の履歴はなく、復元できません。
- MCP:
admin_delete_mediaonhttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/media?key=&force=(agent token) - スコープ:
media - CLI:
jenks admin media rm <key> [--force]
| 引数 | 型 | 必須 | 注記 |
|---|---|---|---|
key |
string | はい | |
force |
boolean | いいえ |
curl -s -X DELETE https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>"}'
.mdこのページはAIの支援で翻訳されています。正式な肩書は英語のままです。