brmarket-mcp

brmarket-mcp

x402 マイクロペイメント（Base または Solana 上の USDC）で自動決済する、ブラジルのマーケットプレイス商品検索用 MCP サーバーです。

1 回の呼び出しで Mercado Livre、Shopee、AliExpress をまとめて検索し、正規化された単一の形式で結果を返します。BRL 価格は整数のセンチモ単位で、正規リンクとアフィリエイトリンクに加え、マーケットプレイスごとの sources 状態も返すため、サービスが低下しているマーケットプレイスが黙って結果から抜け落ちることはありません。無料の輸入税計算ツールを使えば、価格から実際の 着地価格 を算出でき、ブラジルの輸入税を含めたお得な商品を正直に比較できます。

ステータス：まだ公開されていません。 [email protected] はビルド済みで準備が整っています。npm と MCP レジストリへの公開は手動で行います。詳しくは下記の 公開 を参照してください。

ツール

ツール	価格	機能
search_products	$0.01	Mercado Livre、Shopee、AliExpress をまとめて 1 回で検索します。正規化された BRL 価格（整数のセンチモ単位）、正規リンクとアフィリエイトリンク、送料無料、評価、販売数、販売者 ID／名前／公式ストアの情報、dataAsOf を返します。
search_by_image	$0.05	商品写真から検索します。実際に検索に使用した内容を確認できるよう、interpreted_query を返します。
search_products_preview	無料	1 件の検索結果を返します。正規リンクのみで、アフィリエイトリンクはありません。
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 ではこれがない状態で公開され、レジストリのエントリーからすべての変数が失われました。

ライセンス

MIT © Thiago Menzinger