> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Riferimento degli strumenti MCP di Data Hub > I sei strumenti dell'MCP generale di Data Hub e il flusso standard per cercare, eseguire e recuperare i risultati di una Data App. Questa pagina descrive l'**MCP generale di Data Hub**. Aiuta prima un agente a scoprire una Data App adatta, poi legge il contratto aggiornato dell'app e la esegue. Usa le stesse capacità di Data Hub dei tutorial «scegli prima un'app specifica, poi collega». L'unica differenza è quando viene scelta l'app. Numero, nomi, editori, prezzi, input e output delle Data App cambiano continuamente. Gli strumenti del protocollo MCP sono relativamente stabili. Questa pagina si concentra quindi sui contratti degli strumenti e sul flusso generale, e non tratta alcuna istantanea del catalogo come un elenco duraturo. ## Due livelli di capacità | Livello | Contenuto | Come usarlo | | ---------------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | **Livello protocollo** | Sei strumenti: cercare, ottenere dettagli, eseguire, ottenere stato, ottenere risultato e annullare l'esecuzione | Un flusso stabile per l'integrazione da parte di agenti o sistemi | | **Livello dati** | Capacità, prezzo, campi, visibilità e modalità di esecuzione di ogni Data App | Cercare e leggere i dettagli aggiornati prima di ogni chiamata | Per un'integrazione a lungo termine con un'app fissa, annota il suo `app_id`. Anche `namespace/app_name` fa riferimento a un'app, ma può smettere di funzionare se l'editore o l'app vengono rinominati. ## I sei strumenti MCP ### `search_data_apps`: cercare nel catalogo Scopri le Data App con parole chiave aziendali. `query` accetta parole chiave in qualsiasi lingua. Lascialo vuoto per scorrere il catalogo visibile a te. Puoi anche filtrare con `type` per app di raccolta o consultazione (`data`) e di elaborazione (`transform`), e con `scope` per `all`, `public`, `private` o `shared`. | Parametro | Descrizione | | ----------------- | ---------------------------------------------------------------- | | `query` | Parole chiave aziendali facoltative. Elenca il catalogo se vuoto | | `type` | Facoltativo: `data` o `transform` | | `scope` | Ambito di visibilità facoltativo, predefinito `all` | | `offset`, `limit` | Paginazione. `limit` va da `1-20`, predefinito `5` | Ogni scheda di risultato include `app_id`, nome, riepilogo, modalità di esecuzione (`sync` / `async`), indicazioni di input e output, prezzo di partenza e visibilità. Cerca e confronta prima. Non eseguire prima di confermare. ### `get_data_app_details`: leggere il contratto completo Richiama questo strumento prima di eseguire. Passa un `app_id` o `/` per ottenere: * `input_schema`: il JSON Schema standard che questa esecuzione deve rispettare. * `output_schema`: i campi che possono essere restituiti. * `knowledge`: limiti della capacità, latenza attesa e avvertenze. * `pricing`: descrizione della fatturazione. * `examples`: input di esempio da usare come punto di partenza. L'approccio più sicuro è copiare un `input` da `examples` e adattarlo. Non indovinare i nomi dei campi dal titolo della pagina, dalle descrizioni della chat o da vecchie attività. ### `run_data_app`: avviare un'esecuzione Passa `app`, un `input` conforme all'`input_schema` e, se necessario, `max_records` per limitare il numero di risultati. Se l'input non corrisponde al contratto, lo strumento restituisce subito `[invalid-input]` e segnala il campo problematico. I valori di ritorno comuni includono `run_id`, `state`, `progress`, `usage`, `billing` e `next_step`. Usa un `max_records` piccolo al primo tentativo per confermare dati, durata e costo. ### `get_run_status`: controllare lo stato dell'esecuzione Passa un `run_id` per controllare avanzamento, dettagli dell'errore, utilizzo e costo, senza leggere i dati. Per le attività asincrone, usa `wait_seconds` (`0-60`) per il long polling. Attendi 60 secondi per chiamata invece di interrogare rapidamente senza pause. Gli stati comuni sono `QUEUED`, `RUNNING`, `SUCCEEDED`, `PARTIALLY_SUCCEEDED`, `FAILED` e `CANCELLED`. In caso di errore, guarda `error.code`, `error.category`, `error.message` ed `error.retryable`. ### `get_run_result`: leggere i risultati Legge al massimo 50 record per chiamata. Pagina con `offset` e usa `fields` per richiedere un sottoinsieme di campi separati da virgola, come `title,price,url`, così i campi grandi non necessari non inondano la conversazione. Quando la risposta contiene un `handoff`, il risultato è grande o non adatto a ulteriore paginazione nella conversazione. Segui il comando SDK o REST nell'`handoff` per esportare un file invece di far spostare all'agente il JSON completo ripetutamente. ### `cancel_run`: annullare un'esecuzione Passa un `run_id` per annullare un'attività in coda o in esecuzione. Un'attività in esecuzione può richiedere qualche secondo per fermarsi in modo cooperativo. I risultati parziali già prodotti vengono conservati e possono ancora essere letti con `get_run_result`. Vengono fatturati solo i dati prodotti. ## Flusso di lavoro standard ```text theme={null} theme={null} search_data_apps → get_data_app_details → run_data_app → get_run_status (solo async, long polling) → get_run_result → cancel_run (quando devi fermarti) ``` ### App sincrone e asincrone | Modalità di esecuzione | Comportamento | Raccomandazione | | ---------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | `sync` | Si completa in pochi secondi. I risultati piccoli possono restituire `records` direttamente | Controlla prima il ritorno, poi prosegui con `next_step` | | `async` | Restituisce subito un `run_id` ed esegue l'estrazione reale in background | Invia più target in sequenza, poi attendi con `get_run_status(wait_seconds=60)` | Ricevere un `run_id` per un'attività asincrona non significa che l'estrazione sia riuscita. Conferma lo stato finale prima di leggere i risultati e non inviare di nuovo lo stesso target a causa dell'attesa. ## Come lavorare con le Data App Le Data App sono le capacità dati concrete su Data Hub. Ne arrivano di nuove e quelle esistenti cambiano, perciò questa pagina non tiene alcun elenco fisso. Prima dell'uso, cerca con `search_data_apps` e conferma input, output, prezzo e limiti attuali con `get_data_app_details`. ## Consigli su connessione e utilizzo * **App non ancora scelta**: segui Connessione generale: scegliere un'app dentro l'agente per collegare prima l'MCP di Data Hub, poi cercare, confrontare e confermare. * **App fissa usata nel lungo periodo**: usa Codex: collegare un'app specifica o Claude Code: collegare un'app specifica per restringere l'ambito degli strumenti. * **Costi o grandi volumi di dati coinvolti**: richiama prima lo strumento dei dettagli per controllare `pricing` ed `examples`, prova con un volume di dati piccolo e gestisci l'`handoff` quando ti serve un risultato grande. L'MCP generale di Data Hub si basa su `https://mcp-v2.octoparse.com` e supporta chiave API o OAuth. La configurazione di connessione e i parametri attuali sono quelli generati dalla Data Hub Open Platform. È diverso dal server MCP di scraping Octoparse nella navigazione in alto. Non mescolare i loro indirizzi, l'autenticazione o i nomi degli strumenti.