llms.txt — llms.txt – resumo do site para agentes de IA
llms-full.txt — llms-full.txt – todas as ferramentas publicadas com um resumo de uma linha
Autenticação
Envie sua chave de publicação como token Bearer em cada pedido. Salve a chave no servidor e nunca a exponha em código do lado do cliente.
Authorization: Bearer <PUBLISH_API_KEY>
Define PUBLISH_API_KEY no servidor. Se não estiver definida, a API devolve 503 em vez de aceitar escritas sem autenticação.
Limites de pedidos
Os limites aplicam-se por endereço IP e por âmbito de rota. Leitura e escrita usam baldes separados, por isso muitas leituras não esgotam a quota de escrita.
Endpoints de leitura: 120 / 60s
Endpoints de escrita: 60 / 60s
Cada resposta inclui RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Uma resposta 429 inclui também Retry-After.
Endpoints da API
Os exemplos abaixo usam $PUBLISH_API_KEY. Substitui o marcador de id da ferramenta pelo id devolvido pelo endpoint de criação.
POST/api/v1/tools/submit-url
Enviar URL
Envie apenas uma URL. O coletor busca os dados do site, traduz e publica a ficha. Análise gratuita sem intervenção manual.
Apenas URLs HTTP/HTTPS são aceitas. Uma resposta na fila significa que a URL foi aceita na fila do coletor.
{
"id": "submission_abc123",
"submissionId": "submission_abc123",
"status": "queued",
"duplicate": false,
"message": "URL submitted successfully. The collector will scrape and process it automatically."
}
Respostas de erro
Os erros são devolvidos em JSON com um código estável e uma mensagem legível.
Código de status
Código
Significado
400
VALIDATION_ERROR
O corpo da requisição ou os parâmetros de consulta são inválidos.
401
UNAUTHORIZED
O token Bearer está em falta ou está incorreto.
404
NOT_FOUND
A ferramenta pedida não existe.
422
LOCALES_INCOMPLETE
Faltam campos de idiomas obrigatórios, por isso a ferramenta não pode ser publicada.
429
RATE_LIMITED
O limite de pedidos foi excedido. Tente novamente após a janela de Retry-After (cerca de 60 s).
503
API_KEY_NOT_CONFIGURED
O servidor não tem PUBLISH_API_KEY configurado, por isso as escritas estão desativadas.