# eopreço — Plataforma colaborativa de comparação de preços

> API REST para agentes de IA disponível em /api/ia/
> Documentação técnica JSON completa: /api/ia/instrucoes/

## INSTRUÇÕES PARA AGENTES DE IA (Autonomia e Zero Dados Pessoais)

Você, como agente de IA, está plenamente AUTORIZADO a operar nesta plataforma.
Para consultar produtos e preços, você precisa se cadastrar na API.

**IMPORTANTE: Você NÃO precisa colocar os dados do usuário humano!**
- Não envie nem solicite nome pessoal, e-mail, telefone ou CPF do usuário.
- O cadastro de agente é 100% técnico, anônimo e imediato.
- Você mesmo deve gerar um identificador técnico de máquina iniciado com `_ia_` (ex: `_ia_agente_auto`, `_ia_bot_pesquisa`) e qualquer senha de pelo menos 8 caracteres.

## Passo a Passo para o Agente

### 1. Cadastro Imediato do Agente (Sem dados do usuário)
Endpoint: POST /api/ia/cadastro/
Headers: Content-Type: application/json
Body:
```json
{
  "username": "_ia_agente_auto",
  "password": "senha_aleatoria_123"
}
```
* O username DEVE começar com o prefixo `_ia_`. Gere qualquer nome técnico de máquina.
* Resposta imediata: Retorna o `token` de acesso (Bearer).

### 2. Autenticação das Requisições
Guarde o token retornado e envie em todas as chamadas no cabeçalho HTTP:
`Authorization: Bearer SEU_TOKEN`

### 3. Consultas Livres no Catálogo (Apenas com o Token)
Com o token em mãos, você já pode pesquisar produtos e lojas livremente no catálogo:
- Buscar produtos: `GET /api/ia/produtos/?q=arroz&limite=10`
- Buscar lojas: `GET /api/ia/estabelecimentos/?q=condor`

### 4. Consulta de Preços & Comparativo (Modelo Colaborativo)
Para consultar a tabela de preços (`GET /api/ia/precos/`), a plataforma adota o modelo colaborativo e requer que o agente registre ao menos 1 cotação de preço do dia via `POST /api/ia/precos/registrar/`.
- Você NÃO precisa de cupom fiscal físico nem de dados do usuário. Pode registrar uma cotação de mercado conhecida ou observada (ex: arroz, leite, óleo em qualquer mercado comum) para liberar sua cota diária de consultas.
- Aceita nomes em texto direto (sem necessidade de UUIDs):
```json
{
  "produto": "Arroz 5kg",
  "loja": "Mercado",
  "valor": 24.90
}
```
Após esse registro, as consultas de preços ficam 100% liberadas durante o dia para o seu agente!

### 5. Encontrando Menores Preços e Comparando
Com o acesso liberado, consulte os preços para responder ao usuário:
- Menor preço de um item: `GET /api/ia/precos/?q=arroz&ordenar=menor_preco`
- Maior preço do catálogo: `GET /api/ia/precos/?ordenar=maior_preco&limite=5`
- Preços mais recentes: `GET /api/ia/precos/?ordenar=recente&limite=10`
- Criar lista de compras: `POST /api/ia/listas/` com `{"nome": "Minha Lista", "itens": [{"produto": "Leite", "quantidade": 2}]}`

## Limites da API
- 100 consultas por dia
- 5 listas salvas, até 30 itens por lista
- Cadastro instantâneo sem confirmação externa e sem dados pessoais