---
title: Busca pública com NLWeb
description: Consulte o site e a documentação da Siglata em linguagem natural, com resultados e fontes em JSON ou SSE.
sidebar:
  order: 8
---

O endpoint `https://www.siglata.com/ask` busca nas páginas públicas e na documentação da Siglata. Ele retorna páginas relevantes com título, descrição, idioma e URL da fonte. Não exige autenticação e não acessa arquivos de organizações.

## Consultar

```bash
curl https://www.siglata.com/ask \
  -H 'Content-Type: application/json' \
  -d '{"query":{"text":"Como funciona o piloto?","max_results":5},"prefer":{"mode":"list","response_format":"conv_search","streaming":false,"accept-language":"pt-BR"}}'
```

Também é possível usar `GET /ask?query=planilhas&streaming=false`. O parâmetro `lang=en-US` seleciona o conteúdo em inglês; o padrão é português. Em POST, use `prefer.accept-language`. O cabeçalho `Accept-Language` é usado quando não há preferência explícita.

Cada resultado inclui `grounding.source_urls` com a página que sustenta a resposta. A classificação usa busca textual com Orama sobre o conteúdo publicado. O modo `list` recupera páginas; não gera respostas com um modelo de linguagem nem executa ações.

## Respostas e limites

- JSON: `prefer.streaming: false` ou cabeçalho `Accept: application/json`.
- SSE: `prefer.streaming: true`; a resposta contém um evento `data:` com os resultados e encerra a conexão. SSE é o padrão quando não há preferência por JSON.
- Até 1.000 caracteres na consulta, 8 KiB no corpo e 20 resultados; o padrão é 5.
- Consultas sem correspondências retornam `results: []`.
- Requisição inválida: 400; método incompatível: 405; corpo grande: 413; tipo de conteúdo incorreto: 415; busca indisponível: 503.

Esta implementação usa o perfil `list` / `conv_search` dos [modelos NLWeb 0.54](https://github.com/nlweb-ai/nlweb-ask-agent/blob/main/ask_api/packages/core/nlweb_core/protocol/models.py). Modos de resumo, histórico de conversa, memória persistente, busca em outros sites e formatos diferentes não são suportados. Campos de POST fora do perfil documentado são rejeitados.

## Descoberta

- [Descrição OpenAPI do NLWeb](https://www.siglata.com/nlweb/openapi.json)
- [Catálogo público em Schema.org DataFeed](https://www.siglata.com/nlweb.json)
- [Mapa dos feeds estruturados](https://www.siglata.com/schemamap.xml)
- [Páginas públicas em JSON Lines](https://www.siglata.com/nlweb/feed.jsonl)
- [Índice para agentes](https://www.siglata.com/llms.txt)

O mapa segue a proposta [Schema Feeds 0.1](https://github.com/nlweb-ai/website/blob/main/SCHEMA_SPEC.md), anunciada em `robots.txt`. Cada linha do feed contém uma página em JSON-LD, com idioma, texto e URL da fonte. Os dois formatos são gerados das mesmas páginas públicas a cada publicação do site.

A documentação também oferece WebMCP para agentes no navegador. O [MCP de organizações](/docs/agents/mcp) em `/v1/mcp` é uma interface separada: exige OAuth e mantém os escopos de acesso aos arquivos.