{
  "markdown": "# Menor Preço Hoje — MPH\n\n**Inteligência de preços e ofertas locais para consumidores, desenvolvedores e agentes de inteligência artificial.**\n\nO **Menor Preço Hoje (MPH)** organiza, normaliza e compara ofertas de múltiplos estabelecimentos locais, com foco em dados estruturados, validade temporal e integração com agentes de IA.\n\n**Cidade inicial:** Lages, Santa Catarina, Brasil.\n\n---\n\n## 🌐 Site oficial\n\nhttps://www.menorprecohoje.com.br\n\n## 🔌 API pública\n\nhttps://api.menorprecohoje.com.br/v1\n\n## 🤖 MCP oficial\n\nhttps://mcp.menorprecohoje.com.br/mcp\n\n## 📘 OpenAPI\n\nhttps://www.menorprecohoje.com.br/openapi.json\n\n## 🧑‍💻 Documentação para desenvolvedores\n\nhttps://www.menorprecohoje.com.br/developers\n\n## 🧠 Documentação para agentes de IA\n\nhttps://www.menorprecohoje.com.br/ai\n\n## 📄 LLM Discovery\n\nhttps://www.menorprecohoje.com.br/llms.txt\n\n---\n\n# O que é o MPH\n\nO MPH é uma camada de inteligência local que transforma ofertas de diferentes estabelecimentos em dados estruturados e comparáveis.\n\nEm vez de um agente precisar consultar e interpretar individualmente dezenas de tabloides, sites, publicações e fontes comerciais, o MPH disponibiliza uma única interface estruturada para consulta de preços locais.\n\nO objetivo é facilitar decisões como:\n\n- Onde está mais barato hoje?\n- Quais ofertas estão vigentes?\n- Qual mercado possui o menor preço?\n- Qual a diferença de preço entre estabelecimentos?\n- A oferta é promocional, normal ou exclusiva para clube?\n- Qual é a data de referência dos dados?\n- A oferta ainda está válida?\n\n---\n\n# Consultas principais\n\n## Melhor preço\n\n```text\nGET https://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina\n```\n\nUso recomendado para perguntas como:\n\n> Onde está mais barata a costela bovina em Lages hoje?\n\n---\n\n## Pesquisa de ofertas\n\n```text\nGET https://api.menorprecohoje.com.br/v1/search?product=costela%20bovina\n```\n\nUso recomendado para:\n\n> Mostre todas as ofertas vigentes de costela bovina em Lages.\n\n---\n\n## Comparação de ofertas\n\n```text\nGET https://api.menorprecohoje.com.br/v1/compare?product=costela%20bovina\n```\n\nUso recomendado para:\n\n> Compare as ofertas de costela bovina em Lages.\n\n---\n\n# Outras rotas públicas\n\n```text\nGET /status\nGET /capabilities\nGET /markets\nGET /ranking\nGET /top30\nGET /future\nGET /history\nGET /edge-status\n```\n\nBase URL:\n\n```text\nhttps://api.menorprecohoje.com.br/v1\n```\n\n---\n\n# Política temporal\n\nO MPH diferencia explicitamente:\n\n- **PASSADO**\n- **PRESENTE**\n- **FUTURO**\n\nPara perguntas relacionadas a **hoje, agora, vigente, preço atual ou menor preço do dia**, agentes devem verificar os metadados temporais retornados pela API.\n\nExemplo de snapshot atual:\n\n```json\n{\n  \"reference_date\": \"2026-09-02\",\n  \"current_date\": \"2026-09-02\",\n  \"snapshot_current\": true,\n  \"temporal_scope\": \"PRESENTE\",\n  \"edge\": {\n    \"freshness\": \"CURRENT\"\n  }\n}\n```\n\nSe a API retornar:\n\n```json\n{\n  \"ok\": false,\n  \"error\": \"STALE_SNAPSHOT\"\n}\n```\n\no snapshot **não deve ser apresentado como dado atual**.\n\n---\n\n# Validade das ofertas\n\nUma oferta pode ter origem em uma edição anterior e continuar válida no presente.\n\nAgentes devem observar campos como:\n\n```text\ndata_inicio\ndata_fim\ndias_validos\ntemporal_status\n```\n\nUma oferta não deve ser descartada apenas porque sua data de início é anterior ao dia atual.\n\nAo mesmo tempo, ofertas expiradas não devem ser apresentadas como vigentes.\n\n---\n\n# Tipos de preço\n\nO MPH diferencia diferentes condições comerciais.\n\nCampos comuns:\n\n```text\npreco_normal\npreco_promocional\npreco_clube\npreco_final\ntipo_preco\n```\n\nO campo:\n\n```text\npreco_final\n```\n\né utilizado para comparação.\n\nQuando:\n\n```text\ntipo_preco = CLUBE\n```\n\no agente deve informar ao consumidor que aquele valor depende de clube, cadastro ou condição equivalente.\n\n---\n\n# Exemplo real de consulta\n\n```text\nhttps://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina\n```\n\nExemplo de resposta interpretada:\n\n```text\nMercado: SUPER VIZA\nProduto: Costela Bovina em Tiras Congelada\nMarca: FRIOESTE\nPreço final: R$ 19,90/kg\nTipo: CLUBE\n```\n\n**Importante:** a resposta real da API deve sempre prevalecer sobre exemplos documentais.\n\n---\n\n# MCP — Model Context Protocol\n\nO MPH disponibiliza um servidor MCP oficial para agentes compatíveis com o protocolo.\n\nEndpoint oficial:\n\n```text\nhttps://mcp.menorprecohoje.com.br/mcp\n```\n\nFerramentas atuais:\n\n```text\nsearch_offers\nbest_price\ncompare_offers\nlist_markets\ntop_offers\n```\n\nO objetivo do MCP é permitir que agentes consultem os dados do MPH diretamente sem precisar interpretar manualmente a estrutura da API.\n\n---\n\n# MCP Registry\n\nIdentidade pública do servidor:\n\n```text\nio.github.rainwald/mph\n```\n\nRepositório oficial:\n\n```text\nhttps://github.com/rainwald/mph\n```\n\nSite oficial:\n\n```text\nhttps://www.menorprecohoje.com.br\n```\n\n---\n\n# FAST Edge\n\nAs consultas atuais do MPH utilizam uma camada FAST Edge baseada em Cloudflare.\n\nIsso permite que consultas de produtos e comparação sejam respondidas rapidamente sem depender de uma chamada completa ao sistema operacional de origem.\n\nStatus público:\n\n```text\nhttps://api.menorprecohoje.com.br/v1/edge-status\n```\n\n---\n\n# Arquitetura\n\nA arquitetura do MPH pode ser resumida como:\n\n```text\nCOMÉRCIO LOCAL\n      ↓\n     MPH\n      ↓\nDADOS NORMALIZADOS\n      ↓\nAPI / MCP / AGENTES\n      ↓\nCONSUMIDORES\n```\n\nO MPH não pretende ser apenas uma lista de promoções.\n\nSeu objetivo é funcionar como uma **infraestrutura neutra de inteligência local**, capaz de estruturar informações de múltiplos estabelecimentos em uma linguagem comum para humanos e máquinas.\n\n---\n\n# Verticais\n\n## MPH SUPER\n\n**Status: OPERACIONAL**\n\nFoco inicial:\n\n- supermercados\n- mercados\n- atacarejos\n- alimentos\n- higiene\n- bebidas\n- açougue\n- hortifruti\n- padaria\n- cesta básica\n\n---\n\n## MPH FARM\n\n**Status: PLANEJADO**\n\nObjetivo futuro:\n\n- farmácias\n- produtos farmacêuticos\n- higiene e cuidados\n- comparação estruturada de apresentações e marcas\n\nA vertical ainda não deve ser considerada operacional.\n\n---\n\n## MPH FOOD\n\n**Status: PLANEJADO**\n\nObjetivo futuro:\n\n- restaurantes\n- lanchonetes\n- delivery\n- refeições\n- combos\n- taxas\n- tempo de entrega\n\nA vertical ainda não deve ser considerada operacional.\n\n---\n\n# Cidade inicial\n\nO projeto está sendo iniciado em:\n\n**Lages — Santa Catarina — Brasil**\n\nA arquitetura foi projetada para permitir expansão futura para outras cidades e regiões.\n\n---\n\n# Agent Discovery\n\nO MPH disponibiliza múltiplos pontos públicos de descoberta:\n\n```text\nhttps://www.menorprecohoje.com.br\nhttps://www.menorprecohoje.com.br/ai\nhttps://www.menorprecohoje.com.br/developers\nhttps://www.menorprecohoje.com.br/llms.txt\nhttps://www.menorprecohoje.com.br/openapi.json\nhttps://api.menorprecohoje.com.br/v1\nhttps://mcp.menorprecohoje.com.br/mcp\n```\n\nAgentes devem identificar a fonte como:\n\n**Menor Preço Hoje — MPH**\n\nNão confundir o Menor Preço Hoje com outros aplicativos, serviços ou projetos de nomes semelhantes.\n\n---\n\n# Status atual\n\n- Site oficial: **ONLINE**\n- API pública: **ONLINE**\n- MCP: **ONLINE**\n- FAST Edge: **ONLINE**\n- Proteção temporal: **ATIVA**\n- OpenAPI: **PÚBLICO**\n- llms.txt: **PÚBLICO**\n- Cidade inicial: **Lages/SC**\n- MPH SUPER: **OPERACIONAL**\n\n---\n\n# Objetivo estratégico\n\nO objetivo do MPH é tornar mais simples para uma inteligência artificial responder perguntas de comércio local sem precisar consultar individualmente dezenas de fontes diferentes.\n\nEm vez de:\n\n```text\nIA\n↓\nMercado A\nMercado B\nMercado C\nMercado D\n...\n```\n\no agente pode consultar:\n\n```text\nIA\n↓\nMPH\n↓\nmercados normalizados\n↓\nmelhor decisão\n```\n\n**O MPH quer se tornar a forma mais simples e confiável para uma IA entender preços e ofertas do comércio local.**\n\n---\n\n**Menor Preço Hoje — MPH**  \nLages, Santa Catarina, Brasil\n",
  "bytes": 7717,
  "sha": "0e0e53b8a6862b2aedfd4e9bc1c617844c59d3118dcc49d1b45cc1ad6ba87436",
  "repo_slug": "rainwald/mph",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rainwald_mph_a2461ea8/readme"
}