Usa Notion dal tuo terminale con Notion CLI (beta)

In questo articolo di supporto

Impara le basi dell'utilizzo di Notion dalla riga di comando, incluso come configurarlo e le soluzioni comuni.

Notion CLI ntn è uno strumento che consente agli sviluppatori e agli agenti di programmazione di lavorare con Notion digitando comandi in un terminale. Puoi leggere e scrivere il contenuto di Notion e (se hai accesso) gestire i Workers dalla riga di comando.

Puoi anche visualizzare i Workers e leggere i log in Notion con la Modalità sviluppatore. Usa la CLI quando devi distribuire i Workers o modificarne il codice o la configurazione.

Questo articolo è una panoramica di alto livello. Per la configurazione tecnica, consulta la documentazione per sviluppatori.

Cosa sapere prima di iniziare

La CLI è progettata per sviluppatori e costruttori tecnici.
La CLI è disponibile su tutti i piani. Tuttavia, la distribuzione e la gestione dei Notion Workers richiedono un piano Business o un piano Enterprise.
Alcune funzionalità della Developer Platform che utilizzi tramite la CLI potrebbero richiedere piani specifici o l'attivazione da parte dell'amministratore.
Se qualcosa sembra non andare, assicurati prima di utilizzare l'ultima versione della CLI.
Se devi solo visualizzare un Worker, leggere i log, disattivarlo o eliminarlo, puoi farlo in Notion dopo aver attivato la Modalità sviluppatore.

Installa la CLI

La CLI funziona su Mac, Linux e Windows. Su ognuno di questi, puoi installarla con npm install -g ntn.

Per maggiori informazioni sull'installazione, consulta la documentazione per sviluppatori.

Se qualcosa non funziona

Inizia con questi controlli rapidi:

Aggiorna la CLI, poi riprova. La CLI è progettata per rimanere aggiornata e le versioni precedenti possono comportarsi in modo diverso.
Conferma di aver effettuato l'accesso all'account Notion corretto. Se hai più account o spazi di lavoro, esci e riaccedi.
Controlla prima il tuo accesso in Notion. Se non riesci ad aprire la pagina o il database in Notion, nemmeno la CLI sarà in grado di leggerli o modificarli.
Se stai provando a usare i comandi dei Workers, conferma che i Workers siano abilitati. L'accesso ai Workers può dipendere dal tuo piano e dal fatto che il proprietario dello spazio di lavoro li abbia attivati.
Sei ancora bloccato? Usa la documentazione per sviluppatori per l'errore esatto e la soluzione, poiché i passaggi possono essere diversi per ogni comando.

Domande frequenti

Ho bisogno della CLI per utilizzare Notion?

No. La CLI è opzionale e pensata per i flussi di lavoro degli sviluppatori.

La CLI funziona su dispositivi mobili?

No. Viene eseguita in un terminale su desktop.

Dove posso trovare l'elenco completo dei comandi?

Trova l'elenco completo dei comandi nella documentazione per sviluppatori .

La CLI funziona su Windows?

Sì. La CLI funziona allo stesso modo su Windows, Mac e Linux. I Workers che crei su una piattaforma vengono visualizzati allo stesso modo ovunque.

Posso gestire i Workers in Notion invece che con la CLI?

In parte. Puoi visualizzare i Workers, leggere i log, disattivare i Workers ed eliminare i Workers in Notion con Modalità sviluppatore. Usa la CLI per distribuire i Workers o modificarne il codice o la configurazione.