CLI pdfx: um só catálogo, chamado pelo seu terminal
A CLI pdfx envia as mesmas requisições multipart do curl para a API do PDF123 ou para o seu próprio pdfx-server, e acrescenta lotes, senhas por arquivo e códigos de saída para scripts.

PDF123 é o nome do produto. O pdfx é o mesmo catálogo de operações empacotado para o shell: monta a requisição multipart que o curl teria montado, envia para a URL base que você escolher e grava o resultado ao lado dos seus arquivos. Mesclar, Comprimir, OCR e o restante do catálogo são chamáveis assim.
O que uma chamada realmente envia
pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
merge a.pdf b.pdf -o merged.pdf
--api-base tem como padrão https://pdf123.xyz, e --api-key (ou a variável de ambiente PDFX_API_KEY) é opcional, então o catálogo anônimo funciona sem chave. Aponte a base para http://127.0.0.1:8080 se quiser uma pilha docker-compose sua. Não há um segundo protocolo por baixo: a CLI é cliente da superfície REST documentada em Desenvolvedores, e os nomes das operações batem com as ferramentas do portal e com o documento OpenAPI em /v1/openapi.json.
O catálogo dá para descobrir sem sair do terminal. pdfx list imprime todas as ferramentas e pdfx describe add-stamp imprime os campos e padrões de uma ferramenta, a mesma definição que o portal renderiza como formulário.
Lotes, e os flags que o curl deixa para você escrever
Dê várias entradas a uma ferramenta de arquivo único e ela as executa como um lote no diretório de -o, imprimindo uma linha input -> saved por arquivo. As falhas vão para stderr e os arquivos restantes ainda terminam, então um PDF problemático numa pasta de faturas não aborta a execução. --concurrency <n> define quantos arquivos ficam em processamento ao mesmo tempo (padrão 2).
-o aceita um arquivo ou um diretório e nunca sobrescreve um arquivo existente, usando o nome de arquivo do servidor dentro do diretório. Isso importa quando o servidor nomeia o resultado a partir da entrada: sem essa regra, uma execução sobrescreveria o PDF que você acabou de enviar.
Entradas criptografadas são abertas antes da requisição, não pela ferramenta: --input-password cobre todos os arquivos da execução, e --password-for report.pdf=secret define a senha de um arquivo e pode ser repetido, com * valendo pelos demais. Um lote que mistura arquivos bloqueados e abertos dispensa ordenação manual. --json imprime { path, contentType, bytes } por resultado, ou [{ input, ok, path | error, reason }] para um lote, então um wrapper pode analisar o desfecho em vez de raspar as linhas legíveis.
Códigos de saída para um script ramificar
0 significa sucesso, 1 significa que uma requisição falhou (num lote: pelo menos um arquivo), 2 é um erro de uso em que nada foi enviado, e 130 significa que você interrompeu e a requisição em andamento foi abortada. As falhas imprimem linhas reason:, code: e hint: sob a mensagem sempre que disponíveis, e é nelas que um script deve casar, não na prosa.
Uma saída é fácil de ler errado. Uma ferramenta que não encontra nada para retornar termina com código diferente de zero e code: no_content, em vez de escrever um arquivo vazio; então pdf-to-csv num PDF sem tabelas é uma falha, não um CSV de zero byte.
Para onde vão os bytes
Os arquivos são enviados para a URL base, processados lá e apagados assim que a resposta sai. Esse é o mesmo contrato do formulário no navegador: a CLI muda o cliente, não o destino. Para documentos que não podem sair da sua rede, rode um pdfx-server você mesmo e aponte --api-base para ele, o que é tratado em Self-host.
Não há modo offline para onde recuar: se a base estiver inacessível, o comando falha. O pdfx é um cliente de rede que por acaso é agradável no shell, não um motor de PDF local.
O que a CLI não é
O pdfx não é uma GUI de desktop nem uma biblioteca de OCR que você embute em outro aplicativo. É um cliente de linha de comando para operações de PDF, então uma tarefa humana pontual continua melhor servida pelo portal (Comprimir, OCR e o resto do catálogo), e qualquer coisa que precise de uma árvore de UI própria recriaria o problema de divergência descrito em A mesma operação em quatro clientes.
Os agentes recebem os mesmos formatos pelo skill publicado em /skills/pdf123.md, que documenta por inteiro as requisições de merge e pipeline. Para repetir POSTs que alteram estado com segurança, envie Idempotency-Key; a CLI continua fazendo uma requisição por invocação, então o cabeçalho pertence a quem repetir (Idempotency-Key: novas tentativas seguras em tarefas de PDF). Chaves, limites de taxa e códigos de erro estão em Desenvolvedores.