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 分

    請在儲存庫或註冊中心條目中宣告授權條款。