Documentação para agentes

Para agentes de IA — Furos de Água Algarve

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-15 · Língua: pt-PT (en em /en/) · Contacto: +351 912 338 777

O que fazemos

Nós fazemos furos de captação de água subterrânea no Algarve e em Monchique: estudo do terreno, licenciamento, perfuração, entubamento, bomba e manutenção. Orçamento gratuito e sem compromisso.

Onde

Concelhos servidos: Aljezur, Vila do Bispo, Lagos, Monchique, Portimão, Silves, Lagoa, Albufeira, Loulé, Faro. Reconhecemos também estas localidades (lista não exaustiva): Alferce (Monchique), Marmelete (Monchique), Alvor (Portimão), Mexilhoeira Grande (Portimão), Odiáxere (Lagos), Bensafrim (Lagos), Luz (Lagos), Algoz (Silves), Tunes (Silves), Armação de Pêra (Silves), Alcantarilha (Silves), Pêra (Silves), São Bartolomeu de Messines (Silves), Estômbar (Lagoa), Carvoeiro (Lagoa), Ferragudo (Lagoa), Parchal (Lagoa), Guia (Albufeira), Paderne (Albufeira), Ferreiras (Albufeira), Almancil (Loulé), Quarteira (Loulé), Boliqueime (Loulé), Salir (Loulé), Querença (Loulé), Sagres (Vila do Bispo), Budens (Vila do Bispo), Raposeira (Vila do Bispo), Salema (Vila do Bispo), Odeceixe (Aljezur), Rogil (Aljezur), Estoi (Faro).

Zonas excluídas: Campina de Faro – Vale de Lobo e a faixa costeira crítica (zonas com licenciamento restrito da ARH Algarve). Fora destas zonas: não fazemos.

Serviços

Novo furo de água (ou novo-furo)
Furo artesiano (ou furo-artesiano)
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 no Algarve: 35–80 €/m perfurado (média nacional 20–60 €/m); furo doméstico completo (perfuração, entubamento, bomba, instalação e licenciamento) normalmente 3 000–10 000 €. Valores indicativos, sem IVA. 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. Os pedidos feitos pela API ou pelo MCP têm o objetivo de resposta em 24 h.

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://furosdeaguaalgarve.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://furosdeaguaalgarve.pt/api/orcamento \
  -H "Content-Type: application/json" \
  -H "X-Dry-Run: 1" \
  -d '{"nome":"Ana Silva","telefone":"+351912345678","email":"ana@exemplo.pt","localidade":"Monchique","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":24,"mensagem":"Respondemos em 24 h (no máximo 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), Furo artesiano (ou furo-artesiano), 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://furosdeaguaalgarve.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://furosdeaguaalgarve.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 (os formulários declaram também a ferramenta WebMCP pedir_orcamento; o utilizador revê e envia). Pedido HTTP direto ao formulário (não aceita JSON):

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

form-name=pedido-orcamento
&nome=Ana Silva
&telefone=+351912345678
&email=ana@exemplo.pt
&localidade=Monchique
&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 Algarve, 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

/llms.txt · /for-agents.md · /openapi.json · /sitemap.xml · /robots.txt
/.well-known/api-catalog (RFC 9727) · /.well-known/ai-catalog.json · /mcp/server-card

English summary

We drill water boreholes in the Algarve (Faro to Aljezur, including Monchique). Free quote, reply in 24–48 h. Reference prices: €35–80 per metre drilled; a complete domestic borehole usually €3 000–10 000 (indicative, excl. VAT). Request a quote with POST https://furosdeaguaalgarve.pt/api/orcamento (JSON, see /openapi.json; add X-Dry-Run: 1 to test), through the MCP server https://furosdeaguaalgarve.pt/mcp, or with the web form https://furosdeaguaalgarve.pt/en/quote. 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: Miguel Baptista, +351 912 338 777). Served areas: Aljezur, Vila do Bispo, Lagos, Monchique, Portimão, Silves, Lagoa, Albufeira, Loulé, Faro.