Skip to main content
Jenks Guo

ドキュメント / 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_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 件のエントリを取得

経験、プロジェクト、コミュニティでの役割、学歴エントリを 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、ソリューションアーキテクト、デベロッパーアドボケイト、デジタルマーケター、ホスピタリティ…)を、ピッチ、正直な不足点、エビデンス件数とともに返します。

  • 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 — コーパスを検索

すべてのエントリとドキュメントを対象にキーワード検索します。最も一致する本文抜粋とその slug を返します。

  • 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 と 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 — 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_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 と 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_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 つの主張を反論つきで取得

slug で指定した 1 つの主張です: 形式的な議論(前提 → 結論)、数値付きの証拠(エントリ slug)、出典付きの市場統計、正直な限界、公平な異論と回答、誤謬(形式・非形式)への応答、この主張が当てはまらない場合を含みます。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?"}'

管理ツール

admin_whoami — 自分の情報を確認

資格情報を確認します: あなたが誰か(SSO メールまたはエージェントトークン名)、スコープ、トークンの有効期限、公開(GitHub)の設定状況を返します。

  • MCP: admin_whoami on https://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_log on https://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_schema on https://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_files on https://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_file on https://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_validate on https://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_file on https://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_file on https://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_changes on https://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_edit on https://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_translation on https://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_translation on https://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_copy on https://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_copy on https://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_status on https://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_promote on https://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/.pdf は新しいファイルを提供するようになります。

  • MCP: admin_publish_cv on https://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_media on https://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_media on https://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_media on https://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_media on https://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の支援で翻訳されています。正式な肩書は英語のままです。