QRCode.Pub tools

Imagens de QR code gratuitas; página web paga → Markdown, metadados da página e hospedagem de arquivos por 30 dias via micropagamentos x402 (USDC na Base/Solana, sem chave de API). Servidor remoto Streamable HTTP em https://qrcode.pub/mcp

Ver em qrcode.pubExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://qrcode.pub/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

API gratuita de QR code

Uma URL de entrada, uma imagem de QR code de saída. PNG ou SVG, qualquer tamanho e cor, sem chave de API, sem cadastro, sem marca d'água. CORS está aberto e cada imagem é armazenada em cache na borda da Cloudflare.

GET https://qrcode.pub/api/qr?data=<text or link>&size=300&format=png

Exemplo: https://qrcode.pub/api/qr?data=https%3A%2F%2Fexample.com&size=300

Experimente

Parâmetros

Nome	Padrão	Descrição
`data`	obrigatório	O texto ou link para codificar, codificado em URL. Até 2000 caracteres (UTF-8, emojis são aceitos). `text` também funciona.
`size`	300	Largura/altura da imagem em pixels, de 32 a 2000. `300` ou `300x300`.
`format`	png	`png` ou `svg`.
`color`	000000	Cor do primeiro plano: hexadecimal (`1a237e`, `%231a237e`) ou `r-g-b` (`26-35-126`).
`bgcolor`	ffffff	Cor de fundo, mesmos formatos. `bg` também funciona.
`ecc`	M	Correção de erros: `L` 7%, `M` 15%, `Q` 25%, `H` 30%. Use H se você colocar um logotipo por cima.
`margin`	4	Zona de silêncio ao redor do código em módulos, de 0 a 20. Os leitores precisam de pelo menos 2 a 4.

Erros retornam HTTP 400 com JSON como {"error": "..."}. As respostas enviam Access-Control-Allow-Origin: * e Cache-Control: public, max-age=31536000, immutable.

Exemplos

HTML

<img src="https://qrcode.pub/api/qr?data=https%3A%2F%2Fexample.com&size=200" alt="QR code" width="200" height="200">

Markdown (README do GitHub, documentação)

![QR code](https://qrcode.pub/api/qr?data=https%3A%2F%2Fexample.com&size=200)

curl

curl -o qr.svg "https://qrcode.pub/api/qr?data=hello%20world&format=svg&color=1a237e"

JavaScript

const src = 'https://qrcode.pub/api/qr?' + new URLSearchParams({ data: 'https://example.com', size: 400, ecc: 'H' });
document.querySelector('img').src = src;

Google Sheets / Excel

=IMAGE("https://qrcode.pub/api/qr?size=200&data=" & ENCODEURL(A2))

Imprimindo esses códigos em embalagens, cardápios ou placas? Um código estático nunca pode ser alterado. Um código dinâmico QRCode.Pub aponta para um link curto que você pode redirecionar a qualquer momento, com contagem de leituras: US$ 9 pagos uma única vez, sem assinatura, nunca expira.

Crie um QR code editável →

Para agentes de IA: ferramentas de pagamento por chamada (x402)

Quatro endpoints aceitam micropagamentos x402 (protocolo v2, esquema exact, USDC na Base ou na mainnet da Solana — escolha qualquer uma das entradas de accepts) para que um agente possa chamá-los sem conta ou chave de API. Chame uma vez, receba 402 Payment Required com um cabeçalho PAYMENT-REQUIRED, assine o pagamento, chame novamente com PAYMENT-SIGNATURE. Qualquer cliente x402 funciona (@x402/fetch, x402-axios, o SDK Python, o CLI/servidor MCP pay da Solana, clientes MCP com uma carteira x402).

Endpoint	Preço	Retorna
`GET /x402/qr?data=…`	US$ 0,005	Imagem de QR code, mesmos parâmetros da API gratuita acima.
`GET /x402/extract?url=…`	US$ 0,01	JSON: título, descrição, Markdown limpo da página, links.
`GET /x402/meta?url=…`	US$ 0,005	JSON: título, descrição, canonical, OpenGraph, Twitter card, ícones, JSON-LD.
`POST /x402/store`	US$ 0,01	Hospeda o arquivo enviado (≤ 5 MB; png, jpeg, webp, gif, pdf, json, txt, md, csv — corpo bruto com `Content-Type`, ou campo multipart `file`) em uma URL pública `https://qrcode.pub/f/<id>` por 30 dias. JSON: `url`, `expires`, excluir `token` (`DELETE /x402/store/<id>` com `Authorization: Bearer`). Sem HTML, SVG ou scripts; os arquivos são servidos com `nosniff` e uma CSP de sandbox.

O mesmo 402 também carrega um desafio Machine Payments Protocol (MPP, da Stripe e Tempo) em WWW-Authenticate: Payment — método tempo (USDC.e na Tempo) e método evm (USDC na Base), mesmo preço — então clientes MPP também funcionam: npx mppx "https://qrcode.pub/x402/qr?data=hello". Pague com Authorization: Payment …; a resposta carrega um cabeçalho Payment-Receipt.

Catálogo legível por máquina com preços e esquemas de entrada: https://qrcode.pub/x402 (também em /.well-known/x402); documento de descoberta OpenAPI 3.1 (perfil Agentcash Discovery, indexado pelo x402scan): https://qrcode.pub/openapi.json. Nada é cobrado por uma resposta 4xx (entrada inválida, página inacessível). A liquidação é feita por um facilitador sem conta; o cabeçalho PAYMENT-RESPONSE carrega o hash da transação.

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";   // a wallet holding USDC on Base

const paidFetch = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(process.env.KEY)) }],
});
const res = await paidFetch("https://qrcode.pub/x402/extract?url=https://example.com");
const { title, markdown, links } = await res.json();

