Documentação para agentes

Para agentes de IA — Furos de Água Grândola e Comporta

Serviço, zonas, preços públicos, prazo e como pedir um orçamento. Versão em Markdown: /for-agents.md.

Última atualização: 2026-10-16 · Língua: pt-PT · Contacto: +351 912 338 777

O que fazemos

Nós fazemos furos de captação de água subterrânea no litoral alentejano: estudo do terreno, licenciamento na APA/ARH Alentejo, perfuração, bomba e manutenção, para moradias, jardins, hortas e piscinas. Orçamento gratuito e sem compromisso.

Onde

Zonas servidas: Grândola, Melides, Comporta, Carvalhal, Tróia, Santiago do Cacém. Páginas: /grandola/, /melides/, /comporta/, /carvalhal/, /troia/, /santiago-do-cacem/ e /moradias-jardim-piscina/ (moradia, jardim e piscina). Reconhecemos também estas localidades (lista não exaustiva): Melides (Grândola), Carvalhal (Grândola), Azinheira dos Barros (Grândola), Santa Margarida da Serra (Grândola), Tróia (Grândola), Soltróia (Grândola), Lagoa Formosa (Grândola), Pinheiro da Cruz (Grândola), Comporta (Alcácer do Sal (Comporta)), Carrasqueira (Alcácer do Sal (Comporta)), Brejos da Carregueira (Alcácer do Sal (Comporta)), Possanco (Alcácer do Sal (Comporta)), Vila Nova de Santo André (Santiago do Cacém), Santo André (Santiago do Cacém), Cercal do Alentejo (Santiago do Cacém).

Condição: terrenos em reserva natural, ZEC (Comporta/Galé), faixa da orla ou regadio público têm regras próprias; verificamos cada terreno antes de propor. Fora destas zonas: não fazemos.

Serviços

  • Novo furo de água (ou novo-furo)
  • Limpeza / manutenção de furo (ou limpeza)
  • Bomba / equipamento (ou bomba)
  • Licenciamento (ou licenciamento)
  • Outro (ou outro)

Preço (público)

O orçamento é gratuito. Referência nacional (não há tabela por localidade): 20–60 €/m perfurado; furo doméstico completo normalmente 4 000–8 000 €, em regra sem bomba. Valores indicativos. O preço real depende da profundidade e da geologia e confirmamo-lo nós no orçamento. Detalhe em /precos/.

Prazo

Respondemos a cada pedido em 24–48 h, por telefone ou email. O prazo do licenciamento depende da APA e não o prometemos.

O que precisamos de saber

Obrigatório: nome, telefone (português), email, localidade, tipo de serviço e consentimento. Recomendado: para que é a água, link do Google Maps com o pin do terreno e uma descrição curta.

Como pedir um orçamento

Opção 1 — API JSON (recomendada): POST https://furosdeaguagrandola.pt/api/orcamento, Content-Type: application/json. Especificação OpenAPI 3.1 em /openapi.json. Para testar sem enviar nada, junte o cabeçalho X-Dry-Run: 1 (ou "dry_run": true).

curl -X POST https://furosdeaguagrandola.pt/api/orcamento \
  -H "Content-Type: application/json" \
  -H "X-Dry-Run: 1" \
  -d '{"nome":"Ana Silva","telefone":"+351912345678","email":"ana@exemplo.pt","localidade":"Melides, Grândola","servico":"Novo furo de água","uso_agua":"Jardim ou horta","descricao":"Terreno rústico de 5 000 m²","consent":true,"submetido_por":"agente"}'

Resposta de um pedido aceite:

HTTP/2 201
{"id":"ORC-20261015-3F9A1C","estado":"recebido","prazo_resposta_horas":48,"mensagem":"Respondemos em 24–48 h por telefone ou email.","contacto":"+351 912 338 777"}

Campos: nome, telefone, email, localidade, servico, consent (obrigatórios); uso_agua, google_maps_pin, descricao, agente (opcionais). consent tem de ser o booleano true. submetido_por só aceita "agente". Valores de servico: Novo furo de água (ou novo-furo), Limpeza / manutenção de furo (ou limpeza), Bomba / equipamento (ou bomba), Licenciamento (ou licenciamento), Outro (ou outro). Valores de uso_agua: Casa (consumo doméstico) | Jardim ou horta | Rega agrícola (exploração) | Empresa ou indústria | Ainda não sei. Não aceitamos campos desconhecidos.

