convez.ai
MCP ServerAutomaçãoAvançado
surfnoirworld

Kunaki MCP — Automação de Mídia Física

surfnoirworld/kunaki-mcp

Automação completa para manufatura sob demanda de mídia física

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server + automação de navegador para gerenciar fabricação e fulfillment de CDs, DVDs, vinis e fitas cassete via Kunaki. Integra criação de produtos (upload de áudio + artwork) com fulfillment de pedidos, quotas de envio e rastreamento — tudo sem APIs públicas para criar produtos.

Instalação

$npx convez-ai surfnoirworld/kunaki-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar e publicar discos sob demanda sem estoque mínimo
  • Automatizar fulfillment de pedidos de CDs/DVDs/vinis
  • Gerenciar quotas de envio, tracking e links de compra
  • Integrar com Claude para orçamentos e status de pedidos

Veredito

Solução robusta para quem precisa automatizar produção de mídia física. Combina browser automation (criação) + API XML (fulfillment) com elegância; bem documentada, mas requer conhecimento de variáveis de ambiente e caminhos absolutos.

README

A tradução para o português deste README ainda está na fila.

Kunaki MCP + Automation

Automate physical media (CD / DVD / vinyl / cassette) manufacturing and fulfillment through Kunaki — print-on-demand discs with no minimums and ~24h turnaround.

Kunaki exposes a small HTTP/XML API for order fulfillment only — there is no public API for creating products. This project covers both halves:

HalfToolHow
Create a product (upload audio + artwork → get a Product ID)kunaki_create_product.pyHeadless browser automation (nodriver) driving Kunaki's web uploader
Fulfill orders for an existing product (quotes, orders, tracking, images, buy links)server.py (MCP server)Kunaki's HTTP API
Collect Product IDs Kunaki assigns after productionkunaki_sync_products.pyReads your Products List, updates the registry
Prep artwork to exact specskunaki_prep_artwork.pyPillow resize → JPG/300DPI
Web UI wrapping create + prepapp.pyLocal Flask app

Quick start

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env          # fill in your Kunaki credentials

requirements.txt installs mcp, httpx, pydantic (server), nodriver (automation), Pillow (artwork), and flask (UI). No Playwright needed.

The MCP server (fulfillment)

Five tools, none of which expose credentials as parameters (they come from env):

ToolAuthDescription
kunaki_get_shipping_optionsnoneShipping options + costs for a product/destination
kunaki_place_orderenvPlace a manufacturing order (supports test_mode)
kunaki_get_order_statusenvStatus + tracking for an order
kunaki_get_product_imagesnoneAll product image URLs (front/back/spine/disc/box)
kunaki_get_buy_linknoneHosted PayPal buy-page URL

Add to an MCP client (Claude Desktop / Claude Code) — use the venv's Python, not a bare python, so the deps resolve:

{
  "mcpServers": {
    "kunaki": {
      "command": "/absolute/path/to/kunaki-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/kunaki-mcp/server.py"],
      "env": {
        "KUNAKI_USER_ID": "you@example.com",
        "KUNAKI_PASSWORD": "your-password"
      }
    }
  }
}

Kunaki's HTTP service wants repeated ProductId/Quantity query params for multi-product requests (not indexed ProductId[0]), and replies with a <Response>…<Option>…</Option></Response> XML envelope. server.py handles both; a malformed request returns "XML Response cannot be loaded".

Creating a product

1. Prep artwork

python kunaki_prep_artwork.py --check  my_album.json     # report sizes
python kunaki_prep_artwork.py --config my_album.json --output prepped/

All artwork is JPG, 300 DPI, RGB. CD jewel-case specs:

SlotSize (px)
disc1394 × 1394
front1423 × 1411
back (inside insert)1423 × 1411
tray (incl. spines)1772 × 1385

(See templates/ for vinyl and cassette specs.)

2. Write a config

Copy a template from templates/, fill in your paths, title, artist and publisher. Example: templates/cd_jewel_template.json.

3. Run the creator

python kunaki_create_product.py --config my_album.json            # visible browser
python kunaki_create_product.py --config my_album.json --headless # no window
python kunaki_create_product.py --config my_album.json --dry-run  # validate only

The creator logs in, uploads each artwork and audio track (Kunaki uploads one file at a time via XHR, with a progress bar), fills product info, and submits. Kunaki then transmits the product to production and assigns the Product ID a few hours later, by email — so a successful run reports a SubmissionId, and the PX… Product ID is collected afterward by the sync (below).

The login "403" gotcha. Kunaki's login page is Referer-gated (IIS anti-hotlinking) — navigating to it directly returns 403 Forbidden. The automation reaches it by clicking the homepage login link so the browser sends a Referer. This is not bot detection; switching browser engines does not help. The login submit is also a JS MySubmit() call, not a form submit.

4. Collect the Product ID

python kunaki_sync_products.py            # logs in, reads Products List

Updates kunaki-products.json (_catalog maps every PX… ID → title). Run it after a creation once Kunaki has finished transmitting.

Web UI

python app.py        # opens http://localhost:5000

Pick a product type, point at your audio + artwork, and it preps and creates in one flow (wraps the scripts above).

Pricing (2026)

CD jewel $2.00 · CD jacket $1.50 · disc-only $0.75 · DVD $2.00 · Vinyl 12" $36 · Vinyl 7" $15 · Cassette $5 — flat per unit, plus shipping. Free UPS Ground on US single-address orders over $400.

Status

  • ✅ MCP fulfillment server — verified against the live API
  • ✅ CD jewel-case creation — verified end-to-end (login → 14 uploads → submit → Product ID)
  • ✅ Registry sync
  • ⬚ DVD / vinyl / cassette creation — the submission forms differ per format; map each in ARTWORK_WIDGETS / FORMAT_NAV in kunaki_create_product.py against the live page (the CD flow is the template).

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados