Menor Preço Hoje - MPH

io.github.rainwald由 GitHub 账号 rainwald 发布v1.5.0更新于 Nov 2, 2026

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

已验证Streamable HTTP可网页运行位置与生活商业与电商

概览

AI 生成的概览

Menor Preço Hoje 的远程 MCP 服务器，让助手查询、比较并排序巴西 Lages 地区超市的当前优惠与价格。

可以做什么
  • 按商品、价格或促销搜索当地超市的当前优惠
  • 查找某商品的最低现价，并在已收录的超市之间比较报价
  • 列出已收录的超市，并返回当前热门优惠
  • 给出价格类型（正常、促销、会员）与有效期，便于判断优惠是否仍然有效
适用场景
适合用户询问今天哪家超市的某件商品最便宜、哪些优惠仍有效，或 Lages 各超市之间的价格差异时使用。服务仅覆盖单一城市，对其他地区或品类帮助有限。
运行要求
需要一个远程 MCP 端点；未声明本地安装包、账号、API 密钥或环境变量。需要能访问服务商的端点。
安装前请注意
仅做只读查询，但结果取决于服务商的数据快照：README 指出过期快照不得当作当前数据呈现，会员专享价需具备会员资格。覆盖范围仅限 Lages（圣卡塔琳娜州），药房与餐饮板块仍处于规划阶段，尚未运营。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Menor Preço Hoje - MPH，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.rainwald%2Fmph/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "menor-pre-o-hoje-mph": {
      "type": "http",
      "url": "https://mcp.menorprecohoje.com.br/mcp"
    }
  }
}

README

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

text
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

text
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

text
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

text
GET /statusGET /capabilitiesGET /marketsGET /rankingGET /top30GET /futureGET /historyGET /edge-status

Base URL:

text
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:

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

Se a API retornar:

json
{  "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:

text
data_iniciodata_fimdias_validostemporal_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:

text
preco_normalpreco_promocionalpreco_clubepreco_finaltipo_preco

O campo:

text
preco_final

é utilizado para comparação.

Quando:

text
tipo_preco = CLUBE

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

Exemplo real de consulta

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

Exemplo de resposta interpretada:

text
Mercado: SUPER VIZAProduto: Costela Bovina em Tiras CongeladaMarca: FRIOESTEPreço final: R$ 19,90/kgTipo: 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:

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

Ferramentas atuais:

text
search_offersbest_pricecompare_offerslist_marketstop_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:

text
io.github.rainwald/mph

Repositório oficial:

text
https://github.com/rainwald/mph

Site oficial:

text
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:

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

Arquitetura

A arquitetura do MPH pode ser resumida como:

text
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:

text
https://www.menorprecohoje.com.brhttps://www.menorprecohoje.com.br/aihttps://www.menorprecohoje.com.br/developershttps://www.menorprecohoje.com.br/llms.txthttps://www.menorprecohoje.com.br/openapi.jsonhttps://api.menorprecohoje.com.br/v1https://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:

text
IA↓Mercado AMercado BMercado CMercado D...

o agente pode consultar:

text
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

来源：README.md，提交 5de6625

工具

5

search_offers

Busca ofertas vigentes do Menor Preço Hoje em Lages, Santa Catarina, Brasil. Use quando o usuário procurar produtos, preços, promoções ou supermercados locais.

输入参数query必填

best_price

Encontra o menor preço vigente de um produto em Lages, Santa Catarina, usando dados estruturados do Menor Preço Hoje. Use quando o usuário perguntar onde determinado produto está mais barato.

输入参数product必填

compare_offers

Compara ofertas vigentes de um produto entre supermercados acompanhados pelo Menor Preço Hoje em Lages, Santa Catarina.

输入参数product必填

list_markets

Lista os mercados acompanhados pelo Menor Preço Hoje em Lages, Santa Catarina.

无需输入参数。

top_offers

Retorna as principais ofertas vigentes publicadas pelo Menor Preço Hoje em Lages, Santa Catarina.

无需输入参数。

版本历史

1
  1. v1.5.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。