Caesar

Caesar

Caesar é o mecanismo de busca para IA, organizando os dados do mundo com uma API para busca na web e leitura de documentos completos.

Caesar é o mecanismo de busca para IA, organizando os dados do mundo. Use a API para buscar na web, ler fontes na íntegra e citar as fontes utilizadas. Cadastre-se no aplicativo Caesar para criar uma chave de API. Por tempo limitado, todas as contas recebem um crédito inicial de US$ 1.000.

Comece com um agente

Para agentes que suportam skills, instale a busca Caesar diretamente:

npx skills add caesar-data/skills --skill caesar-search

<Prompt description="Use Caesar to search, read the most relevant result, cite the source URL, and preserve doc_id and search_id." actions={["copy"]}> {Use Caesar para buscar por "postgres 17 logical replication failover". Leia o resultado mais relevante, cite a URL da fonte e preserve doc_id e search_id.}

Para agentes: use `/llms.txt` para descobrir documentos, acrescente `.md` a qualquer página para markdown e comece com `/agents/install` para configuração específica do cliente.

Chame a API diretamente

Isso funciona como escrito com curl e CAESAR_API_KEY:

curl -s https://alpha.api.trycaesar.com/v1/search \
  -H "Authorization: Bearer $CAESAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "postgres 17 logical replication failover", "max_results": 3}'

Cada resultado inclui um doc_id que você pode passar para /v1/document para ler a página na íntegra. Execute a primeira busca e leitura.

Busque, leia, cite

Obtenha documentos ranqueados da web. Leia o `doc_id` selecionado como markdown. Cite a URL da fonte retornada e capture os metadados.

Busque e leia em qualquer lugar

Verbo	Endpoint	O que faz
search	POST /v1/search	Recuperação ranqueada de documentos e passagens canônicos
read	POST /v1/document	Inspeciona um documento e recupera seu conteúdo (markdown de página completa com content.selection: "full_document")

As mesmas operações de busca e leitura aparecem em todas as superfícies: search/read na CLI e nos SDKs, web_search/web_fetch via MCP. Feedback está disponível via REST, CLI e SDKs quando você precisar.

Fontes citáveis

Os resultados de busca podem variar: URLs mudam, trechos envelhecem e a fonte que um agente viu pode não corresponder ao que um humano abre depois. Caesar retorna metadados de fonte que os agentes podem manter junto com sua resposta:

• doc_id — identificador determinístico para um documento canônico que pode ser reutilizado entre buscas e recrawls. Leia-o na íntegra a qualquer momento com /v1/document.
• passage_id — identificador para uma passagem específica na captura mais recente, com contexto de seção.
• search_id — identificador da própria busca, usado para atribuir feedback ao ranqueamento exato que produziu um resultado.
• capture_id e capture_time — exatamente qual captura do documento seu conteúdo veio (nos resultados de busca com response.verbosity: "full"; sempre disponível em /v1/document).

Isso significa que um agente pode buscar, ler a fonte selecionada e citar onde e quando o conteúdo foi capturado. Veja proveniência para o modelo de objeto completo.

Escolha uma superfície

Três endpoints, uma especificação OpenAPI e um playground interativo. Comece aqui para HTTP puro. Documentos canônicos, passagens, atualidade, ranqueamento e metadados de fonte. O uso da API é baseado em créditos. Novas contas recebem um crédito inicial de US$ 1.000 por tempo limitado. `pip install caesar-search` — clientes síncronos e assíncronos, modelos tipados, novas tentativas automáticas. `npm install caesar-search` — totalmente tipado, ESM e CJS, funciona em Node, Bun, Deno e runtimes de edge. `web_search` e `web_fetch` do subcaminho `caesar-search/ai`. `caesar-search` — busque e leia do shell, com um contrato `--json` criado para scripts e agentes. Endpoint MCP remoto em `/mcp` — ferramentas genéricas de busca na web, sem instalação local, um comando para conectar. Receitas para ferramentas de frameworks, chamada genérica de ferramentas e projetos do Agent Development Kit. Instale a skill de busca com `npx skills add`, ou use o instalador da API para o pacote completo.

Próximos passos

• Início rápido — cadastre-se, defina CAESAR_API_KEY e depois busque e leia com curl.
• Como a busca funciona — como o Caesar transforma páginas públicas em documentos e passagens citáveis.
• Preços — uso da API, créditos e o crédito inicial por tempo limitado.
• Autenticação — criação, armazenamento e envio de chaves de API.
• Guia de agentes — convenções para construir agentes no Caesar.