Tasks disponíveis

CLI:  python cli.py bgg "https://boardgamegeek.com/boardgame/13/catan"
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/bgg/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"ref": "https://boardgamegeek.com/boardgame/13/catan"}'
`ref` aceita a URL completa do jogo (com ou sem slug/sufixo, ex: .../13/catan/sleeves)
ou só o id numérico (ex: "13").

CLI:  python cli.py bling_export_to_iset busca_sku_nome=BDD101
      python cli.py bling_export_to_iset ids_bling=16674025429 ids_bling=16384133188
API:  curl -X POST http://<host>:8001/tasks/bling_export_to_iset/run-sync \
        -H "X-API-Key: <sua API_KEY>" -F "ids_bling=16674025429"
Campos:
  busca_sku_nome  -- SKU (campo 'codigo' no Bling) ou nome EXATO do produto;
                     usado só quando 'ids_bling' vier vazio; resolve 1 produto
                     e recusa (listando os candidatos) se o nome bater em mais de um
  ids_bling       -- 1+ ids internos do Bling (repita o campo, ou um por linha no
                     dashboard); tem prioridade -- se preenchido, ignora 'busca_sku_nome'
                     e exporta todos numa chamada só, sem precisar buscar nada

CLI:  python cli.py bling_login forcar=nao
      python cli.py bling_login forcar=sim   (limpa a sessão salva antes)
API:  curl -X POST http://<host>:8001/tasks/bling_login/run-sync \
        -H "X-API-Key: <sua API_KEY>"
Resposta: {site, mode, url} onde mode é sessao_reaproveitada | login_refeito | fresh_apos_descarte.
Credenciais: BLING_USER / BLING_PASS no ambiente (ver .env.example).

CLI:  python cli.py game_images nome=Catan
      python cli.py game_images nome=Catan sku=BUY-CATAN01   (SKU só identifica a saída)
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/game_images/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "nome=Catan" -F "sku=BUY-CATAN01"
`nome` é o jogo a buscar; `sku` (opcional) vira o nome da pasta de saída e
identifica o resultado -- não muda a busca.
Imagens em data/output/game_images/<sku-ou-nome>/<loja>/; o JSON traz status
(processado/sem_lojas/sem_imagens), candidatos considerados com score e as
imagens por loja.

CLI:  python cli.py iset_add_product_images produto=GRK0219 imagens=https://exemplo.com/foto1.jpg imagens=C:/imgs/foto2.jpg
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_add_product_images/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "produto=GRK0219" -F "imagens=https://exemplo.com/foto1.jpg" \
    -F "imagens=https://exemplo.com/foto2.jpg"
Campos:
  produto           -- SKU (preferido) ou nome do produto no painel (obrigatório)
  imagens           -- 1+ imagens (repita o campo): cada uma uma URL http(s) ou um
                       caminho de arquivo local acessível pelo servidor
  imagem_principal  -- opcional, índice (0-based) da imagem que vira a principal (padrão 0)
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente no servidor.

CLI:  python cli.py iset_configurar_pre_venda itens='[{"sku":"GRK0134","eh_lancamento":false,"data_prevista":"2026-07-17"}]'
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_configurar_pre_venda/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F 'itens=[{"sku":"GRK0134","eh_lancamento":false,"data_prevista":"2026-07-17"}]'
Campos:
  itens -- lista de produtos. JSON (lista de objetos) OU uma linha por item
           no formato 'sku; lançamento(true/false); data(aaaa-mm-dd)'. A data é
           opcional (sem data = limpa o campo 'Disponível em').
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente.

CLI:  python cli.py iset_remover_pre_venda itens='[{"sku":"GRK0134","eh_lancamento":false}]'
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_remover_pre_venda/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F 'itens=[{"sku":"GRK0134","eh_lancamento":false}]'
Campos:
  itens -- lista de produtos. JSON (lista de objetos) OU uma linha por item
           no formato 'sku; lançamento(true/false)'. A data prevista, se vier,
           é ignorada na remoção (o campo 'Disponível em' é sempre limpo).
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente.

CLI:  python cli.py iset_atualizar_resumo sku=GRK0134 descricao_curta='Jogo de blefe e dedução para 4-8 jogadores.'
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_atualizar_resumo/run-sync \
    -H "X-API-Key: <sua API_KEY>" -H "Content-Type: application/json" \
    -d '{"sku": "GRK0134", "descricao_curta": "Jogo de blefe e dedução para 4-8 jogadores."}'
