English Français العربية

Menor Preço Hoje - MPH

السجل الرسمي الذكاء الاصطناعي والوكلاء

Preços e ofertas locais em Lages via MCP para consumidores e agentes de IA.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http menor-pre-o-hoje-mph 'https://mcp.menorprecohoje.com.br/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "menor-pre-o-hoje-mph": {
            "type": "http",
            "url": "https://mcp.menorprecohoje.com.br/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Menor Preço Hoje — MPH
  2. 🌐 Site oficial
  3. 🔌 API pública
  4. 🤖 MCP oficial
  5. 📘 OpenAPI
  6. 🧑‍💻 Documentação para desenvolvedores
  7. 🧠 Documentação para agentes de IA
  8. 📄 LLM Discovery
  9. O que é o MPH
  10. Consultas principais
  11. Melhor preço
  12. Pesquisa de ofertas
  13. Comparação de ofertas
  14. Outras rotas públicas
  15. Política temporal
  16. Validade das ofertas
  17. Tipos de preço
  18. Exemplo real de consulta
  19. MCP — Model Context Protocol
  20. MCP Registry
  21. FAST Edge
  22. Arquitetura
  23. Verticais
  24. MPH SUPER
  25. MPH FARM
  26. MPH FOOD
  27. Cidade inicial
  28. Agent Discovery
  29. Status atual
  30. Objetivo estratégico

Menor Preço Hoje — MPH

Inteligência de preços e ofertas locais para consumidores, desenvolvedores e agentes de inteligência artificial.

O 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.

Cidade inicial: Lages, Santa Catarina, Brasil.

🌐 Site oficial

https://www.menorprecohoje.com.br

🔌 API pública

https://api.menorprecohoje.com.br/v1

🤖 MCP oficial

https://mcp.menorprecohoje.com.br/mcp

📘 OpenAPI

https://www.menorprecohoje.com.br/openapi.json

🧑‍💻 Documentação para desenvolvedores

https://www.menorprecohoje.com.br/developers

🧠 Documentação para agentes de IA

https://www.menorprecohoje.com.br/ai

📄 LLM Discovery

https://www.menorprecohoje.com.br/llms.txt

O que é o MPH

O MPH é uma camada de inteligência local que transforma ofertas de diferentes estabelecimentos em dados estruturados e comparáveis.

Em 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.

O objetivo é facilitar decisões como:

  • Onde está mais barato hoje?
  • Quais ofertas estão vigentes?
  • Qual mercado possui o menor preço?
  • Qual a diferença de preço entre estabelecimentos?
  • A oferta é promocional, normal ou exclusiva para clube?
  • Qual é a data de referência dos dados?
  • A oferta ainda está válida?

Consultas principais

Melhor preço

GET https://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina

Uso recomendado para perguntas como:

Onde está mais barata a costela bovina em Lages hoje?

Pesquisa de ofertas

GET https://api.menorprecohoje.com.br/v1/search?product=costela%20bovina

Uso recomendado para:

Mostre todas as ofertas vigentes de costela bovina em Lages.

Comparação de ofertas

GET https://api.menorprecohoje.com.br/v1/compare?product=costela%20bovina

Uso recomendado para:

Compare as ofertas de costela bovina em Lages.

Outras rotas públicas

GET /status
GET /capabilities
GET /markets
GET /ranking
GET /top30
GET /future
GET /history
GET /edge-status

Base URL:

https://api.menorprecohoje.com.br/v1

Política temporal

O MPH diferencia explicitamente:

  • PASSADO
  • PRESENTE
  • FUTURO

Para perguntas relacionadas a hoje, agora, vigente, preço atual ou menor preço do dia, agentes devem verificar os metadados temporais retornados pela API.

Exemplo de snapshot atual:

{
  "reference_date": "2026-09-02",
  "current_date": "2026-09-02",
  "snapshot_current": true,
  "temporal_scope": "PRESENTE",
  "edge": {
    "freshness": "CURRENT"
  }
}

Se a API retornar:

{
  "ok": false,
  "error": "STALE_SNAPSHOT"
}

o snapshot não deve ser apresentado como dado atual.

Validade das ofertas

Uma oferta pode ter origem em uma edição anterior e continuar válida no presente.

Agentes devem observar campos como:

data_inicio
data_fim
dias_validos
temporal_status

Uma oferta não deve ser descartada apenas porque sua data de início é anterior ao dia atual.

Ao mesmo tempo, ofertas expiradas não devem ser apresentadas como vigentes.

Tipos de preço

O MPH diferencia diferentes condições comerciais.

Campos comuns:

preco_normal
preco_promocional
preco_clube
preco_final
tipo_preco

