Integração para agentes

QuokkaPix MCP Runner

Adaptador MCP local para Claude Desktop, Cursor, wrappers LM Studio/Ollama e outros agentes. Ele abre o QuokkaPix num navegador local, processa arquivos locais e grava quokkapix-result.json.

agents.html agent-test.html GitHub

O que os agentes podem fazer

Executar receitas oficiais para Shopify, Amazon, Google Merchant, limpeza de metadados e pacotes sociais.
Executar custom settings diretos com process_with_settings, usando o mesmo payload de window.QuokkaPixAgent.applySettings.
Validar result manifests e obter QA de formato, dimensões, limites de tamanho e conteúdo ZIP.
Ler x402 payment options e verificar unlock tokens para execuções agent batch pagas.
Enviar arquivos asset locais para marcas d'água com logotipo e substituição de fundo por imagem.

Ferramentas MCP

list_recipesget_recipevalidate_recipevalidate_result_manifestprocess_imagesprocess_with_settingsget_payment_optionsexplain_payment_flowverify_unlock_token

Configuração

{
  "mcpServers": {
    "quokkapix": {
      "command": "npx",
      "args": [
        "quokkapix-mcp"
      ],
      "env": {
        "QUOKKAPIX_APP_URL": "https://quokkapix.com/#agent=1"
      }
    }
  }
}

Exemplos

{
  "settings": {
    "mode": "single",
    "tool": "compress",
    "settings": {
      "compress": {
        "format": "webp",
        "quality": 0.82
      }
    }
  },
  "inputFiles": [
    "/Users/me/photo.jpg"
  ],
  "outputDir": "/Users/me/quokkapix-output"
}

Notas importantes

Os arquivos continuam entrando apenas pelo input local do navegador. O QuokkaPix não oferece API pública de processamento no servidor.