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

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

- 種類: 公開Webページ
- 正規ページ: [https://www.shotomatic.com/ja/guide/ai-agents/tools](https://www.shotomatic.com/ja/guide/ai-agents/tools)
- Markdownページ: [https://www.shotomatic.com/ja/guide/ai-agents/tools.md](https://www.shotomatic.com/ja/guide/ai-agents/tools.md)

ユーザーガイドを開く

このページの内容

1.  [作業別のツール](#作業別のツール)
2.  [状態と撮影対象](#状態と撮影対象)
3.  [撮影とジョブ](#撮影とジョブ)
4.  [Webサイトキャプチャ](#webサイトキャプチャ)
5.  [キャプチャ履歴](#キャプチャ履歴)
6.  [ドキュメント](#ドキュメント)
7.  [書き出しと設定](#書き出しと設定)
8.  [削除](#削除)

このページでは、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はウインドウを前面に出し、別のウインドウが前面にあるときや画面がロックされているときはキーを押さず、ジョブを一時停止します。キーを押す撮影は、ページが変わらなくなると自動で停止します。停止条件はプランによります。[停止条件、撮影間隔、キー入力](https://www.shotomatic.com/ja/guide/screenshot-capture/automated-capture)をご覧ください。

### start\_action\_capture

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

### get\_job

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

### control\_job

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

## Webサイトキャプチャ

### preview\_website

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

### capture\_websites

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

### 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分間返事を待ちます。キャプチャセッションを削除しても、そこから作ったドキュメントは削除されません。[許可と確認](https://www.shotomatic.com/ja/guide/ai-agents/approvals-and-confirmations)をご覧ください。

ツールがエラーを返したときは、[エージェントのエラーと対処法](https://www.shotomatic.com/ja/guide/ai-agents/errors)をご覧ください。

## このページの内容

1.  [作業別のツール](#作業別のツール)
2.  [状態と撮影対象](#状態と撮影対象)
3.  [撮影とジョブ](#撮影とジョブ)
4.  [Webサイトキャプチャ](#webサイトキャプチャ)
5.  [キャプチャ履歴](#キャプチャ履歴)
6.  [ドキュメント](#ドキュメント)
7.  [書き出しと設定](#書き出しと設定)
8.  [削除](#削除)

## この版について

このMarkdownページは、サーバーでレンダリングされたShotomaticの公開ページから生成されています。操作部品とサイトナビゲーションは含まれません。引用や共有には正規ページを使用してください。