Campos:
  sku             -- SKU do produto (busca exata no painel; cai pra nome se não achar).
  descricao_curta -- texto do breve resumo a gravar (substitui o atual por inteiro).
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente.

CLI:  python cli.py iset_get_product_images produto=GRK0219
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_get_product_images/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "produto=GRK0219" -F "webhook_url=https://exemplo.com/webhook"
Campos:
  produto            -- SKU (preferido) ou nome do produto no painel (obrigatório)
  webhook_url        -- opcional; se informado, o JSON {produto_id, sku, nome, imagens}
                        é enviado por POST pra essa URL. Sem isso, a task só retorna
                        o resultado (útil pra testar via run-sync).
  ativar_se_inativo  -- opcional, padrão false. A lista de imagens vem da página pública
                        do produto, que só existe se ele estiver ATIVO na loja (ver
                        NOTES.md). Com true, um produto inativo é ativado temporariamente
                        pra essa leitura e desativado de novo em seguida -- ele fica de
                        fato visível/comprável na loja real durante essa janela.
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente no servidor.

CLI:  python cli.py iset_get_product_images_admin produto=AZU001
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_get_product_images_admin/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "produto=AZU001" -F "webhook_url=https://exemplo.com/webhook"
Campos:
  produto      -- SKU (preferido) ou nome do produto no painel (obrigatório)
  webhook_url  -- opcional; se informado, o JSON {produto_id, sku, nome, imagens}
                  é enviado por POST pra essa URL (mesmo payload da task irmã).
Diferente da iset_get_product_images (página pública), esta lê o painel:
reflete um upload imediatamente (sem cache da loja) e não exige produto ativo.
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados no servidor.

Recomendado pro n8n -- fire-and-forget (a cadeia leva minutos; a resposta chega
pelo webhook informado nos campos):
  curl -X POST http://<host>:8001/tasks/iset_publish_game_images/run \
    -H "X-API-Key: <sua API_KEY>" \
    -F "sku=AZU001" -F "nome=Azul" -F "sufixo_slug=meca dos jogos" \
    -F "webhook_url=https://n8n.exemplo/webhook/abc"
Alternativa bloqueante (devolve o JSON completo na resposta): trocar /run por /run-sync.
CLI:  python cli.py iset_publish_game_images sku=AZU001 nome=Azul webhook_url=https://...
Campos:
  sku          -- produto no iSET que recebe as imagens (obrigatório)
  nome         -- nome do jogo a buscar nas lojas (obrigatório)
  sufixo_slug  -- opcional; nome dos arquivos vira <nome>-<sufixo>-N.jpg (padrão "meca dos jogos")
  webhook_url  -- opcional; recebe {produto_id, sku, nome, imagens} ao final
Os links vêm do PAINEL (iset_get_product_images_admin): refletem o upload na
hora, sem o cache da página pública, e funcionam com produto inativo.
Status possíveis no JSON: publicado | sem_lojas | sem_imagens | tratamento_sem_imagens | upload_falhou.
ATENÇÃO: o webhook é enviado pelo último passo -- se a cadeia falhar antes
(sem_lojas, upload_falhou...), NENHUM webhook é disparado; monitore o job/JSON.

CLI:  python cli.py image_prep imagens=C:/fotos/catan1.jpg imagens=https://loja.com/catan2.jpg nome_base=catan
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/image_prep/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "imagens=https://loja.com/catan.jpg" -F "nome_base=catan"
Campos:
  imagens      -- 1+ imagens (repita o campo): caminhos locais e/ou URLs (obrigatório)
  nome_base    -- base do nome dos arquivos de saída (ex: "catan")
  largura, altura, max_kb -- opcionais; padrão 1200x800, 100KB (core/images/defaults.py)
  sufixo_slug  -- opcional; padrão "meca dos jogos" ("" omite)
  debug        -- opcional; salva as imagens intermediárias de cada estágio
Saída em data/output/image_prep/<nome_base>-<timestamp>/, com relatório por
estágio de cada imagem no JSON retornado.

CLI:  python cli.py iset_xml all
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/iset_xml/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "ref=all"
`ref` aceita "all" (recria todos os feeds cadastrados) ou o id numérico de um feed específico (ex: "1").
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados como variável de ambiente no servidor.

CLI:  python cli.py store_images "https://www.bravojogos.com.br/catan"
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/store_images/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -F "url=https://www.bravojogos.com.br/catan"
`url` é a página do produto na loja. As imagens são salvas em
data/output/store_images/<slug-da-url>/ e o JSON retornado traz origem,
resolução e caminho local de cada uma.