A cada análise você faz uma escolha: rápido e barato ou profundo e completo. Este módulo dissolve a confusão — mostra o que muda (e o que não muda), os modelos por trás, os custos lado a lado e uma regra simples para decidir.
Diagrama ilustrativo — os dois modos chegam aos mesmos documentos; o que muda é a profundidade da pesquisa.
Existe um mito comum: o de que o modo Comprehensive "gera mais coisas". Não é verdade. A diferença é só uma — a profundidade da pesquisa. O Quick faz cerca de 9 buscas; o Comprehensive, cerca de 18. Os 15 documentos finais são exatamente os mesmos.
Pense numa redação: os dois modos escrevem o mesmo número de páginas com a mesma estrutura. O Comprehensive simplesmente leu o dobro de fontes antes de escrever — então as páginas saem mais embasadas, com mais detalhe e nuance.
O Quick é o modo padrão — você não precisa nem digitar a flag. É rápido (2-3 minutos) e baratíssimo (~US$ 0,05). Pense nele como sua ferramenta de triagem.
# Estas duas linhas fazem a mesma coisa
python -m strategy_factory.main run "Stripe"
python -m strategy_factory.main run "Stripe" --mode quick
# ~9 buscas · 2-3 min · ~US$ 0,05Para a esmagadora maioria dos casos, o Quick já entrega um ótimo rascunho. Só suba para o Comprehensive quando o resultado for realmente para frente (cliente, diretoria).
O Comprehensive é a passada profunda. Leva de 5 a 10 minutos e custa cerca de US$ 0,50 — dez vezes mais que o Quick, mas ainda assim menos de um dólar. É o modo para a empresa que você vai realmente apresentar.
# A flag é obrigatória aqui
python -m strategy_factory.main run "Stripe" --mode comprehensive
# Com contexto, o resultado fica ainda melhor
python -m strategy_factory.main run "Stripe" \
--mode comprehensive \
--context "B2B payments, fintech"
# ~18 buscas · 5-10 min · ~US$ 0,50"Dez vezes mais caro" soa muito, mas é a diferença entre 5 e 50 centavos de dólar. Quando o resultado importa, esse é o melhor investimento que você fará no dia.
Por que o Comprehensive custa mais? Porque ele usa modelos de IA mais caros e potentes na pesquisa. Entender quais modelos entram em cada modo explica a conta.
Usa apenas o modelo sonar da Perplexity — barato e rápido. É o suficiente para uma boa visão geral.
Combina sonar, sonar-pro e sonar-deep-research. Modelos mais fortes (e mais caros) que buscam fundo.
Nos dois modos, a escrita usa o mesmo modelo: gemini-2.5-flash. Por isso os documentos têm o mesmo formato — muda a matéria-prima, não o escritor.
Os números variam um pouco conforme o tamanho da empresa e o quanto há a pesquisar. Aqui estão as faixas reais dos dois modos — e um lembrete de que a geração é sempre gratuita.
┌─────────────────┬────────────┬──────────────────┐
│ MODO │ TEMPO │ CUSTO │
├─────────────────┼────────────┼──────────────────┤
│ 🐇 Quick │ 2-3 min │ ~US$ 0,02 - 0,15 │
│ 🐢 Comprehensive│ 5-10 min │ ~US$ 0,31 - 0,90 │
│ ⚙️ Geração │ local │ GRÁTIS │
└─────────────────┴────────────┴──────────────────┘A geração (PPTX, DOCX, PNG) roda no seu computador e não consome API — por isso é sempre grátis.
custo típico do Quick
custo típico do Comprehensive
fase de geração
Quer saber quanto uma análise específica custou? Rode status "Empresa" --detailed: ele mostra o custo registrado no state.json.
A estratégia campeã é simples: triar várias empresas no Quick e aprofundar só a escolhida no Comprehensive. E quando aprofundar, reaproveite a pesquisa que já tem.
Você vai apresentar/entregar este resultado?
│
├─ NÃO → 🐇 Quick (triagem, estudo, primeira passada)
│
└─ SIM → 🐢 Comprehensive
│
└─ Já rodou Quick nesta empresa antes?
│
├─ SIM → --mode comprehensive --skip-research?
│ (avalie: pesquisa básica já serve?)
│
└─ NÃO → --mode comprehensive (pesquisa do zero)Rode run "Empresa" para cada candidata. Custa centavos no total.
Leia os rascunhos rápidos e decida qual empresa merece o aprofundamento.
Rode --mode comprehensive na escolhida. Use --skip-research se a pesquisa básica já bastar.
Filtre barato, invista caro só onde vale. Esse equilíbrio entre Quick e Comprehensive é o que mantém seus custos minúsculos sem abrir mão de qualidade quando importa.
2.3 — Os bastidores (conceitos) — abra a caixa-preta: as 3 fases por dentro, os arquivos de estado e cache, e a pasta de saída.