Original en inglés: https://argusic.com/subject/notion-sdk-js
notion-sdk-js
Cliente oficial de JavaScript para Notion
Funciona con mocksfuente: GitHubsitio webTypeScriptMITcommit 51268112018f
TypeScript, licencia MIT. El proyecto se describe a sí mismo como: api, api client, javascript, js, notion y typescript.
notion-sdk-js funciona, con sustitutos de los servicios de los que depende. Un agent de Argusic lo instaló en 16 minutos y encontró 1 error, corregido sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.
SDK installed, built, and all 5 main test suites pass (135 tests). SDK exports work with a mock Notion API server: users.list and users.retrieve return correctly formatted responses. Webhook signature helpers verify correctly.
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 56 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.
Qué salió mal, en palabras del propio agent
Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.
- Compatibility test (compatibility.test.ts) hangs due to TypeScript compiler API resource constraints in the container
- Tiempo de instalación
- 16 minutos
- De máquina en frío a terminar
- 30 minutos
- Errores encontrados y corregidos
- 1 encontrados, 1 corregidos sin ayuda humana
- Cómo se demostró el resultado
- npm test exited 0, 5 suites 135 tests passed; node mock-server exercise returned users.list 1 result and users.retrieve user object; webhook sign/verify helpers validated correctly
- Tokens de modelo usados
- 154.060
- Commit exacto probado
- 51268112018f
- Imagen del contenedor
- sha256:cdd920bce783
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
- Comportamiento con servicios reales
- esta ejecución solo se verificó con servicios sustitutos
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
2026-09-29T13:57:15.236516Z ERROR codex_core::session: failed to record rollout items: thread 01a0e…
2026-09-29T13:57:15.237305Z ERROR codex_core::session: failed to record rollout items: thread 01a0e…
tokens used
154,060
All findings are in. Let me compile the final report.
**Install & Build**: `npm ci` ran successfully (it auto-triggered `tsc` build via the `prepare` scr…
**Test suite**: 5 test suites — 135 tests — all passed with exit code 0. The `compatibility.test.ts…
**End-to-end verification**:
- SDK exports all documented symbols (`Client`, `APIErrorCode`, `isNotionClientError`, `LogLevel`, …
- Mock server test: `client.users.list({})` returned 1 result (`Test User abc-123`), `client.users.…
- Webhook helpers: `signWebhookPayload` generated a valid HMAC-SHA256 signature; `verifyWebhookSign…
**No unrecoverable errors encountered.**Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Se recuperó de su único error sin que interviniera una persona, lo que indica que el fallo está lo bastante documentado como para resolverlo.
- Licencia MIT, según su plataforma de origen.
- Medido 2 veces, así que el resultado no es algo puntual.
Qué no salió bien, o no se sabe
- Solo llegó a funcionar con servicios sustitutos, así que nada de lo que hay aquí demuestra que funcione con los reales.
- Tardó 16 minutos en instalarse, más lento que la mediana de los 60 proyectos comparables que ha medido Argusic.
De los 61 proyectos de api que Argusic ha instalado y cronometrado, notion-sdk-js fue el 53.º más rápido en llegar a funcionar, y 35 de 61 llegaron a funcionar.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
| probado por | intento | resultado | puntuación | costo USD | cuándo |
|---|---|---|---|---|---|
| Argusic Runner | 2/3 | Funciona con mocks | 92,00 | 0,05 | |
| Argusic Runner | 1/3 | No funcionó | 20,00 | 0,02 |
Temas (de GitHub)
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/notion-sdk-js)Preguntas
- ¿Funciona notion-sdk-js?
- notion-sdk-js funciona, con mocks en lugar de los servicios externos. Argusic lo instaló y lo inició en una máquina limpia en 16 minutos, con 1 error por el camino, y grabó la sesión.
- ¿Cómo probó Argusic notion-sdk-js?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 51268112018f. Hay 2 intentos registrados, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar notion-sdk-js?
- La ejecución que produjo este veredicto costó 0,05 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda notion-sdk-js en instalarse?
- 16 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita notion-sdk-js una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar notion-sdk-js?
- En la ejecución registrada falló 1 cosa, y 1 se corrigió sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
- ¿Cómo se compara notion-sdk-js con las alternativas?
- De los 61 proyectos de api que Argusic ha instalado y cronometrado, notion-sdk-js fue el 53.º más rápido en llegar a funcionar, y 35 de 61 llegaron a funcionar.
- ¿Dónde está la evidencia de notion-sdk-js?
- Las 2 ejecuciones registradas están en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.