Servidor MCP

As mesmas ferramentas estão disponíveis para qualquer cliente MCP como um servidor remoto (Streamable HTTP, sem login): https://qrcode.pub/mcp. Listado no registro oficial de MCP como pub.qrcode/tools. qr_code é gratuito e retorna a imagem inline; page_to_markdown, page_metadata e host_file são os endpoints x402 acima — chamados sem um argumento payment, retornam o payload 402 (preço e accepts); chamados com o payload de pagamento em base64 como payment, executam e liquidam.

{ "mcpServers": { "qrcode-pub": { "type": "http", "url": "https://qrcode.pub/mcp" } } }

Habilidades de Agente

Ensine a um agente de codificação (Claude Code, Codex, Cursor, OpenCode, …) esta API em um único comando — duas Agent Skills, qr-code-generator (a API gratuita de imagens) e x402-web-tools (os endpoints pagos e o servidor MCP), publicadas em AgentiLoop/skills e em https://qrcode.pub/.well-known/agent-skills/.

npx skills add AgentiLoop/skills      # or: npx skills add https://qrcode.pub

FAQ

Preciso de uma chave de API?

Não. Não há chave, conta ou cadastro. Chame a URL de um navegador, de uma tag <img>, de um servidor ou de uma planilha.

É realmente gratuito? Há limites?

Sim, é gratuito. Não há cota rígida; por favor, armazene em cache as imagens que você reutilizar e mantenha o tráfego razoável. As respostas são armazenadas em cache por um ano, então a mesma URL é servida a partir da borda.

Vocês armazenam os dados que eu codifico?

Não. A imagem é gerada dinamicamente e o conteúdo não é salvo. Apenas contamos o número de chamadas por dia e o site de referência, sem endereços IP.

Posso usar os códigos comercialmente?

Sim. As imagens são suas para imprimir ou enviar no seu produto, sem marca d'água e sem atribuição obrigatória.

Os QR codes expiram?

Não. São códigos estáticos: o conteúdo está dentro da imagem, então funcionam para sempre. A desvantagem é que você nunca pode alterar para onde apontam depois de impressos.

Posso mudar para onde um código impresso aponta?

Não com um código estático. Para isso, crie um código dinâmico QRCode.Pub: ele aponta para um link curto que você pode editar a qualquer momento, com contagem de leituras, por US$ 9 pagos uma única vez (sem assinatura).

Sem código? Use um gerador