Skip to content

V1n1v131r4/OSINT-Agentic-Framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License: GPL v3 Version Format Framework

OSINT Agentic Framework for OpenCode


🇬🇧 For english version, please change to the "en" branch


1. VisĂŁo Geral

Este framework operacional foi refatorado para suportar múltiplos propósitos de investigação OSINT. Agora, o operador define o propósito da operação no início do processo, e o framework sugere dinamicamente a pipeline mais adequada.

PropĂłsitos Suportados:

  • Instituições: Focado em empresas, domĂ­nios e ativos corporativos (Pipeline PadrĂŁo).
  • IndivĂ­duos: Focado em pegada digital de pessoas fĂ­sicas, exposição e vĂ­nculos.
  • Campanha de Desinformação: Análise de narrativas, coordenação e amplificação.
  • Análise de Narrativas: Mapeamento de ecossistemas de informação e influĂŞncia.
  • Vazamento de Dados: Avaliação de impacto, sensibilidade e origem de vazamentos.

2. ⚠️ Disclaimer e Uso Ético

Este framework é uma ferramenta de automação de inteligência de fontes abertas (OSINT). O uso deste material deve respeitar as seguintes diretrizes:

  • Legalidade: Certifique-se de que suas atividades estĂŁo em conformidade com as leis locais (como LGPD no Brasil ou GDPR na Europa).
  • Ética: NĂŁo utilize este framework para assĂ©dio, doxing, perseguição ou qualquer atividade ilegal.
  • Responsabilidade: O autor nĂŁo se responsabiliza pelo uso indevido das informações coletadas ou pelas ações tomadas com base nos relatĂłrios gerados.
  • TransparĂŞncia: Este framework foca em dados pĂşblicos e abertos. NĂŁo utilize para tentar acessar sistemas privados ou protegidos.

3. Como Funciona a Pipeline Dinâmica

Diferente de sistemas automáticos, este framework utiliza orientação dinâmica. Ao final de cada comando, o agente sugere o próximo passo baseado no tipo de operação escolhido.

  1. Case Intake: O operador define o operation_type no intake.json.
  2. Sugestão de Comando: O output de cada etapa contém o campo next_command.
  3. Execução Manual: O operador mantém o controle total, executando o comando sugerido após validar o resultado anterior.

4. Estrutura de Pastas

specs/ → Definições lógicas (específicas por tipo de operação).
.opencode/commands/ → Comandos executáveis.
cases/ → Dados dos casos.
  ├── <case-id>/
  │   ├── intake.json → Definição do propósito e alvo.
  │   ├── runs/ → Outputs de cada etapa.
  │   └── memory/ → Lições aprendidas (postmortem).

5. Passo a Passo: Iniciando uma Operação

5.1. Preparar o Intake

Crie a pasta do caso e edite o intake.json. Abaixo estão exemplos para cada tipo de operação:

Instituições

{
  "case_id": "CORP-001",
  "operation_type": "institutions",
  "target_name": "Empresa Alvo S.A.",
  "target_url": "https://alvo.com.br",
  "scope_type": "empresa",
  "analysis_goal": "Mapear QSA e ativos técnicos.",
  "restrictions": ["Apenas fontes pĂşblicas"]
}

IndivĂ­duos

{
  "case_id": "IND-001",
  "operation_type": "individuals",
  "target_name": "Nome do Alvo",
  "analysis_goal": "Mapear pegada digital e exposição social.",
  "restrictions": ["Respeitar LGPD"]
}

Desinformação

{
  "case_id": "DIS-001",
  "operation_type": "disinformation_campaign",
  "target_name": "Narrativa X sobre Assunto Y",
  "analysis_goal": "Identificar origem e amplificadores.",
  "restrictions": ["Focar em redes abertas"]
}

Narrativas

{
  "case_id": "NAR-001",
  "operation_type": "narrative_analysis",
  "target_name": "Tema de Interesse",
  "analysis_goal": "Mapear ecossistema de influĂŞncia.",
  "restrictions": ["Análise qualitativa"]
}

Vazamentos

{
  "case_id": "LEAK-001",
  "operation_type": "data_leak",
  "target_name": "Entidade Afetada",
  "analysis_goal": "Validar extensĂŁo e sensibilidade do vazamento.",
  "restrictions": ["NĂŁo baixar bases completas"]
}

5.2. Executar o Intake

/case-intake

O agente validará o tipo de operação e sugerirá o próximo comando (ex: /framing para instituições ou /framing-indiv para indivíduos).

5.3. Seguir a Pipeline

Execute os comandos sugeridos sequencialmente. O framework guiará você através do campo next_command.

Exemplo: Pipeline de Instituições

  1. /case-intake -> Sugere /framing
  2. /framing -> Sugere /corporate-collection
  3. /corporate-collection -> Sugere /expansion
  4. /expansion -> Sugere /entity-graph
  5. /entity-graph -> Sugere /institutional-validation
  6. /institutional-validation -> Sugere /technical-surface
  7. /technical-surface -> Sugere /brand-social-analysis
  8. /brand-social-analysis -> Sugere /unstructured-extraction
  9. /unstructured-extraction -> Sugere /geo-context
  10. /geo-context -> Sugere /correlation
  11. /correlation -> Sugere /report
  12. /report -> Sugere /postmortem

Exemplo: Pipeline de IndivĂ­duos

  1. /case-intake -> Sugere /framing-indiv
  2. /framing-indiv -> Sugere /individual-collection
  3. /individual-collection -> Sugere /expansion
  4. /expansion -> Sugere /entity-graph
  5. /entity-graph -> Sugere /identity-validation
  6. /identity-validation -> Sugere /individual-footprint
  7. /individual-footprint -> Sugere /individual-social-analysis
  8. /individual-social-analysis -> Sugere /unstructured-extraction
  9. /unstructured-extraction -> Sugere /geo-context
  10. /geo-context -> Sugere /correlation
  11. /correlation -> Sugere /report

Outras Pipelines (Fluxos Especializados)

  • Desinformação: /case-intake -> /framing-disinfo -> /disinfo-collection -> /expansion -> /content-analysis -> /disinfo-actor-mapping -> /correlation -> /report

  • Narrativas: /case-intake -> /framing-narrative -> /narrative-collection -> /expansion -> /content-analysis -> /narrative-ecosystem-map -> /correlation -> /report

  • Vazamentos: /case-intake -> /framing-leak -> /leak-collection -> /expansion -> /leak-impact-analysis -> /leak-data-audit -> /unstructured-extraction -> /correlation -> /report


6. Pré-requisitos

  • OpenCode instalado.
  • EXA habilitado (OPENCODE_ENABLE_EXA=1).

7. Customização

Para adicionar novas pipelines ou ajustar as existentes, edite os arquivos em specs/ e os comandos correspondentes em .opencode/commands/. O framework Ă© modular e desenhado para evoluir com a necessidade do operador.


8. Créditos e Licença

Desenvolvido para uso com a plataforma OpenCode. Licença: GPL v3.

About

OSINT Agentic Framework

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors