miniframe-tools

MiniFrame Tools

面向 AI Agent 的巴西工具包——还可处理 Agent 无法在沙箱中完成的网页和文档工作。

让你的 Agent 生成 Pix 付款码、将 CEP 查询为完整地址，或从 CNPJ 注册库中获取企业记录。将 JavaScript 内容繁多的网页交给它，即可获得干净的 Markdown、截图或 PDF。

查询一次 CNPJ 只需 $0.01——按调用计费，无月费、无合同、无最低消费，这在巴西数据 API 中并不常见。

• API： https://tools.miniframe.com.br
• 一键试用工具： storefront
• 机器可读规范： openapi.json · llms.txt

工具

• pix_brcode — 生成巴西 Pix 付款码（BR Code / “Copia e Cola”字符串）和 QR PNG。每次调用 $0.01。
• cep_lookup — 将巴西邮政编码（CEP）查询为完整街道地址。每次调用 $0.005。
• cnpj_lookup — 在公开注册库中按 CNPJ 编号查询巴西企业。每次调用 $0.01。
• empresa_profile — 汇总巴西企业资料，用于评估潜在客户：注册信息 + 通过 CEP 补全的地址 + 衍生标记（活跃状态、总部、年限、MEI/Simples、规模、风险）。每次调用 $0.02。
• url_to_markdown — 获取由 JavaScript 渲染的网页，并返回适合大模型使用的干净 Markdown。每次调用 $0.02。
• screenshot_url — 截取网页并以 PNG 或 JPEG 格式返回。每次调用 $0.03。
• url_to_pdf — 将网页渲染为 PDF。每次调用 $0.03。
• extract — 提取网页提供的结构化数据（JSON-LD、Open Graph、元数据、表格、链接），以及你通过 CSS 选择器传入的字段。每次调用 $0.02。
• compress_pdf — 使用 Ghostscript 压缩 PDF 文件。每次调用 $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，因此单个上游服务中断不会导致你的 Agent 无法工作。两个数据源的结果都会统一为以英文键名表示的格式——你的提示词无需判断响应来自哪个数据源。

本地生成符合规范的 Pix 码。 BR Code 遵循中央银行的 EMV 格式，包括 CRC16，完全由我们生成，流程中不涉及第三方支付服务商。你发送的密钥仅用于生成代码，不会被存储。

认真对待隐私。 CNPJ 响应包含企业记录——法定名称、商号、状态、主要业务和地址——并且按设计排除个人信息字段。

渲染不会带来攻击面。 网页工具使用真实的 Chromium，因此能正确加载 JavaScript 页面；并且在加载网页前会拒绝访问私有和内部地址（SSRF 防护）。

难以处理的部分无需安装任何东西。 Ghostscript 和无头浏览器这类依赖，是 Agent 沙箱中没有也无法安装的。这正是本服务的用途——Agent 已经能独立完成的工作（如解析 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"
      }
    }
  }
}

重启客户端后，就会显示七个工具。然后直接提出请求：

“为 R$ 50 生成一个 Pix 码，收款密钥为 [email protected]，姓名为 Maria Silva，城市为 Recife”

“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"}'

付费

调用按请求计费，以 USDC 在 Base 上结算，使用 x402 协议：端点会以 402 响应并提供价格，你的 客户端签署付款后重新发送请求。大多数 Agent 运行时会为你处理这些步骤。

对于 MCP，将 EVM_PRIVATE_KEY 设置为一个存有几美元 USDC 的钱包——请使用余额较低的专用钱包，切勿使用主钱包。密钥保留在你的设备上并在本地签名；它绝不会发送到 API。

变量	必填	默认值
EVM_PRIVATE_KEY	是	—
MINIFRAME_API_URL	否	https://tools.miniframe.com.br

通过普通 HTTP 使用时，可用任意 x402 库封装客户端——可运行的 Node 脚本请参阅 examples/。

许可证

MIT