ユーザーガイドを開く

ツールリファレンス

ShotomaticがAIエージェントに提供するすべてのMCPツール、それぞれの役割、事前に確認されるツール、Proが必要な機能をまとめました。

更新日 2026年11月16日

Markdownを表示
このページの内容

このページでは、Shotomatic 1.10.1が許可済みのエージェントに提供するMCPツールをまとめます。エージェントは接続時に、同じ一覧を入力スキーマ付きで読み込みます。ユーザーが直接呼び出すものではありませんが、知っておくと依頼を具体的に書きやすく、エージェントの報告も理解しやすくなります。

作業別のツール

エージェントに任せたいこと使われるツール
権限、プラン、実行中の作業を確認するget_status
画面に何が映っているかを見るlist_capture_sources, capture_snapshot, capture_window_snapshot
キーを押しながらウインドウを繰り返し撮るstart_auto_capture, get_job, control_job
クリック手順のガイドを記録するstart_action_capture, get_job, control_job
Webページを撮影するpreview_website, capture_websites, get_job, control_job
Webサイトの設定を再利用・予約するwebsite_capture_options, website_workflows
過去の撮影を探して見るlist_capture_sessions, get_capture_session, view_images
ドキュメントを作成・編集するlist_documents, get_document, create_document, add_pages, edit_document
ファイルとして取り出すexport, get_job
整理するdelete_items, rename_capture_session
撮影と書き出しの設定を変えるupdate_settings

時間のかかる作業は、すぐにジョブIDを返します。エージェントはget_jobでジョブを追い、1回の呼び出しで最大50秒待ちます。そのため、長い撮影も呼び出しの合間にShotomatic側で進み続けます。

状態と撮影対象

get_status

アプリのバージョン、画面収録とアクセシビリティの権限の有無、プランと今日の無料スクリーンショットの残り、機能の上限、実行中のジョブ、Webサイト用ブラウザがインストール済みか、現在の設定を返します。エージェントは最初にこれを呼び出し、ユーザーが問題を直したあとにも呼び出します。

list_capture_sources

Shotomaticで撮影できるウインドウと画面を、ID、名前、アプリ名とともに一覧にします。

capture_snapshot

ウインドウや画面をプレビューして、目的のページが開いているかを確認します。プレビューは縮小したJPEGで、キャプチャ履歴には保存されず、無料のスクリーンショットも消費しません。

capture_window_snapshot

1つのウインドウのPNGスナップショットを撮ってエージェントに返します。capture_snapshotと同じく保存されません。

撮影とジョブ

start_auto_capture

1つのウインドウを一定の間隔で撮影し、1枚ごとにページ送りの右矢印キーなどを押せます。Shotomaticはウインドウを前面に出し、別のウインドウが前面にあるときや画面がロックされているときはキーを押さず、ジョブを一時停止します。キーを押す撮影は、ページが変わらなくなると自動で停止します。停止条件はプランによります。停止条件、撮影間隔、キー入力をご覧ください。

start_action_capture

操作キャプチャを開始します。選んだウインドウでクリックするたびに手順が保存され、撮影を止めるとドキュメントが作られます。Shotomaticが代わりにクリックすることはありません。クリックはユーザーが行うか、コンピュータ操作の機能を持つエージェントが行います。

get_job

先に始めた撮影、Webサイトのバッチ、書き出しを確認し、進み具合を待てます。

control_job

実行中のジョブを操作します。自動キャプチャでは一時停止、再開、停止(撮影済みのスクリーンショットは残す)ができます。操作キャプチャでは停止してドキュメントを作るか、クリックせずに手順を保存できます。Webサイトのバッチでは、バッチ全体の取り消し、または1ページの取り消しや再試行ができます。

Webサイトキャプチャ

preview_website

1つのURLを指定のオプションでShotomaticのブラウザに表示し、結果をエージェントに見せます。バッチの前にオプションを調整するときに使います。プレビューは保存されません。

capture_websites

Webページの一覧を、ページ全体または表示範囲で、デスクトップ・タブレット・モバイルのサイズで撮影し、1つのキャプチャセッションにまとめます。保存済みのワークフローをすぐに実行することもできます。ユーザーの画面は使いません。Webサイト用ブラウザが必要です。Webサイトキャプチャのクイックスタートをご覧ください。

website_capture_options

Webサイトキャプチャの保存済みオプションを一覧、読み込み、保存します。エージェントは保存済みオプションを削除できません。

website_workflows

ワークフローを一覧、読み込み、保存、一時停止、再開します。スケジュールは5分以上の間隔か、毎日の時刻で指定します。スケジュール付きのワークフローを保存または再開するときはユーザーの確認を待ちますが、一時停止に確認は不要です。予定の実行はShotomaticが開いているときだけ行われ、閉じている間に逃した実行は後から補われません。エージェントはワークフローを削除できません。

キャプチャ履歴

list_capture_sessions

キャプチャセッションを新しい順に、フレーム数と、そのセッションから作ったドキュメントがあればそのドキュメントとともに一覧にします。

get_capture_session

1つのセッションを読み込みます。概要、最大200件ずつに区切ったフレームのファイルパス、Webサイトキャプチャならページごとの状態を返します。

rename_capture_session

Shotomaticに表示されるセッション名を変更します。

view_images

キャプチャ履歴のフレームやドキュメントのページを画像としてエージェントに見せます。1回につき最大6枚、合計8MBまでです。ドキュメントのページは、切り抜きや注釈のない元画像で表示されます。エージェントが見た画像は、そのエージェントの会話に含まれます。

ドキュメント

list_documents

ドキュメントを、最近変更した順に一覧にします。

get_document

ドキュメントのタイトル、リビジョン、ページごとのテキスト、表示範囲、注釈を読み込みます。

create_document

キャプチャセッションのフレーム、画像ファイル、空白ページからドキュメントを作ります。すでにドキュメントがあるセッション全体を選ぶと、コピーを作らずにそのドキュメントを返します。

add_pages

キャプチャセッションのフレームや画像ファイルから、末尾または指定したページの後ろにページを追加します。

edit_document

ドキュメントを1回の操作で変更します。タイトル、ページのタイトルと説明、表示範囲、注釈、ページの順序、ページの複製と削除、透かしを扱います。一部でも失敗すると何も変わりません。ぼかし、マーカー、クリックマーカー、透かしにはProが必要です。エディタで開いているドキュメントなら、エディタが読み込み直します。

書き出しと設定

export

ドキュメントはPDF、PNG、JPG、WebP、ZIPで、キャプチャセッションのフレームはZIP、PNG、JPG、検索可能なPDF、MP4で書き出します。ファイルは新しい名前で書き出し先フォルダに保存され、既存のファイルを上書きせず、画面には何も開きません。

update_settings

自動書き出し(オン・オフ、PNG・JPG)、JPGの画質、キャプチャ履歴に残すセッション数を変更します。セッションが削除されるほど上限を下げる場合は、先にユーザーに確認します。書き出し先フォルダ、言語、プリセット、ライセンスは変更できません。

削除

delete_items

ドキュメントやキャプチャセッションを、1回で最大50件まで削除します。Shotomaticはすべての項目を並べた確認カードを1回表示し、最大1分間返事を待ちます。キャプチャセッションを削除しても、そこから作ったドキュメントは削除されません。許可と確認をご覧ください。

ツールがエラーを返したときは、エージェントのエラーと対処法をご覧ください。

ツールリファレンス | ユーザーガイド | Shotomatic