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à
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.
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 <namespace>/<app_name> 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.
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
App sincrone e asincrone
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 consearch_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
pricingedexamples, prova con un volume di dati piccolo e gestisci l’handoffquando 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.