# 工具参考 | 用户指南 | Shotomatic

> Shotomatic 为 AI 智能体提供的所有 MCP 工具：每个工具的作用、哪些会先征求你的确认，以及哪些部分需要 Pro。

- 类型: 公开网页
- 规范页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/tools](https://www.shotomatic.com/zh-cn/guide/ai-agents/tools)
- Markdown 页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/tools.md](https://www.shotomatic.com/zh-cn/guide/ai-agents/tools.md)

浏览用户指南

本页内容

1.  [什么任务用什么工具](#什么任务用什么工具)
2.  [状态与截图来源](#状态与截图来源)
3.  [截图与任务](#截图与任务)
4.  [网页截图](#网页截图)
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`

截取网页

`preview_website`, `capture_websites`, `get_job`, `control_job`

复用或定时运行网页设置

`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` 跟踪任务，每次调用最多等待 50 秒，所以长时间的截图会在两次调用之间继续在 Shotomatic 中运行。

## 状态与截图来源

### get\_status

返回应用版本、是否已授予**屏幕录制**和**辅助功能**权限、你的版本以及今天还能使用的免费截图数、功能限制、正在运行的任务、网页浏览器是否已安装，以及当前设置。智能体会先调用它，在你修好某个问题后也会再调用一次。

### list\_capture\_sources

列出 Shotomatic 可以截取的窗口和屏幕，包括 ID、名称和所属应用名称。

### capture\_snapshot

预览某个窗口或屏幕，确认打开的是正确的页面。预览是较小的 JPEG，不会保存到截图历史，也不占用免费截图数。

### capture\_window\_snapshot

截取一个窗口的 PNG 快照并返回给智能体。和 `capture_snapshot` 一样不会保存。

## 截图与任务

### start\_auto\_capture

按固定间隔截取一个窗口，并可以在每次截图后按一个键，例如用向右方向键翻页。Shotomatic 会把窗口调到最前面；如果其他窗口在前面或屏幕已锁定，它不会按键，而是暂停任务。设置了按键时，页面不再变化就会自动停止。停止条件取决于你的版本，详见[停止条件、时间间隔和按键](https://www.shotomatic.com/zh-cn/guide/screenshot-capture/automated-capture)。

### start\_action\_capture

启动 [Action Capture](https://www.shotomatic.com/zh-cn/guide/screenshot-capture/action-capture)：在所选窗口中每点击一次就保存一个步骤，截图停止时生成文档。Shotomatic 不会点击。点击由你来做，或者由具备自身电脑操作能力的智能体来做。

### get\_job

检查之前启动的截图、网页批量任务或导出，并可以等待进度。

### control\_job

控制正在运行的任务。自动截图：暂停、继续或停止，已截取的截图会保留。Action Capture：停止并生成文档，或不点击直接保存一个步骤。网页批量任务：取消整个批次，或取消、重试单个页面。

## 网页截图

### preview\_website

用指定选项在 Shotomatic 的浏览器中渲染一个网址，并把结果给智能体看，便于在批量截取前调整选项。预览不会保存。

### capture\_websites

按整页或可见区域、桌面·平板·手机尺寸截取一组网页，保存为一个截图会话；也可以立即运行已保存的工作流。不会使用你的屏幕。需要安装网页浏览器，详见[网页截图快速入门](https://www.shotomatic.com/zh-cn/guide/website-capture/quick-start)。

### website\_capture\_options

列出、读取或保存网页截图的已保存选项。智能体不能删除已保存选项。

### website\_workflows

列出、读取、保存、暂停或继续工作流。计划可以是至少 5 分钟的间隔，或每天的固定时间。保存带计划的工作流或继续工作流时，会等待你的确认；暂停则不需要。计划运行只在 Shotomatic 打开时进行，应用关闭期间错过的运行不会补上。智能体不能删除工作流。

## 截图历史

### list\_capture\_sessions

按从新到旧列出截图会话，附带画面数量，以及由该会话生成的文档（如有）。

### get\_capture\_session

读取一个会话：摘要、画面文件路径（每次最多 200 个），网页截图还会给出每个页面及其状态。

### rename\_capture\_session

修改会话在 Shotomatic 中显示的名称。

### view\_images

把截图历史中的画面或文档页面作为图片给智能体看，每次最多 6 张，总计不超过 8 MB。文档页面显示为原图，不含裁剪和标注。智能体查看过的图片会成为它对话的一部分。

## 文档

### list\_documents

按最近修改的顺序列出文档。

### get\_document

读取文档：标题、修订版本、各页面的文字、画面范围和标注。

### create\_document

用截图会话中的画面、图片文件或空白页面创建文档。如果选择的整个会话已经有文档，会返回那份文档，而不是副本。

### add\_pages

用截图会话中的画面或图片文件添加页面，放在末尾或指定页面之后。

### edit\_document

一次性修改文档：标题、页面标题和说明、画面范围、标注、页面顺序、复制或删除页面以及水印。只要有一处失败，就不会做任何更改。模糊、标记、点击标记和水印需要 Pro。如果文档正在编辑器中打开，编辑器会重新载入它。

## 导出与设置

### export

把文档导出为 PDF、PNG、JPG、WebP 或 ZIP，把截图会话的画面导出为 ZIP、PNG、JPG、可搜索 PDF 或 MP4。文件会以新名称保存到导出文件夹，不会覆盖已有文件，屏幕上也不会打开任何内容。

### update\_settings

更改**自动导出**（开或关，PNG 或 JPG）、JPG 质量，以及截图历史保留的会话数。如果新上限会删除会话，会先问你。导出文件夹、语言、预设和许可证无法更改。

## 删除

### delete\_items

一次请求最多删除 50 个文档或截图会话。Shotomatic 会显示一张列出所有项目的确认卡片，最多等待一分钟。删除截图会话不会删除由它生成的文档。请参阅[批准与确认](https://www.shotomatic.com/zh-cn/guide/ai-agents/approvals-and-confirmations)。

如果工具返回错误，请参阅[智能体错误与解决方法](https://www.shotomatic.com/zh-cn/guide/ai-agents/errors)。

## 本页内容

1.  [什么任务用什么工具](#什么任务用什么工具)
2.  [状态与截图来源](#状态与截图来源)
3.  [截图与任务](#截图与任务)
4.  [网页截图](#网页截图)
5.  [截图历史](#截图历史)
6.  [文档](#文档)
7.  [导出与设置](#导出与设置)
8.  [删除](#删除)

## 关于此版本

此 Markdown 页面根据 Shotomatic 服务端渲染的公开页面生成，不包含交互控件和网站导航。引用或分享时，请使用规范页面。