O campo:

preco_final

é utilizado para comparação.

Quando:

tipo_preco = CLUBE

o agente deve informar ao consumidor que aquele valor depende de clube, cadastro ou condição equivalente.

Exemplo real de consulta

https://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina

Exemplo de resposta interpretada:

Mercado: SUPER VIZA
Produto: Costela Bovina em Tiras Congelada
Marca: FRIOESTE
Preço final: R$ 19,90/kg
Tipo: CLUBE

Importante: a resposta real da API deve sempre prevalecer sobre exemplos documentais.

MCP — Model Context Protocol

O MPH disponibiliza um servidor MCP oficial para agentes compatíveis com o protocolo.

Endpoint oficial:

https://mcp.menorprecohoje.com.br/mcp

Ferramentas atuais:

search_offers
best_price
compare_offers
list_markets
top_offers

O objetivo do MCP é permitir que agentes consultem os dados do MPH diretamente sem precisar interpretar manualmente a estrutura da API.

MCP Registry

Identidade pública do servidor:

io.github.rainwald/mph

Repositório oficial:

https://github.com/rainwald/mph

Site oficial:

https://www.menorprecohoje.com.br

FAST Edge

As consultas atuais do MPH utilizam uma camada FAST Edge baseada em Cloudflare.

Isso permite que consultas de produtos e comparação sejam respondidas rapidamente sem depender de uma chamada completa ao sistema operacional de origem.

Status público:

https://api.menorprecohoje.com.br/v1/edge-status

Arquitetura

A arquitetura do MPH pode ser resumida como:

COMÉRCIO LOCAL
      ↓
     MPH
      ↓
DADOS NORMALIZADOS
      ↓
API / MCP / AGENTES
      ↓
CONSUMIDORES

O MPH não pretende ser apenas uma lista de promoções.

Seu 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.

Verticais

MPH SUPER

Status: OPERACIONAL

Foco inicial:

  • supermercados
  • mercados
  • atacarejos
  • alimentos
  • higiene
  • bebidas
  • açougue
  • hortifruti
  • padaria
  • cesta básica

MPH FARM

Status: PLANEJADO

Objetivo futuro:

  • farmácias
  • produtos farmacêuticos
  • higiene e cuidados
  • comparação estruturada de apresentações e marcas

A vertical ainda não deve ser considerada operacional.

MPH FOOD

Status: PLANEJADO

Objetivo futuro:

  • restaurantes
  • lanchonetes
  • delivery
  • refeições
  • combos
  • taxas
  • tempo de entrega

A vertical ainda não deve ser considerada operacional.

Cidade inicial

O projeto está sendo iniciado em:

Lages — Santa Catarina — Brasil

A arquitetura foi projetada para permitir expansão futura para outras cidades e regiões.

Agent Discovery

O MPH disponibiliza múltiplos pontos públicos de descoberta:

https://www.menorprecohoje.com.br
https://www.menorprecohoje.com.br/ai
https://www.menorprecohoje.com.br/developers
https://www.menorprecohoje.com.br/llms.txt
https://www.menorprecohoje.com.br/openapi.json
https://api.menorprecohoje.com.br/v1
https://mcp.menorprecohoje.com.br/mcp

Agentes devem identificar a fonte como:

Menor Preço Hoje — MPH

Não confundir o Menor Preço Hoje com outros aplicativos, serviços ou projetos de nomes semelhantes.

Status atual

  • Site oficial: ONLINE
  • API pública: ONLINE
  • MCP: ONLINE
  • FAST Edge: ONLINE
  • Proteção temporal: ATIVA
  • OpenAPI: PÚBLICO
  • llms.txt: PÚBLICO
  • Cidade inicial: Lages/SC
  • MPH SUPER: OPERACIONAL

Objetivo estratégico

O 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.

Em vez de:

IA
↓
Mercado A
Mercado B
Mercado C
Mercado D
...

o agente pode consultar:

IA
↓
MPH
↓
mercados normalizados
↓
melhor decisão

O MPH quer se tornar a forma mais simples e confiável para uma IA entender preços e ofertas do comércio local.

Menor Preço Hoje — MPH
Lages, Santa Catarina, Brasil

الأسئلة الشائعة

ما هو Menor Preço Hoje - MPH؟

Preços e ofertas locais em Lages via MCP para consumidores e agentes de IA.

كيف أثبّت Menor Preço Hoje - MPH؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http menor-pre-o-hoje-mph 'https://mcp.menorprecohoje.com.br/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Menor Preço Hoje - MPH إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Menor Preço Hoje - MPH مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Menor Preço Hoje - MPH؟

ينشره rainwald. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.