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 分