================================================================
 FB BUSCADOR DE GRUPOS - GUIA COMPLETO (INSTALACAO E USO)
 v1.1.0 - LEIA-ME
================================================================

O QUE E ESTA EXTENSAO?
----------------------
O FB Buscador de Grupos busca grupos no Facebook por uma palavra-chave
e envia pedidos de entrada nos grupos automaticamente para voce.
Funciona no Chrome, Edge, Brave, Opera e em qualquer navegador
baseado em Chromium (desktop).

--------------------------------------------------------------------------------
PARTE 1 - INSTALACAO (FACA UMA VEZ SO)
--------------------------------------------------------------------------------

PASSO 1: EXTRAIA OS ARQUIVOS
  1. Localize o arquivo .zip desta extensao no seu computador.
  2. Clique com o botao direito no arquivo e escolha "Extrair tudo..." (Windows).
  3. Escolha uma pasta de facil acesso (ex.: Documentos ou Area de Trabalho).
  4. Clique em "Extrair".
  5. IMPORTANTE: Nao apague nem mova essa pasta depois de instalar.
     Se apagar, a extensao para de funcionar.

PASSO 2: ABRA O GERENCIADOR DE EXTENSOES
  1. Abra o navegador Chrome (ou Edge, Brave, etc).
  2. Na barra de endereco, digite e aperte ENTER:
        chrome://extensions
     No Edge e:  edge://extensions
     No Brave e:  brave://extensions
  3. Procure pela chave "Modo do desenvolvedor" no canto superior
     direito e ATIVE (ligue) ela.
  4. Ao ativar, aparecem 3 botoes novos: "Carregar sem compactacao",
     "Empacotar extensao" e "Atualizar".

PASSO 3: CARREGUE A EXTENSAO
  1. Clique no botao "Carregar sem compactacao".
  2. Navegue ate a pasta que voce extraiu no PASSO 1.
     IMPORTANTE: clique na pasta CERTA - a que contem os arquivos
     manifest.json, index.html, icons, etc. (se abrir e nao tiver
     manifest.json, entre na subpasta que aparece).
  3. Selecione a pasta e clique em "Selecionar pasta".
  4. Pronto! A extensao "FB Buscador de Grupos" aparece na lista de
     extensoes. Se quiser, clique no pino (fixar) para ela aparecer
     na barra do navegador.

PASSO 4: ABRA O PAINEL
  1. Abra o Facebook (www.facebook.com) e faca LOGIN na sua conta.
     A extensao so funciona logado.
  2. Clique no icone da extensao na barra do navegador (ou no icone de
     quebra-cabeca e depois no "FB Buscador de Grupos").
  3. Um painel lateral abre no lado direito da tela com a bolinha verde
     acesa (sinal de que esta funcionando).

--------------------------------------------------------------------------------
PARTE 2 - COMO USAR (PASSO A PASSO)
--------------------------------------------------------------------------------

PASSO 1: DEFINA OS FILTROS (OPCIONAL)
  No painel, no topo, voce pode ajustar:
   - Palavra-chave: termo da busca. Ex.: Marketing, Vendas, Pets.
   - Max Grupos: quantidade maxima de grupos a coletar (padrao 50).
   - Min Membros: ignora grupos com menos membros que isso (padrao 1000).
   - Apenas Publicos: marcado = so grupos publicos.
   - Sem Duplicados: remove grupos repetidos.
   - Ocultar Participando: esconde grupos que voce ja participa.
   - Delay entre acoes (s): tempo de espera entre um grupo e outro.
     Padrao 5 a 15 segundos. Quanto maior, mais seguro.

PASSO 2: BUSCAR GRUPOS
  1. Digite a palavra-chave no campo "Palavra-chave".
  2. Clique no botao azul "Buscar Grupos".
  3. A extensao abre a pagina de busca do Facebook e faz a busca em 2
     etapas: primeiro coleta todos os grupos que aparecem para a
     palavra-chave e depois seleciona somente os que tem a quantidade
     minima de membros que voce pediu em "Min Membros".
  4. A busca PARALIZA SOZINHA quando chega no numero de grupos pedido
     em "Max Grupos" com a quantidade de membros escolhida.
     IMPORTANTE: o numero maximo de grupos encontrados e a quantidade
     de grupos que realmente tem aquela quantidade de membros. Se so
     existirem 11 grupos com 3.000+ membros, o resultado sera 11.
  5. Nao mexa na aba do Facebook enquanto ela estiver rolando.
  6. Quando terminar, os resultados aparecem na tabela do painel
     (Grupo, Membros, Status) com todos marcados.

