miniframe-tools

MiniFrame Tools

AI エージェント向けのブラジル製ツールキット — サンドボックス内ではエージェントが対応できないウェブやドキュメントの作業も実行できます。

エージェントに Pix 決済コードの生成、CEP から完全な住所への変換、CNPJ 登録簿からの企業情報の取得を依頼できます。JavaScript を多用したページを指定すれば、整った Markdown、スクリーンショット、または PDF を取得できます。

CNPJ の検索料金は $0.01 です。呼び出しごとに課金され、月額プランも契約も最低利用料金もありません。ブラジルのデータ API としては珍しい仕組みです。

• API： https://tools.miniframe.com.br
• ワンクリックでツールを試す： ストアフロント
• 機械可読な仕様： openapi.json · llms.txt

ツール

• pix_brcode — ブラジルの Pix 決済コード（BR Code／「Copia e Cola」文字列）と QR PNG を生成します。1 回あたり $0.01。
• cep_lookup — ブラジルの郵便番号（CEP）を完全な住所に変換します。1 回あたり $0.005。
• cnpj_lookup — 公開登録簿で CNPJ 番号からブラジル企業を検索します。1 回あたり $0.01。
• empresa_profile — 見込み顧客の適格性を判断するための、ブラジル企業の統合プロフィールです。登録情報、CEP を使って補完した住所、派生フラグ（営業中、本社、設立年数、MEI／Simples、規模、リスク）を含みます。1 回あたり $0.02。
• url_to_markdown — JavaScript を実行したウェブページを取得し、LLM 向けの整った Markdown を返します。1 回あたり $0.02。
• screenshot_url — ウェブページのスクリーンショットを撮影し、PNG または JPEG で返します。1 回あたり $0.03。
• url_to_pdf — ウェブページを PDF としてレンダリングします。1 回あたり $0.03。
• extract — ページが公開する構造化データ（JSON-LD、Open Graph、メタデータ、テーブル、リンク）と、CSS セレクターで指定したフィールドを抽出します。1 回あたり $0.02。
• compress_pdf — Ghostscript で PDF ファイルを圧縮します。1 回あたり $0.02。

各ツールは、同じサービスの HTTP エンドポイントに対応しています。

ツール	エンドポイント
pix_brcode	POST /pix/brcode
cep_lookup	POST /cep
cnpj_lookup	POST /cnpj
empresa_profile	POST /empresa
url_to_markdown	POST /url-to-markdown
screenshot_url	POST /screenshot
url_to_pdf	POST /url-to-pdf
extract	POST /extract
compress_pdf	POST /compress-pdf

有料でも利用する価値がある理由

ブラジルの情報源を適切に処理します。 CEP の検索ではまず BrasilAPI を利用し、自動的に ViaCEP にフォールバックするため、上流サービスが 1 つ停止してもエージェントの動作に影響しません。どちらの情報源から取得した場合も、英語のキーを使った統一形式で返されるため、プロンプトでどちらが応答したかを気にする必要はありません。

仕様に準拠した Pix コードをローカルで生成します。 BR Code は CRC16 などを含むブラジル中央銀行の EMV 形式に準拠し、第三者の決済プロバイダーを介さず、こちら側で生成されます。送信されたキーはコードの生成に使われますが、保存されません。

プライバシーを重視しています。 CNPJ の応答には、会社の記録（法人名、商号、ステータス、主な事業、住所）が含まれます。個人情報に関するフィールドは、設計上含まれていません。

レンダリングを攻撃対象にしません。 ウェブツールは実際の Chromium を実行するため、JavaScript を使ったページも正しく読み込めます。また、ページを読み込む前にプライベートアドレスや内部アドレスを拒否します（SSRF ガード）。

難しい作業に必要なものをインストールする必要はありません。 Ghostscript やヘッドレスブラウザーは、エージェントのサンドボックスには存在せず、インストールもできない種類の依存関係です。このサービスはまさにそのためのものです。CSV の解析やスプレッドシートの読み取りなど、エージェントが自力でうまく実行できる作業は提供していません。

MCP サーバーとして使う

Claude Desktop、Claude Code、Cursor、Windsurf、Cline、およびあらゆる MCP クライアントで動作します。

{
  "mcpServers": {
    "miniframe-tools": {
      "command": "npx",
      "args": ["-y", "miniframe-tools-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xyour_private_key"
      }
    }
  }
}

クライアントを再起動すると、7 つのツールが表示されます。あとは次のように頼むだけです。

「キー [email protected]、名前 Maria Silva、都市 Recife で、R$ 50 の Pix コードを生成して」

「CEP 01310-100 の住所は？」

「CNPJ 00.000.000/0001-91 を調べて、この会社が営業中か教えて」

「https://example.com を Markdown に変換して。要約したいです」

通常の HTTP API として使う

MCP は不要です。すべてのツールは通常のエンドポイントです。

curl -i -X POST https://tools.miniframe.com.br/cep \
  -H "Content-Type: application/json" \
  -d '{"cep":"01310100"}'

お支払い

リクエストごとに Base 上の USDC で課金されます。プロトコルには x402 を使用します。エンドポイントは価格を含む 402 で応答し、クライアントが支払いに署名してリクエストを再送します。ほとんどのエージェントランタイムがこれを自動で処理します。

MCP の場合は、数ドル分の USDC を入金したウォレットの EVM_PRIVATE_KEY を設定します。残高の少ない専用ウォレットを使用し、メインのウォレットは決して使わないでください。秘密鍵はお使いのマシンに保管され、ローカルで署名に使われます。API に送信されることはありません。

変数	必須	デフォルト
EVM_PRIVATE_KEY	はい	—
MINIFRAME_API_URL	いいえ	https://tools.miniframe.com.br

通常の HTTP では、任意の x402 ライブラリでクライアントをラップしてください。実行可能な Node スクリプトについては examples/ をご覧ください。

ライセンス

MIT