Riferimento degli strumenti
Tutti gli strumenti MCP che Shotomatic offre agli agenti IA: che cosa fa ciascuno, quali chiedono prima conferma e quali parti richiedono Pro.
Aggiornato il 16 novembre 2026
In questa pagina
Questa pagina elenca gli strumenti MCP che Shotomatic 1.10.1 offre a un agente approvato. Gli agenti leggono lo stesso elenco, con gli schemi di input completi, quando si collegano. Non sei tu a chiamare questi strumenti, ma conoscerli ti aiuta a formulare le richieste e a capire che cosa riferisce un agente.
Quale strumento per quale lavoro
| Vuoi che l'agente… | Strumenti usati |
|---|---|
| controlli autorizzazioni, piano e lavori in corso | get_status |
| veda che cosa c'è sullo schermo | list_capture_sources, capture_snapshot, capture_window_snapshot |
| acquisisca una finestra più volte, premendo un tasto | start_auto_capture, get_job, control_job |
| registri una guida clic per clic | start_action_capture, get_job, control_job |
| acquisisca pagine web | preview_website, capture_websites, get_job, control_job |
| riusi o pianifichi le impostazioni per i siti | website_capture_options, website_workflows |
| trovi e guardi acquisizioni passate | list_capture_sessions, get_capture_session, view_images |
| crei e modifichi un documento | list_documents, get_document, create_document, add_pages, edit_document |
| produca i file | export, get_job |
| faccia ordine | delete_items, rename_capture_session |
| cambi le impostazioni di acquisizione ed esportazione | update_settings |
I lavori lunghi restituiscono subito un ID. L'agente segue il lavoro con get_job, che attende fino a 50 secondi per chiamata, così un'acquisizione lunga continua in Shotomatic tra una chiamata e l'altra.
Stato e sorgenti
get_status
Riporta la versione dell'app, se Registrazione schermo e Accessibilità sono concesse, il tuo piano e gli screenshot gratuiti ancora disponibili oggi, i limiti delle funzioni, i lavori in corso, se il browser per i siti web è installato e le impostazioni attuali. Gli agenti lo chiamano per primo e di nuovo dopo che hai risolto qualcosa.
list_capture_sources
Elenca le finestre e gli schermi che Shotomatic può acquisire, con ID, nomi e nomi delle app.
capture_snapshot
Fa un'anteprima di una finestra o di uno schermo per verificare che sia aperta la pagina giusta. L'anteprima è un JPEG più piccolo, non viene salvata nella Cronologia acquisizioni e non usa gli screenshot gratuiti.
capture_window_snapshot
Fa un'istantanea PNG di una finestra e la restituisce all'agente. Come capture_snapshot, non viene salvata.
Acquisizioni e lavori
start_auto_capture
Acquisisce una finestra a intervalli fissi e può premere un tasto dopo ogni screenshot, per esempio la freccia destra per voltare pagina. Shotomatic porta la finestra in primo piano e non preme mai un tasto se un'altra finestra è in primo piano o lo schermo è bloccato: in quel caso il lavoro va in pausa. Con la pressione di un tasto, si ferma da sola quando la pagina smette di cambiare. Le condizioni di arresto dipendono dal tuo piano; vedi Condizioni di arresto, intervalli e pressioni dei tasti.
start_action_capture
Avvia un'Acquisizione da azioni: ogni clic nella finestra scelta salva un passaggio e, quando l'acquisizione si ferma, viene creato un documento. Shotomatic non fa clic: i clic li fai tu, oppure li fa un agente con una propria capacità di controllo del computer.
get_job
Controlla un'acquisizione, un batch di siti o un'esportazione avviati prima e può attenderne l'avanzamento.
control_job
Gestisce un lavoro in corso. Acquisizione automatica: pausa, ripresa o arresto, mantenendo gli screenshot già fatti. Acquisizione da azioni: arresto con creazione del documento, oppure salvataggio di un passaggio senza clic. Batch di siti: annullamento del batch, oppure annullamento o nuovo tentativo di una singola pagina.
Acquisizione siti web
preview_website
Mostra un URL con le opzioni indicate nel browser di Shotomatic e fa vedere il risultato all'agente, così può regolare le opzioni prima di un batch. L'anteprima non viene salvata.
capture_websites
Acquisisce un elenco di pagine web, a pagina intera o solo l'area visibile, in formato desktop, tablet o mobile, in un'unica sessione di acquisizione, oppure esegue subito un flusso di lavoro salvato. Lo schermo non viene usato. Serve il browser per i siti web; vedi Guida rapida: Acquisizione siti web.
website_capture_options
Elenca, legge o salva le opzioni salvate di Acquisizione siti web. Gli agenti non possono eliminare le opzioni salvate.
website_workflows
Elenca, legge, salva, mette in pausa o riprende i flussi di lavoro. Una pianificazione è un intervallo di almeno 5 minuti oppure un orario giornaliero. Il salvataggio di un flusso con pianificazione e la ripresa attendono la tua conferma, la pausa no. Le esecuzioni pianificate avvengono solo mentre Shotomatic è aperto, e quelle perse mentre era chiuso non vengono recuperate. Gli agenti non possono eliminare i flussi di lavoro.
Cronologia acquisizioni
list_capture_sessions
Elenca le sessioni di acquisizione, dalla più recente, con il numero di fotogrammi e il documento creato da ciascuna sessione, se esiste.
get_capture_session
Legge una sessione: riepilogo, percorsi dei file dei fotogrammi a gruppi di massimo 200 e, per Acquisizione siti web, ogni pagina con il suo stato.
rename_capture_session
Rinomina una sessione così come appare in Shotomatic.
view_images
Mostra all'agente fotogrammi della Cronologia acquisizioni o pagine di documenti come immagini, fino a 6 per chiamata e 8 MB in totale. Una pagina di documento appare senza ritaglio né annotazioni. Le immagini che un agente guarda entrano nella sua conversazione.
Documenti
list_documents
Elenca i documenti, dal più recente modificato.
get_document
Legge un documento: titolo, revisione, pagine con testo, inquadratura e annotazioni.
create_document
Crea un documento da fotogrammi di una sessione di acquisizione, da file immagine o da una pagina vuota. Se scegli un'intera sessione che ha già un documento, restituisce quel documento invece di una copia.
add_pages
Aggiunge pagine da fotogrammi di una sessione di acquisizione o da file immagine, alla fine o dopo una pagina indicata.
edit_document
Modifica un documento in un solo passaggio: titolo, titoli e descrizioni delle pagine, inquadratura, annotazioni, ordine delle pagine, duplicazione o eliminazione di pagine e filigrana. Se una parte non riesce, non cambia nulla. Sfocatura, evidenziatore, indicatore di clic e filigrana richiedono Pro. Se il documento è aperto nell'editor, l'editor lo ricarica.
Esportazione e impostazioni
export
Esporta un documento come PDF, PNG, JPG, WebP o ZIP, oppure i fotogrammi di una sessione di acquisizione come ZIP, PNG, JPG, PDF ricercabile o MP4. I file vanno nella cartella di esportazione con nomi nuovi, i file esistenti non vengono mai sovrascritti e sullo schermo non si apre nulla.
update_settings
Modifica Esportazione automatica (attiva o disattiva, PNG o JPG), la qualità JPG e quante sessioni conserva la Cronologia acquisizioni. Un limite più basso che eliminerebbe sessioni chiede prima a te. Cartella di esportazione, lingua, preset e licenza non si possono modificare.
Eliminazione
delete_items
Elimina fino a 50 documenti o sessioni di acquisizione in una sola richiesta. Shotomatic mostra una conferma che elenca ogni elemento e attende la tua risposta fino a un minuto. Eliminare una sessione di acquisizione non elimina mai i documenti creati da essa. Vedi Approvazioni e conferme.
Se uno strumento restituisce un errore, vedi Errori degli agenti e soluzioni.