PASSO 3: SELECIONAR GRUPOS
   - Todos os grupos encontrados ja vem selecionados.
   - Desmarque os que nao quiser, ou use "Selecionar Todos"/"Desmarcar
     Todos" logo abaixo dos botoes principais.

PASSO 4: SOLICITAR ENTRADA
  1. Com os grupos selecionados, clique no botao verde "Solicitar Entrada".
  2. A extensao comeca a abrir cada grupo, clicar em "Participar do grupo"
     (e em "Pedir para participar" quando o grupo pedir confirmacao) e
     aguardar o tempo do delay antes do proximo.
  3. Acompanhe tudo pelo LOG no painel e pelas cores na tabela:
       Solicitado (amarelo) = pedido enviado
       Entrou (verde)      = voce ja entrou
       Falhou (vermelho)   = grupo fechado/restrito
  4. NAO MEXA na aba do Facebook durante o processo. Feche os pop-ups
     se aparecerem, mas nao clique em nada da pagina.

PASSO 5: PAUSAR
  - Clique em "Pausar" a qualquer momento para interromper o processo,
    INCLUSIVE enquanto um grupo ainda esta carregando. A pausa vale
    imediatamente e a extensao nao avanca para o proximo grupo.
  - O que ja foi feito fica salvo; os proximos grupos ficam pendentes.

--------------------------------------------------------------------------------
PARTE 3 - DICAS IMPORTANTES (LEIA!)
--------------------------------------------------------------------------------
 1. Use delays maiores (10 a 30 segundos) para parecer uma pessoa real
    e evitar que o Facebook bloqueie sua conta.
 2. Nao solicite entrada em centenas de grupos de uma vez. Recomendado:
    no maximo 20-30 grupos por rodada, 1 a 2 vezes ao dia.
 3. Se o Facebook pedir captcha ou confirmacao de identidade, resolva
    manualmente e continue depois.
 4. A extensao so funciona com o Facebook ABERTO e LOGADO na mesma conta.
 5. Se der erro "Botao nao encontrado", o grupo e fechado ou a pagina
    mudou - pule ele e siga com os demais.
 6. Para atualizar a extensao depois de eu enviar uma versao nova:
    apague a extensao antiga (no chrome://extensions) e repita os
    PASSOS 1 a 3 da PARTE 1.

--------------------------------------------------------------------------------
PARTE 4 - PROBLEMAS COMUNS E SOLUCOES
--------------------------------------------------------------------------------
 "NAO ENCONTROU GRUPO NENHUM"
   -> Confirme que esta LOGADO no Facebook e que a palavra-chave tem
      resultados na busca manual do Facebook.
 "A BUSCA PAROU COM POUCOS GRUPOS"
   -> A busca rola a pagina ate o fim e para quando chega na quantidade
      de grupos com o minimo de membros pedido. Se retornou menos que
      o limite, e porque so existiam esses grupos com aquela quantidade
      de membros. Tente outra palavra-chave ou baixe o "Min Membros".
 "O PAUSAR NAO PARECE FUNCIONAR"
   -> A pausa agora e imediata, inclusive durante o carregamento de um
      grupo. Se ainda assim continuar, recarregue a extensao em
      chrome://extensions (botao de atualizar).
 "A EXTENSAO NAO ABRE"
   -> Recarregue a pagina do Facebook (F5) e clique de novo no icone.
   -> Confirme que a pasta da extensao nao foi movida/apagada.
 "APARECE 'ERRO AO FALAR COM A ABA'"
   -> Recarregue a aba do Facebook (F5) e tente de novo.
 "O PAINEL ABRE VAZIO"
   -> Feche e reabra o painel, ou recarregue a extensao em
      chrome://extensions (botao de atualizar, simbolo de seta).

--------------------------------------------------------------------------------
AVISO
--------------------------------------------------------------------------------
Use com responsabilidade. O envio excessivo de solicitações pode
resultar em restricoes na sua conta do Facebook. Esta extensao e um
conjunto de ferramentas de automacao; a responsabilidade pelo uso e
do proprio usuario.

Sistemas Store (c) 2026
================================================================
