Documentación Lookup
Recupera la documentación actual y ejemplos de código para cualquier biblioteca usando la CLI de Context7.
Asegúrate de que la CLI esté actualizada antes de ejecutar los comandos:
npm install -g ctx7@latest
O ejecuta directamente sin instalar:
npx ctx7@latest <comando>
Flujo de trabajo
Proceso de dos pasos: resuelve el nombre de la biblioteca a un ID, luego consulta la documentación con ese ID.
# Paso 1: Resolver el ID de la biblioteca
ctx7 library <nombre> <consulta>
# Paso 2: Consultar documentación
ctx7 docs <libraryId> <consulta>
DEBES ejecutar ctx7 library primero para obtener un ID de biblioteca válido A MENOS QUE el usuario proporcione explícitamente un ID de biblioteca en el formato /org/proyecto o /org/proyecto/version.
IMPORTANTE: No ejecutes estos comandos más de 3 veces por pregunta. Si no puedes encontrar lo que necesitas después de 3 intentos, usa el mejor resultado que tengas.
Paso 1: Resolver una biblioteca
Resuelve un nombre de paquete/producto a un ID de biblioteca compatible con Context7 y devuelve las bibliotecas que coinciden.
ctx7 library react "Cómo limpiar useEffect con operaciones asíncronas"
ctx7 library nextjs "Cómo configurar app router con middleware"
ctx7 library prisma "Cómo definir relaciones uno-a-muchos con borrado en cascada"
Siempre pasa un argumento query — es obligatorio y afecta directamente la clasificación de resultados. Usa la intención del usuario para formar la consulta, lo que ayuda a desambiguar cuando varias bibliotecas comparten un nombre similar. No incluyas información sensible ni confidencial como claves API, contraseñas, credenciales, datos personales o código propietario en tu consulta.
Campos de resultado
Cada resultado incluye:
- ID de biblioteca — Identificador compatible con Context7 (formato:
/org/proyecto) - Nombre — Nombre de la biblioteca o paquete
- Descripción — Resumen breve
- Fragmentos de código — Número de ejemplos de código disponibles
- Reputación de la fuente — Indicador de autoridad (Alta, Media, Baja o Desconocida)
- Puntuación de referencia — Indicador de calidad (100 es la puntuación más alta)
- Versiones — Lista de versiones si están disponibles. Usa una de esas versiones si el usuario proporciona una versión en su consulta. El formato es
/org/proyecto/version.
Proceso de selección
- Analiza la consulta para entender qué biblioteca/paquete está buscando el usuario
- Selecciona la coincidencia más relevante según:
- Similitud del nombre con la consulta (se priorizan las coincidencias exactas)
- Relevancia de la descripción para la intención de la consulta
- Cobertura de documentación (prioriza bibliotecas con mayor cantidad de fragmentos de código)
- Reputación de la fuente (considera las bibliotecas con reputación Alta o Media como más autorizadas)
- Puntuación de referencia (cuanto más alta mejor, 100 es el máximo)
- Si existen varias coincidencias buenas, reconócelo pero continúa con la más relevante
- Si no existen buenas coincidencias, indícalo claramente y sugiere refinamientos de la consulta
- Para consultas ambiguas, solicita aclaración antes de continuar con una coincidencia estimada
IDs específicos de versión
Si el usuario menciona una versión específica, usa un ID de biblioteca con versión:
# General (última indexada)
ctx7 docs /vercel/next.js "Cómo configurar app router"
# Específica de versión
ctx7 docs /vercel/next.js/v14.3.0-canary.87 "Cómo configurar app router"
Las versiones disponibles se listan en la salida de ctx7 library. Usa la coincidencia más cercana a lo que el usuario especificó.
Paso 2: Consultar documentación
Recupera documentación actualizada y ejemplos de código para la biblioteca resuelta.
ctx7 docs /facebook/react "Cómo limpiar useEffect con operaciones asíncronas"
ctx7 docs /vercel/next.js "Cómo añadir middleware de autenticación al app router"
ctx7 docs /prisma/prisma "Cómo definir relaciones uno-a-muchos con borrado en cascada"
Cómo escribir buenas consultas
La consulta afecta directamente la calidad de los resultados. Sé específico e incluye detalles relevantes. No incluyas información sensible ni confidencial como claves API, contraseñas, credenciales, datos personales o código propietario en tu consulta.
| Calidad | Ejemplo |
|---|---|
| Buena | "Cómo configurar autenticación con JWT en Express.js" |
| Buena | "Función de limpieza de React useEffect con operaciones asíncronas" |
| Mala | "auth" |
| Mala | "hooks" |
Usa la pregunta completa del usuario como consulta cuando sea posible; las consultas vagas de una sola palabra devuelven resultados genéricos.
La salida contiene dos tipos de contenido: fragmentos de código (con título y bloques etiquetados por lenguaje) y fragmentos de información (explicaciones en prosa con contexto de ruta de navegación).
Autenticación
Funciona sin autenticación. Para límites de tasa más altos:
# Opción A: variable de entorno
export CONTEXT7_API_KEY=tu_clave
# Opción B: inicio de sesión OAuth
ctx7 login
Manejo de errores
Si un comando falla con un error de cuota ("Cuota mensual alcanzada" o "cuota excedida"):
- Informa al usuario que su cuota de Context7 está agotada
- Sugiere que se autentique para obtener límites más altos:
ctx7 login - Si no puede o elige no autenticarse, responde basándote en el conocimiento de entrenamiento e indica claramente que puede estar desactualizado
No recurras silenciosamente a los datos de entrenamiento — siempre informa al usuario por qué no se usó Context7.
Errores comunes
- Los IDs de biblioteca requieren un prefijo
/—/facebook/reactnofacebook/react - Siempre ejecuta
ctx7 libraryprimero —ctx7 docs react "hooks"fallará sin un ID válido - Usa consultas descriptivas, no palabras sueltas —
"Función de limpieza de React useEffect"no"hooks" - No incluyas información sensible (claves API, contraseñas, credenciales) en las consultas