Opção 2 — servidor MCP remoto: https://furosdeaguagrandola.pt/mcp (Streamable HTTP, só POST, sem sessões). Suporta a revisão MCP 2026-07-28 (server/discover, tools/list, tools/call) e, por compatibilidade, as revisões 2025-11-25, 2025-06-18 e 2025-03-26 (com initialize). Ferramentas: pedir_orcamento, consultar_precos, zonas_servidas. Descoberta: /.well-known/ai-catalog.json → cartão do servidor em /mcp/server-card.

POST https://furosdeaguagrandola.pt/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/list

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}

Opção 3 — formulário web /orcamento/ (o formulário declara também a ferramenta WebMCP pedir_orcamento; o utilizador revê e envia). Pré-preencher a localidade: /orcamento/?localidade=Melides%2C%20Gr%C3%A2ndola. Pedido HTTP direto ao formulário (não aceita JSON):

POST https://furosdeaguagrandola.pt/obrigado/
Content-Type: application/x-www-form-urlencoded

form-name=pedido-orcamento-litoral
&nome=Ana Silva
&telefone=+351912345678
&email=ana@exemplo.pt
&localidade=Melides, Grândola
&servico=Novo furo de água
&uso_agua=Jardim ou horta
&google_maps_pin=https://maps.app.goo.gl/...
&descricao=Terreno rústico de 5 000 m²
&origem=agente
&submetido_por=agente
&consent=on
&bot-field=

Campos obrigatórios do formulário: nome, telefone, email, localidade, servico, uso_agua, google_maps_pin, consent. O campo bot-field tem de ficar vazio. Se escolher esta opção, indique origem=agente e submetido_por=agente. Num navegador pode usar ?submetido_por=agente no URL de /orcamento/.

Consentimento (RGPD)

Só envie o pedido depois de o utilizador confirmar que autoriza a Furos de Água a tratar os dados (nome, telefone, email e pedido) para preparar o orçamento e o contactar. Somos nós, a Furos de Água, os responsáveis pelo tratamento (+351 912 338 777); o utilizador pode aceder, retificar ou apagar os dados e retirar a autorização a qualquer momento por esse contacto. Política: /privacidade/. Não submeta pedidos sem esta confirmação.

Respostas e erros

  • 201 pedido recebido (devolve id e estado); 200 duplicado, dry-run ou pré-visualização.
  • 400 JSON inválido · 403 origem não permitida · 413 corpo > 8 KB · 415 não é JSON · 422 validação (lista de campos com mensagem) · 429 limite (cabeçalho Retry-After) · 503 limite diário · 502 falha ao registar.

Limites

  • Máximo de 3 pedidos reais por hora por origem e 40 por dia no total; testes dry-run: 60 por hora.
  • Corpo até 8 KB. Pedidos de navegadores só a partir deste site (cabeçalho Origin); clientes servidor-a-servidor não precisam de Origin.
  • Pedidos duplicados (mesmo telefone, email e localidade) em 24 h devolvem a mesma referência.
  • Não fazemos furos fora das zonas acima. Não aceitamos pedidos sem consentimento.

Ficheiros para máquinas

English summary

We drill water boreholes on the Alentejo coast (Grândola, Melides, Comporta, Carvalhal, Tróia and Santiago do Cacém). Free quote, reply within 24–48 h (the site and the phone line are in Portuguese). National reference prices: €20–60 per metre drilled; a complete domestic borehole usually €4 000–8 000, usually without the pump (indicative; there is no per-locality table). Request a quote with POST https://furosdeaguagrandola.pt/api/orcamento (JSON, see /openapi.json; add X-Dry-Run: 1 to test), through the MCP server https://furosdeaguagrandola.pt/mcp, or with the web form https://furosdeaguagrandola.pt/orcamento/. Only submit after the user has confirmed consent to the use of their data to prepare and send the quote and to contact them (controller: Furos de Água, +351 912 338 777).

📞 Ligar agoraOrçamento grátis