brmarket-mcp

Name: brmarket-mcp
Author: thomenz

本地服务

github.com/thomenz搜索与检索015 周前更新

代码仓库

关于 brmarket-mcp

brmarket-mcp 是用于搜索巴西电商商品并估算进口税的 MCP 服务。它合并 Mercado Livre、Shopee 和 AliExpress 的结果并统一格式，同时逐个平台报告状态；README 称项目已构建但尚未发布。

主要功能

01跨平台商品搜索
02按商品图片搜索
03标准化雷亚尔价格与链接
04免费估算进口税和到手价
05逐个平台报告来源状态

适用场景

01比较三个平台的商品报价
02根据照片查找商品
03估算跨境购买的最终成本

MCP 相关

该 MCP 服务向 MCP 客户端提供商品搜索、图片搜索、预览和进口税计算工具。付费搜索通过 x402 使用 Base 或 Solana 上的 USDC 微支付；预览和税费计算免费。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "thomenz-brmarket": {
      "command": "npx",
      "args": [
        "-y",
        "brmarket-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
        "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
        "BRMARKET_BASE_URL": "<BRMARKET_BASE_URL>",
        "X402_NETWORK": "<X402_NETWORK>"
      }
    }
  }
}

启动命令npx -y brmarket-mcp

需要配置的环境变量

EVM_PRIVATE_KEY密钥0x private key of a DEDICATED wallet holding USDC on Base. OPTIONAL: product search and the tax calculator are free and work without any wallet; only search_by_image and the link comparison return 402 without it.

SOLANA_PRIVATE_KEY密钥base58 or JSON-array secret key of a DEDICATED Solana wallet holding USDC (pays per call). Configure this and/or EVM_PRIVATE_KEY; the x402 layer settles on whichever rail the 402 advertises.

SOLANA_RPC_URLOptional Solana RPC override used to build the payment (e.g. a Helius URL).

BRMARKET_BASE_URLBase URL of a brmarket Worker. Defaults to the hosted production API (https://brmarket.thomenz.me).

X402_NETWORK'base' (mainnet, default) or 'base-sepolia' (testnet).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmbrmarket-mcp0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
q	string	是	要搜索的内容，例如 'iphone 14 pro'。
uf	string	否	买家的巴西州两字母代码（例如 SP），用于估算到岸价时确定 ICMS 税率。默认值：20% 上限。
sort	enum	否	默认值为 price_asc（价格从低到高）。price_asc \| price_desc \| relevance
limit	integer	否	合并结果页中的结果数。默认值为 10，最大值为 20。
rerank	boolean	否	选择启用 LLM 相关性筛选（约 400ms，免费）。查询中可能包含更便宜的配件、零件或同名词时，请务必开启：它会过滤掉仅仅包含查询词的商品（搜索 'cafeteira' 时出现咖啡滤纸、搜索 'fone bluetooth' 时出现 AirPods 保护壳，或蓝牙查询中出现有线耳机）。请查看响应中的 `relevance`，了解每轮筛选移除了哪些结果。
max_price	number	否	BRL 最高价格。
min_price	number	否	BRL 最低价格（例如 199.90）。
marketplace	array	否	将搜索范围限制为这些平台。默认值：全部三个平台。

详细介绍

brmarket-mcp

用于巴西电商平台商品搜索的 MCP 服务，通过 x402 微支付自动付款（在 Base 或 Solana 上使用 USDC）。

一次调用即可同时搜索 Mercado Livre、Shopee 和 AliExpress，并返回统一格式：以整数分计价的 BRL 价格、规范链接和联盟链接，以及每个平台的 sources 状态，确保平台出现故障时不会悄无声息。免费的进口税计算器可将价格换算为实际的到岸价，帮助如实比较“含巴西进口税的最佳价值”。

状态：尚未发布。 [email protected] 已构建完成，准备就绪；发布到 npm 和 MCP 注册表仍需手动操作。请参阅下文的发布部分。

工具

工具	价格	功能
`search_products`	$0.01	一次调用搜索 Mercado Livre、Shopee 和 AliExpress。返回标准化 BRL 价格（整数分）、规范链接和联盟链接、包邮信息、评分、销量、卖家 ID/名称/是否官方店铺，以及 `dataAsOf`。
`search_by_image`	$0.05	功能相同，但通过商品照片搜索。返回 `interpreted_query`，便于查看实际搜索的内容。
`search_products_preview`	免费	返回一条结果，仅含规范链接，不含联盟链接。
`calculate_import_taxes`	免费	计算跨境购买的巴西进口税和到岸价（进口税：≤ US$50 时为 0%，否则为 30% − US$20；按州计算价内 ICMS；使用 Bacen PTAX 汇率）。输入 BRL 分或 USD；在 `search_products` 中也传入 `uf`，即可获取每条报价的 `landed_price_estimate`。

始终读取 `sources`

每个响应都会将各电商平台的状态标记为 ok / error / timeout / not_configured。结果数量较少可能意味着某个平台不可用，而不是市场商品稀少。切勿将降级页面呈现为整个市场的情况。

安装

npx brmarket-mcp

Claude Desktop / Claude Code（claude_desktop_config.json）：

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

免费预览工具完全无需钱包即可使用。

环境变量

变量	必需	说明
`EVM_PRIVATE_KEY`	否	持有 Base 上 USDC 的专用钱包的 `0x…` 密钥。
`SOLANA_PRIVATE_KEY`	否	持有 USDC 的专用 Solana 钱包的 base58 或 JSON 数组格式私钥。
`SOLANA_RPC_URL`	否	用于构建 Solana 付款的 RPC 覆盖地址（例如 Helius URL）。
`BRMARKET_BASE_URL`	否	默认为 `https://brmarket.thomenz.me`。
`X402_NETWORK`	否	`base`（默认）或 `base-sepolia`。

配置任意一种支付通道，或同时配置两种——x402 层会通过服务端在 402 响应中公布的通道结算。未配置任何密钥时，付费工具会返回 HTTP 402。

⚠️ 这些密钥会花费真实资金。 请使用余额较少的专用钱包，切勿使用个人密钥或金库密钥。任何能够读取此进程环境的对象都能使用这些钱包消费。

开发

npm install
npm run build          # tsc -> dist/
npm run typecheck
npm run version:check  # all FIVE version sites must agree

发布（手动操作——仅限 Thiago）

npm run version:check   # wired into prepublishOnly too
npm publish

然后验证注册表中的 tarball，而不是本地构建：

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

构建成功并不能证明发布的内容正确——brdata-mcp 0.3.4 曾从过期的源代码副本发布，MCP 握手报告的版本是 0.3.2，而 npm 显示的是 0.3.4。请检查 tarball。

对于 MCP 注册表，server.json 包含完整的 environmentVariables 区块。切勿删除它：brdata-mcp 0.3.3 发布时未包含该区块，导致注册表条目丢失了所有变量。