工具参考
Shotomatic 为 AI 智能体提供的所有 MCP 工具:每个工具的作用、哪些会先征求你的确认,以及哪些部分需要 Pro。
更新日期 2026年11月16日
本页列出 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 会把窗口调到最前面;如果其他窗口在前面或屏幕已锁定,它不会按键,而是暂停任务。设置了按键时,页面不再变化就会自动停止。停止条件取决于你的版本,详见停止条件、时间间隔和按键。
start_action_capture
启动 Action Capture:在所选窗口中每点击一次就保存一个步骤,截图停止时生成文档。Shotomatic 不会点击。点击由你来做,或者由具备自身电脑操作能力的智能体来做。
get_job
检查之前启动的截图、网页批量任务或导出,并可以等待进度。
control_job
控制正在运行的任务。自动截图:暂停、继续或停止,已截取的截图会保留。Action Capture:停止并生成文档,或不点击直接保存一个步骤。网页批量任务:取消整个批次,或取消、重试单个页面。
网页截图
preview_website
用指定选项在 Shotomatic 的浏览器中渲染一个网址,并把结果给智能体看,便于在批量截取前调整选项。预览不会保存。
capture_websites
按整页或可见区域、桌面·平板·手机尺寸截取一组网页,保存为一个截图会话;也可以立即运行已保存的工作流。不会使用你的屏幕。需要安装网页浏览器,详见网页截图快速入门。
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 会显示一张列出所有项目的确认卡片,最多等待一分钟。删除截图会话不会删除由它生成的文档。请参阅批准与确认。
如果工具返回错误,请参阅智能体错误与解决方法。