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 (catálogo inteiro):
  python cli.py fornecedor_catalogo fornecedor=meeplebr
CLI (resolução por código, repita o campo pra vários):
  python cli.py fornecedor_catalogo fornecedor=meeplebr codigos=0208 codigos=0341
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/fornecedor_catalogo/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"fornecedor": "meeplebr", "codigos": ["0208", "0341"]}'
`fornecedor` é o nome cadastrado em fornecedores.py (default meeplebr). `codigos` é opcional -- lista de códigos do fornecedor a resolver individualmente; omitido, a task varre o catálogo inteiro.

CLI (plano):
  python cli.py fornecedor_carrinho fornecedor=grok itens=GRK0082:2 itens=GRK0165:1
CLI (aplicar):
  python cli.py fornecedor_carrinho fornecedor=grok itens=GRK0082:2 executar=sim
  python cli.py fornecedor_carrinho fornecedor=asmodee itens=GMG102:2 itens=TGM001:12 executar=sim
  python cli.py fornecedor_carrinho fornecedor=meeplebr itens=0209:4 itens=0210:10 executar=sim
Sem itens, só com vazio=sim: esvazia o carrinho.

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

CLI:  python cli.py meeplebr_login forcar=nao
      python cli.py meeplebr_login forcar=sim   (limpa a sessão salva antes)
API:  curl -X POST http://<host>:8001/tasks/meeplebr_login/run-sync \
        -H "X-API-Key: <sua API_KEY>"
Resposta: {site, mode, url} onde mode é sessao_reaproveitada | login_refeito | fresh_apos_descarte.
Credenciais: MEEPLEBR_USER / MEEPLEBR_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)
      python cli.py game_images "nome=Dungeon Fighter (2ª Edição)" editora=Asmodee
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. `editora` (opcional) escolhe o
ÚNICO site de editora buscado; vazia ou sem site no catálogo = só lojistas.
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 game_links_search "Valheim: O Jogo de Tabuleiro"
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/game_links_search/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"ref": "Valheim: O Jogo de Tabuleiro"}'
`ref` e o nome do jogo (em portugues ou ingles -- os 3 sites fazem busca por substring, entao um nome parcial tambem funciona, ex: "Valheim").

CLI:  python cli.py ludopedia_game_code "https://ludopedia.com.br/jogo/valheim-the-board-game"
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/ludopedia_game_code/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"ref": "https://ludopedia.com.br/jogo/valheim-the-board-game"}'
`ref` e a URL completa da pagina do jogo na Ludopedia (formato ludopedia.com.br/jogo/<slug> -- e o mesmo `LudoLink` que o sub-workflow antigo recebia).

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)
  substituir        -- opcional (true/false, padrão false): true remove as imagens que o
                       produto já tinha, depois do upload conferido (sem ele, soma)
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_pre_venda_pendentes simular=false   (simular=true: só o plano)
API (lote grande: responde 202 e entrega o resultado por webhook):
  curl -X POST https://<host>/tasks/iset_pre_venda_pendentes/run-async \
    -H "X-API-Key: <sua API_KEY>" -H "Content-Type: application/json" \
    -d '{"result_webhook_url": "https://<receptor>"}'
Opcional: "simular": true -- lê a tabela e cada produto, devolve o plano, não grava
nem avisa o n8n.
NÃO aponte result_webhook_url para os Webhooks de pré-venda do workflow
iLobrK32qmg1Jrli: a própria task já os avisa (passo avisar).
Requer ISET_ADMIN_USER, ISET_ADMIN_PASS, N8N_BASE_URL e N8N_API_KEY no 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)
  editora      -- opcional; só o site desta editora é buscado, antes dos lojistas
                  (vazia ou sem site no catálogo = só lojistas)
  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
  acumular     -- opcional (true/false, padrão false): por padrão as imagens que o
                  produto já tinha saem depois do upload conferido (republicar não
                  duplica); true soma as novas às de antes
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.

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 (catálogo inteiro):
  python cli.py fornecedor_catalogo fornecedor=meeplebr
CLI (resolução por código, repita o campo pra vários):
  python cli.py fornecedor_catalogo fornecedor=meeplebr codigos=0208 codigos=0341
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/fornecedor_catalogo/run-sync \
    -H "X-API-Key: <sua API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"fornecedor": "meeplebr", "codigos": ["0208", "0341"]}'
`fornecedor` é o nome cadastrado em fornecedores.py (default meeplebr). `codigos` é opcional -- lista de códigos do fornecedor a resolver individualmente; omitido, a task varre o catálogo inteiro.

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)
  editora      -- opcional; só o site desta editora é buscado, antes dos lojistas
                  (vazia ou sem site no catálogo = só lojistas)
  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
  acumular     -- opcional (true/false, padrão false): por padrão as imagens que o
                  produto já tinha saem depois do upload conferido (republicar não
                  duplica); true soma as novas às de antes
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 op_iset_get_product_images_admin produto=meeple0208
CLI (só ler, sem disparar nada):
      python cli.py op_iset_get_product_images_admin produto=meeple0208 webhook_url=none
API (blocks and returns the result as JSON):
  curl -X POST http://<host>:8001/tasks/op_iset_get_product_images_admin/run-sync \n    -H "X-API-Key: <sua API_KEY>" -H "Content-Type: application/json" \n    -d '{"produto": "meeple0208"}'
Campos:
  produto      -- SKU (preferido) ou nome do produto no painel (obrigatório)
  webhook_url  -- opcional. VAZIO = usa o DEFAULT do perfil ativo, setting
                  OP_IMAGENS_WEBHOOK_URL (no perfil 'operador': o webhook n8n
                  'Procedure Bling Substituir Imagens em Produto ID', que TROCA
                  as imagens do produto no Bling). Passe uma URL pra mandar pra
                  outro lugar, ou 'none' pra não disparar webhook nenhum. Sem
                  perfil/sem esse setting, vazio = não dispara nada.
ATENÇÃO: o default tem efeito EXTERNO (altera o produto no Bling). O n8n acha o
produto pela Data Table 'Produtos Catalogo' casando SkuMeca com o sku do payload:
se o produto for recém-cadastrado e não estiver lá, o webhook responde 200 e nada
é atualizado -- confira no Bling, não só pelo HTTP. Ver NOTES.md.
Requer ISET_ADMIN_USER e ISET_ADMIN_PASS configurados no servidor.