llms.txt — llms.txt: resumen del sitio para agentes de IA
llms-full.txt — llms-full.txt: todas las herramientas publicadas con un resumen de una línea
Autenticación
Envía tu clave de publicación como token Bearer en cada petición. Guarda la clave en tu servidor y nunca la expongas en código del lado del cliente.
Authorization: Bearer <PUBLISH_API_KEY>
Configura PUBLISH_API_KEY en el servidor. Si no está configurada, la API devuelve 503 en lugar de aceptar escrituras sin autenticar.
Límites de uso
Los límites se aplican por dirección IP y por ámbito de ruta. Lectura y escritura usan cubetas separadas, así que muchas lecturas no agotan el cupo de escritura.
Endpoints de lectura: 120 / 60s
Endpoints de escritura: 60 / 60s
Cada respuesta incluye RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Una respuesta 429 también incluye Retry-After.
Rutas de API
Los ejemplos siguientes usan $PUBLISH_API_KEY. Sustituye el marcador de id de herramienta por el id que devuelve el endpoint de creación.
POST/api/v1/tools/submit-url
Enviar URL
Envía solo una URL. El sistema de recopilación obtendrá los datos del sitio, los traducirá y publicará. Revisión gratuita sin intervención manual.
Solo se admiten URL HTTP/HTTPS. Una respuesta en cola significa que la URL se aceptó en la cola de recopilación.
{
"id": "submission_abc123",
"submissionId": "submission_abc123",
"status": "queued",
"duplicate": false,
"message": "URL submitted successfully. The collector will scrape and process it automatically."
}
Respuestas de error
Los errores se devuelven en JSON con un código estable y un mensaje legible.
Estado
Código
Significado
400
VALIDATION_ERROR
El cuerpo de la petición o los parámetros de consulta no son válidos.
401
UNAUTHORIZED
Falta el token Bearer o es incorrecto.
404
NOT_FOUND
La herramienta solicitada no existe.
422
LOCALES_INCOMPLETE
Faltan campos de idiomas obligatorios, así que la herramienta no puede publicarse.
429
RATE_LIMITED
Se superó el límite de uso. Reinténtalo tras la ventana de Retry-After (unos 60 s).
503
API_KEY_NOT_CONFIGURED
El servidor no tiene PUBLISH_API_KEY configurado, así que las escrituras están desactivadas.