Brmarket Mcp

io.github.thomenz由 GitHub 帳號 thomenz 發布v0.3.0更新於 Oct 24, 2026

FREE Brazilian marketplace search (ML, Shopee, AliExpress) + import-tax calculator (x402)

已驗證STDIO僅桌面網頁搜尋與抓取金融商業與電商

概覽

AI 產生的概覽

搜尋巴西電商平台（Mercado Livre、Shopee、AliExpress）並計算進口稅，透過 x402 以 USDC 按次付費。

可以做什麼
一次呼叫同時搜尋 Mercado Livre、Shopee 和 AliExpress，回傳統一格式的結果：以整數分表示的巴西雷亞爾價格、標準連結與推廣連結、運費、評分、銷量和賣家資訊。免費預覽工具只回傳一筆結果，免費的進口稅計算器可把價格換算成含巴西進口稅與州 ICMS 的到手價。圖片搜尋工具接受商品照片並回傳實際使用的查詢字詞。每個回應都會標示各平台狀態為 ok、error、timeout 或 not_configured。
適用情境
適合比較寄往巴西的跨境購物，尤其是當含進口稅的真實成本比標價更重要時。免費預覽和稅費計算器不需要錢包即可使用，因此可以先試用再決定是否為完整搜尋付費。
執行需求
透過 stdio 在本機執行，通常使用 npx brmarket-mcp，因此需要 Node.js。付費工具需要存有 USDC 的錢包：Base 用 EVM_PRIVATE_KEY，Solana 用 SOLANA_PRIVATE_KEY，可選配 SOLANA_RPC_URL。BRMARKET_BASE_URL 預設指向託管 API，X402_NETWORK 選擇 base 或 base-sepolia。需要網路存取。
安裝前請注意
錢包金鑰 EVM_PRIVATE_KEY 和 SOLANA_PRIVATE_KEY 會花費真實資金，應使用餘額很少的專用錢包，不要用個人或資金池金鑰；能讀取該行程環境變數的任何程式都可以從中花錢。付費呼叫約為搜尋 $0.01、圖片搜尋 $0.05；沒有金鑰時這些工具會以 HTTP 402 失敗。當某平台回傳 error 或 timeout 時搜尋結果可能不完整，結果少並不代表市場上沒有貨。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Brmarket Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

brmarket-mcp

MCP server for Brazilian marketplace product search, paid automatically with x402 micropayments (USDC on Base or Solana).

One call searches Mercado Livre, Shopee and AliExpress together and returns a single normalized shape: BRL prices in integer cents, canonical + affiliate links, and a per-marketplace sources state so a degraded marketplace is never silent. A free import-tax calculator turns a price into the real landed price — the honest "best value with Brazilian import tax" comparison.

Status: not published yet. [email protected] is built and ready; publishing to npm and the MCP registry is a manual step. See Publishing below.

Tools

ToolPriceWhat it does
search_products$0.01Mercado Livre + Shopee + AliExpress in one call. Normalized BRL prices (integer cents), canonical + affiliate links, free shipping, rating, sold count, seller id/name/official-store, dataAsOf.
search_by_image$0.05Same, but from a product photo. Returns interpreted_query so you can see what was actually searched.
search_products_previewfreeOne result, canonical link only, no affiliate link.
calculate_import_taxesfreeBrazilian import tax + landed price of a cross-border purchase (Import Tax 0% ≤ US$50 else 30% − US$20, ICMS por-dentro by state, Bacen PTAX rate). BRL cents or USD in; pass uf on search_products too for per-offer landed_price_estimate.

Always read sources

Every response reports each marketplace as ok / error / timeout / not_configured. A short result list may mean a marketplace was down, not that the market is thin. Never present a degraded page as the whole market.

Install

bash
npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.json):

json
{  "mcpServers": {    "brmarket": {      "command": "npx",      "args": ["-y", "brmarket-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x…"      }    }  }}

The free preview tool works with no wallet at all.

Environment

VariableRequiredDescription
EVM_PRIVATE_KEYno0x… key of a dedicated wallet holding USDC on Base.
SOLANA_PRIVATE_KEYnobase58 or JSON-array secret key of a dedicated Solana wallet holding USDC.
SOLANA_RPC_URLnoRPC override used to build the Solana payment (e.g. a Helius URL).
BRMARKET_BASE_URLnoDefaults to https://brmarket.thomenz.me.
X402_NETWORKnobase (default) or base-sepolia.

Configure either rail, or both — the x402 layer settles on whichever the server's 402 advertises. Without any key, paid tools fail with HTTP 402.

⚠️ These keys spend real money. Use dedicated wallets with small balances, never a personal or treasury key. Anything that can read this process' environment can spend from them.

Develop

bash
npm installnpm run build          # tsc -> dist/npm run typechecknpm run version:check  # all FIVE version sites must agree

Publishing (manual — Thiago only)

bash
npm run version:check   # wired into prepublishOnly toonpm publish

Then verify the tarball from the registry, not the local build:

bash
npm pack brmarket-mcp@<version> --registry https://registry.npmjs.orgtar -xzOf brmarket-mcp-<version>.tgz package/dist/index.js | grep -o 'version: "[^"]*"'

A green build proves nothing about what was published — brdata-mcp 0.3.4 shipped from a stale source copy and its MCP handshake reported 0.3.2 while npm said 0.3.4. Check the tarball.

For the MCP registry, server.json carries the full environmentVariables block. Do not drop it: brdata-mcp 0.3.3 published without it and the registry entry lost every variable.

License

MIT © Thiago Menzinger

來源：README.md，提交 d7da237

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分