内容
# 微框架工具
**巴西AI智能体工具包** — 适用于网页和文档工作智能体的补充工具，弥补了沙盒环境的功能限制。
请智能体生成Pix支付代码，解析CEP（巴西邮政编码）为完整地址，或
从CNPJ注册中心拉取公司记录。指向一个包含大量JavaScript的网页
并获取干净的Markdown、截图或PDF。
一次CNPJ查询费用 **$0.01** — 按调用次数计费，无月度计划，无合同
无最低消费，这在巴西数据API中是罕见的。
- **API:** https://tools.miniframe.com.br
- **一键尝试工具：** [商店入口](https://tryponcho.com/m/tools.miniframe.com.br)
- **机器可读规范：** [openapi.json](https://tools.miniframe.com.br/openapi.json) · [llms.txt](https://tools.miniframe.com.br/llms.txt)
## 工具列表
- **pix_brcode** — 生成巴西Pix支付代码（BR Code / "Copia e Cola" 字符串）以及二维码PNG。每次调用$0.01。
- **cep_lookup** — 解析巴西邮政编码（CEP）为完整街道地址。每次调用$0.005。
- **cnpj_lookup** — 通过CNPJ号码在公共注册中心查询巴西公司。每次调用$0.01。
- **url_to_markdown** — 获取JavaScript渲染的网页并为LLM返回干净的Markdown。每次调用$0.02。
- **screenshot_url** — 截取网页截图并以PNG或JPEG返回。每次调用$0.03。
- **url_to_pdf** — 将网页渲染为PDF。每次调用$0.03。
- **compress_pdf** — 使用Ghostscript压缩PDF文件。每次调用$0.02。
每个工具都映射到同一服务的HTTP端点：
| 工具 | 端点 |
|---|---|
| `pix_brcode` | `POST /pix/brcode` |
| `cep_lookup` | `POST /cep` |
| `cnpj_lookup` | `POST /cnpj` |
| `url_to_markdown` | `POST /url-to-markdown` |
| `screenshot_url` | `POST /screenshot` |
| `url_to_pdf` | `POST /url-to-pdf` |
| `compress_pdf` | `POST /compress-pdf` |
## 为什么这些工具值得付费
**巴西数据源，处理得当。** CEP查询首先命中BrasilAPI，如果失败则自动回落到ViaCEP，
因此单个上游故障不会导致智能体崩溃。两个数据源都通过一个标准化的、英文字段的格式返回 —
您的提示永远不需要知道哪个数据源返回了结果。
**本地生成符合规范的Pix代码。** BR Code遵循央行规定的EMV
布局、CRC16等，代码在我们这边生成，无需第三方支付提供商参与。
您发送的密钥用于生成代码，不会被存储。
**隐私受到重视。** CNPJ响应包含公司记录 — 法定名称、
商用名称、状态、主要活动、地址 — 设计上省略了个人字段。
**渲染过程不会成为攻击面。** 网页工具运行真实的Chromium，
因此JavaScript页面可以解析，并且在加载页面之前拒绝私有和内部地址（SSRF
防护）。
**无需安装复杂依赖。** Ghostscript和无头浏览器是
智能体沙盒环境无法安装的依赖。这正是此工具的用途 —
智能体已经可以很好地完成自己的任务（解析CSV、
读取电子表格），这些功能在这里不会被出售。
## 作为MCP服务器使用
与Claude Desktop、Claude Code、Cursor、Windsurf、Cline和任何MCP客户端兼容。
```json
{
"mcpServers": {
"miniframe-tools": {
"command": "npx",
"args": ["-y", "miniframe-tools-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0xyour_private_key"
}
}
}
}
```
重启客户端后，七个工具就会出现。然后直接询问：
> "为收款人邮箱`abc@example.com`，姓名玛丽亚·席尔瓦，城市累西腓，生成一个R$ 50的Pix代码"
>
> "CEP 01310-100的地址是什么？"
>
> "查询CNPJ 00.000.000/0001-91并告诉我公司是否活跃"
>
> "将https://example.com转换为Markdown，以便我可以总结它"
## 作为纯HTTP API使用
无需MCP — 每个工具都是一个普通的端点：
```bash
curl -i -X POST https://tools.miniframe.com.br/cep \
-H "Content-Type: application/json" \
-d '{"cep":"01310100"}'
```
## 支付
调用按请求计费，以USDC（在Base上）计费，使用
[x402](https://x402.org)协议：端点以`402`状态码回应价格，您的
客户端签名支付并重复请求。大多数智能体运行时都为您处理了这一步。
对于MCP，设置`EVM_PRIVATE_KEY`为一个包含几美元USDC的钱包 —
使用专用的低余额钱包，永远不要使用您的主钱包。密钥保留在您的机器上并
在本地签名；它永远不会被发送到API。
| 变量 | 是否必需 | 默认值 |
|---|---|---|
| `EVM_PRIVATE_KEY` | 是 | — |
| `MINIFRAME_API_URL` | 否 | `https://tools.miniframe.com.br` |
在纯HTTP上，使用任何x402库封装您的客户端 — 参考
[`examples/`](examples/)中的可运行Node脚本。
## 许可证
MIT
