QRCode.Pub tools

Imágenes de código QR gratuitas; página web de pago → Markdown, metadatos de página y alojamiento de archivos por 30 días mediante micropagos x402 (USDC en Base/Solana, sin clave API). Servidor remoto Streamable HTTP en https://qrcode.pub/mcp

Ver en qrcode.pubPrueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

API de códigos QR gratuita

Una URL de entrada, una imagen de código QR de salida. PNG o SVG, cualquier tamaño y color, sin clave de API, sin registro, sin marca de agua. CORS está abierto y cada imagen se almacena en caché en el borde de Cloudflare.

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

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

Pruébalo

Parámetros

Nombre	Predeterminado	Descripción
`data`	obligatorio	El texto o enlace a codificar, codificado en URL. Hasta 2000 caracteres (UTF-8, los emojis están bien). `text` también funciona.
`size`	300	Ancho/alto de la imagen en píxeles, de 32 a 2000. `300` o `300x300`.
`format`	png	`png` o `svg`.
`color`	000000	Color de primer plano: hexadecimal (`1a237e`, `%231a237e`) o `r-g-b` (`26-35-126`).
`bgcolor`	ffffff	Color de fondo, mismos formatos. `bg` también funciona.
`ecc`	M	Corrección de errores: `L` 7%, `M` 15%, `Q` 25%, `H` 30%. Usa H si pones un logotipo encima.
`margin`	4	Zona de silencio alrededor del código en módulos, de 0 a 20. Los escáneres necesitan al menos 2 a 4.

Los errores devuelven HTTP 400 con JSON como {"error": "..."}. Las respuestas envían Access-Control-Allow-Origin: * y Cache-Control: public, max-age=31536000, immutable.

Ejemplos

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 de GitHub, documentación)

![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))

¿Imprimes estos códigos en empaques, menús o letreros? Un código estático nunca se puede cambiar. Un código dinámico de QRCode.Pub apunta a un enlace corto que puedes redirigir en cualquier momento, con conteos de escaneo: $9 una vez, sin suscripción, nunca caduca.

Crear un código QR editable →

Para agentes de IA: herramientas de pago por llamada (x402)

Cuatro endpoints aceptan micropagos x402 (protocolo v2, esquema exact, USDC en Base o en la red principal de Solana — elige cualquiera de las entradas de accepts) para que un agente pueda llamarlos sin cuenta ni clave de API. Llama una vez, obtén 402 Payment Required con un encabezado PAYMENT-REQUIRED, firma el pago, llama de nuevo con PAYMENT-SIGNATURE. Cualquier cliente x402 funciona (@x402/fetch, x402-axios, el SDK de Python, el CLI/servidor MCP pay de Solana, clientes MCP con una billetera x402).

Endpoint	Precio	Devuelve
`GET /x402/qr?data=…`	$0.005	Imagen de código QR, mismos parámetros que la API gratuita anterior.
`GET /x402/extract?url=…`	$0.01	JSON: título, descripción, Markdown limpio de la página, enlaces.
`GET /x402/meta?url=…`	$0.005	JSON: título, descripción, canónico, OpenGraph, tarjeta de Twitter, iconos, JSON-LD.
`POST /x402/store`	$0.01	Aloja el archivo subido (≤ 5 MB; png, jpeg, webp, gif, pdf, json, txt, md, csv — cuerpo sin procesar con un `Content-Type`, o campo multipart `file`) en una URL pública `https://qrcode.pub/f/<id>` durante 30 días. JSON: `url`, `expires`, eliminar `token` (`DELETE /x402/store/<id>` con `Authorization: Bearer`). Sin HTML, SVG ni scripts; los archivos se sirven con `nosniff` y una CSP de sandboxing.

El mismo 402 también lleva un desafío de Protocolo de Pagos de Máquinas (MPP, de Stripe y Tempo) en WWW-Authenticate: Payment — método tempo (USDC.e en Tempo) y método evm (USDC en Base), mismo precio — así que los clientes MPP también funcionan: npx mppx "https://qrcode.pub/x402/qr?data=hello". Paga con Authorization: Payment …; la respuesta lleva un encabezado Payment-Receipt.

Catálogo legible por máquina con precios y esquemas de entrada: https://qrcode.pub/x402 (también en /.well-known/x402); documento de descubrimiento OpenAPI 3.1 (perfil de descubrimiento Agentcash, indexado por x402scan): https://qrcode.pub/openapi.json. No se cobra nada por una respuesta 4xx (entrada incorrecta, página inaccesible). El pago lo realiza un facilitador sin cuenta; el encabezado PAYMENT-RESPONSE lleva el hash de la transacción.

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

Las mismas herramientas están disponibles para cualquier cliente MCP como servidor remoto (HTTP Streamable, sin inicio de sesión): https://qrcode.pub/mcp. Listado en el registro oficial de MCP como pub.qrcode/tools. qr_code es gratuito y devuelve la imagen en línea; page_to_markdown, page_metadata y host_file son los endpoints x402 anteriores — llamados sin un argumento payment devuelven el payload 402 (precio y accepts), llamados con el payload de pago en base64 como payment se ejecutan y liquidan.

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

Habilidades de agente

Enseña a un agente de codificación (Claude Code, Codex, Cursor, OpenCode, …) esta API en un solo comando — dos Habilidades de agente, qr-code-generator (la API de imágenes gratuita) y x402-web-tools (los endpoints de pago y el servidor MCP), publicadas en AgentiLoop/skills y en https://qrcode.pub/.well-known/agent-skills/.

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

Preguntas frecuentes

¿Necesito una clave de API?

No. No hay clave, cuenta ni registro. Llama a la URL desde un navegador, una etiqueta <img>, un servidor o una hoja de cálculo.

¿Es realmente gratis? ¿Hay límites?

Sí, es gratis. No hay cuota estricta; por favor, almacena en caché las imágenes que reutilices y mantén un tráfico razonable. Las respuestas se almacenan en caché durante un año, por lo que la misma URL se sirve desde el borde.

¿Almacenan los datos que codifico?

No. La imagen se genera sobre la marcha y el contenido no se guarda. Solo contamos el número de llamadas por día y el sitio web de referencia, sin direcciones IP.

¿Puedo usar los códigos comercialmente?

Sí. Las imágenes son tuyas para imprimir o incluir en tu producto, sin marca de agua y sin atribución requerida.

¿Caducan los códigos QR?

No. Son códigos estáticos: el contenido está dentro de la imagen, por lo que funcionan para siempre. La desventaja es que nunca puedes cambiar a lo que apuntan después de imprimirlos.

¿Puedo cambiar a dónde apunta un código impreso?

No con un código estático. Para eso, crea un código dinámico de QRCode.Pub: apunta a un enlace corto que puedes editar en cualquier momento, con conteos de escaneo, por $9 una vez (sin suscripción).

¿Sin código? Usa un generador