English Français العربية

io.github.thomenz/brmarket-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package brmarket-mcp
Claude Code 
claude mcp add brmarket-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BRMARKET_BASE_URL=<BRMARKET_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y brmarket-mcp@0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "brmarket-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "brmarket-mcp@0.3.0"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "SOLANA_PRIVATE_KEY": "<your solana_private_key>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "BRMARKET_BASE_URL": "<BRMARKET_BASE_URL>",
                "X402_NETWORK": "<X402_NETWORK>"
            }
        }
    }
}

متغيرات البيئة

  • 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_URL Optional Solana RPC override used to build the payment (e.g. a Helius URL).
  • BRMARKET_BASE_URL Base URL of a brmarket Worker. Defaults to the hosted production API (https://brmarket.thomenz.me).
  • X402_NETWORK 'base' (mainnet, default) or 'base-sepolia' (testnet).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. brmarket-mcp
  2. Tools
  3. Install
  4. Environment
  5. Develop
  6. Publishing (manual — Thiago only)
  7. License

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. brmarket-mcp@0.1.0 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

npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.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

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

Publishing (manual — Thiago only)

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

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

npm pack brmarket-mcp@<version> --registry https://registry.npmjs.org
tar -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

الأسئلة الشائعة

ما هو io.github.thomenz/brmarket-mcp؟

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

كيف أثبّت io.github.thomenz/brmarket-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add brmarket-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BRMARKET_BASE_URL=<BRMARKET_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y brmarket-mcp@0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.thomenz/brmarket-mcp إلى مفتاح API؟

نعم. يتطلب EVM_PRIVATE_KEY, SOLANA_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.thomenz/brmarket-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.thomenz/brmarket-mcp؟

ينشره thomenz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.