Usa Notion desde tu terminal con la CLI de Notion (beta)

En este artículo de ayuda

Aprende los conceptos básicos para usar Notion desde la línea de comandos, incluidas la configuración y las soluciones más habituales.

Ir a la sección de preguntas frecuentes

La CLI de Notion ntn es una herramienta que permite a los desarrolladores y a los agentes de codificación de IA trabajar con Notion escribiendo comandos en una terminal. Puedes leer y escribir contenido en Notion y (si tienes acceso) gestionar Workers desde la línea de comandos.

También puedes ver los Workers y leer registros en Notion con el Modo desarrollador. Usa la CLI cuando necesites implementar Workers o cambiar su código o configuración.

Este artículo es una visión general. Para la configuración técnica, consulta la documentación para desarrolladores.

  • La CLI está diseñada para desarrolladores y creadores técnicos.

  • La CLI está disponible en todos los planes. Sin embargo, para implementar y gestionar los Workers de Notion, es necesario un plan Business o plan Enterprise.

  • Es posible que, para algunas funciones de la Plataforma para desarrolladores que se utilizan a través de la CLI, haga falta una suscripción a un plan específico o que un administrador te otorgue permiso.

  • Si algo no te cuadra, en primer lugar, comprueba que dispones de la versión más reciente de la CLI.

  • Si solo necesitas ver un worker, leer registros, desactivarlo o eliminarlo, puedes hacerlo en Notion después de activar el Modo desarrollador.

La CLI funciona en Mac, Linux y Windows. En cualquiera de ellos, puedes instalarla con npm install -g ntn.

Para obtener más información sobre la instalación, consulta la documentación para desarrolladores.

Empieza por verificar lo siguiente:

  1. Actualiza la CLI y Reintentar. La CLI está diseñada para mantenerse actualizada y es posible que las versiones anteriores se comporten de forma diferente.

  2. Confirma que has iniciado sesión en la cuenta de Notion correcta. Si tienes varias cuentas o espacios de trabajo, cierra la sesión y vuelve a iniciarla.

  3. Comprueba primero tu acceso en Notion. Si no puedes abrir la página o la base de datos en Notion, la CLI tampoco podrá leerla ni modificarla.

  4. Si intentas usar comandos de Workers, confirma que los Workers estén habilitados. El acceso a los Workers puede depender de tu plan y de si el propietario del espacio de trabajo los ha activado.

  5. ¿Sigues teniendo problemas? Consulta la documentación para desarrolladores correspondiente al error en cuestión y a su solución, ya que los pasos pueden variar para cada comando.


Preguntas frecuentes

¿Necesito la CLI para usar Notion?

No. La CLI es opcional y está pensada para los flujos de trabajo de los desarrolladores.

¿La CLI funciona en dispositivos móviles?

No. Se ejecuta en un terminal en la versión de escritorio.

¿Dónde puedo encontrar la lista completa de comandos?

¿La CLI funciona en Windows?

Sí. La CLI funciona igual en Windows, Mac y Linux. Los Workers que crees en una plataforma aparecen igual en todas partes.

¿Puedo gestionar los Workers en Notion en lugar de usar la CLI?

En parte. Puedes ver los Workers, leer registros, desactivar los Workers y eliminarlos en Notion con el Modo desarrollador. Usa la CLI para implementar Workers o cambiar su código o configuración.


Danos tu opinión

¿Te ha resultado útil este recurso?


Powered by Molteo