# Ferramentas: web, dark web, rede e arquivos

> As ferramentas em volta dos modelos NotHoly: busca na web e na dark web, leitura de página, consulta de IP, domínio e vazamento, port scan e análise estática de arquivos. O conhecimento vem do CKE 2.0.

Ferramentas

Tudo o que o modelo alcança antes de responder.

As ferramentas em volta dos modelos. Num turno do chat, o modelo busca na web pública e em serviços .onion indexados, lê uma página, consulta um IP, um domínio ou um e-mail vazado, e desmonta os arquivos que você anexa. O que encontra volta como citação numerada. Metodologia, dados de CVE e o grafo de CVE até ATT&CK ficam no CKE 2.0, que tem página própria.

Ler a referência das ferramentas

Limite:

Não disponível

Ferramentas oferecidas ao modelo num turno do chat

Web ligada

Dados de rede ligados

Arquivo anexado

Pedido explícito

O que cada ferramenta entrega num trabalho real

Cada item termina com o limite, porque você vai bater nele.

Cybersecurity Knowledge Engine 2.0

Metodologia, comandos e docs de ferramentas, o espelho de CVE com CVSS, EPSS e KEV, e o grafo de CVE até técnica do ATT&CK. O modelo consulta por conta própria, a menos que você desligue o CKE 2.0 no compositor.

Abrir o CKE 2.0

Fontes externas

Writeups, changelogs, disclosures e índices de busca. O modelo lê e cita a URL.

Busca na web

web_search

Busca na web pública e devolve títulos, URLs e trechos das páginas. Resultados de NVD, cve.org, CISA, GitHub, Seclists, PortSwigger e OWASP vêm primeiro. Serve para advisories de fabricante, writeups de PoC e o que for mais novo que o modelo.

Até 10 resultados por chamada, em cache por 15 minutos. Resultado pode estar errado ou velho, então abra a citação antes de confiar.

Leitor de página

read_url

Baixa uma página pública como texto: o disclosure, as notas de patch, a política do programa. A requisição sai por uma egress protegida que confere cada endereço e redirecionamento e fixa a conexão no IP conferido.

http(s) público nas portas 80 e 443, HTML, texto, JSON ou XML, 10 MB e 15 segundos. Respeita o robots.txt. No chat, só abre URLs que você digitou ou que vieram de um resultado de busca, CVE, advisory ou CKE 2.0, então links dentro de uma página e resultados .onion ficam fechados.

Busca na dark web

darkweb_search

Consulta vários índices de busca Tor de uma vez e devolve título, URL .onion e trecho, com o índice de onde veio cada entrada. Use para achar o site de vazamentos de um grupo de ransomware ou um fórum que a web aberta não lista, e decida você o que abrir.

Só abre quando você pede: a mensagem precisa dizer dark web, deep web, .onion ou Tor, e citar um grupo de ransomware não basta. A busca nunca abre, rastreia ou baixa uma página listada, então cada entrada é não verificada e possivelmente hostil até você ler com o read_onion. Cinco buscas por minuto por usuário. Buscas por material de abuso infantil são recusadas e os resultados que batem são descartados.

Leitor de página .onion

read_onion

Lê uma página .onion por Tor e devolve o texto, para que um site de vazamento ou um post de fórum achado com o darkweb_search possa ser lido e citado no chat. O HTML vira texto e os scripts saem.

Só quando você pede dark web, e só endereços .onion v3 por Tor: sem clearnet, sem IP, sem redirect, sem cookie. Só texto, então imagem, arquivo compactado e binário são recusados. Uma página por chamada, sem rastrear, 60 segundos por página. Endereços e páginas com indício de abuso infantil são recusados antes do acesso e descartados depois.

Dados de rede

Consultas sobre a infraestrutura à sua frente: quem detém um endereço, para onde um domínio resolve, se um site responde. Elas leem registros, resolvedores e bases públicas e não mandam nada ao host. O port scan é a exceção, e a entrada dele diz isso.

IP e ASN

ip_info, asn_lookup

Geolocalização, provedor, organização, ASN e flags de hosting, proxy e móvel para um endereço ou um lote, com DNS reverso, status em blocklists de DNS e o registro regional com o contato de abuso, se você pedir. asn_lookup vai de um IP, um número de AS ou um nome de organização até o titular e as redes que ele anuncia.

Bases públicas atrasam e discordam entre si, e uma flag é indício, não atribuição. A checagem de blocklist cobre só IPv4.

Domínios

domain_info

Registros DNS, registro por RDAP com registrar, datas, name servers e DNSSEC, e autenticação de e-mail: MX, SPF e DMARC com aprovado ou reprovado.

Só resolvedores e registros públicos. O resultado fica em cache, então perguntar de novo logo em seguida traz a mesma resposta.

Sites

site_check

Se um site público responde, com código de status, tempo de resposta e servidor, e uma nota dos cabeçalhos de segurança: CSP, HSTS, X-Frame-Options e os demais.

Usa a origem e uma requisição comum. Dá nota aos cabeçalhos e não procura vulnerabilidade.

Exposição em vazamentos

breach_check

Confere um e-mail em dados públicos de vazamento: quantos vazamentos, quais serviços, o risco e se houve senha exposta.

Sabe o que os dados públicos de vazamento listam. Resultado limpo não quer dizer que o endereço nunca vazou.

Port scan

port_scan

Quais portas TCP de um host público estão abertas, entre as que você indicar ou um conjunto comum. Quem roda é um serviço de scan de terceiros, dos servidores dele e nunca da infraestrutura da NotHoly, e endereços privados, reservados e internos são recusados.

É tráfego ativo para o host, então aponte só para hosts que você pode testar. Um scan por resposta, e no CLI ele só roda depois que você confirma.

Seus arquivos

Anexe a amostra, o APK ou o bundle. Tudo passa por análise estática e nada do que você envia é executado.

Cada arquivo passa por análise estática num contêiner gVisor descartável, sem rede, com raiz somente leitura e sem segredos. Nada do arquivo é executado, então a análise vê só o que o parser estático alcança. Um arquivo acima dos limites ou uma falha do parser termina como rejeitado, com o motivo.

Binários

binary_info, disassemble

ELF, PE, Mach-O e DEX dão SHA-256, entropia e strings. ELF e PE somam formato, entry point, seções e funções importadas. Entropia alta e imports estranhos aparecem antes de você abrir um disassembler.

O disassembly é uma prévia: os primeiros 4 KB do arquivo decodificados como x86-64, no máximo 200 instruções. Não há decompilador nem grafo de fluxo, então mantenha o seu aberto.

Pacotes e APKs

archive_list

zip, tar, gzip, bzip2, xz, JAR e APK são percorridos entrada por entrada, e cada entrada passa pelos mesmos parsers. Entradas cifradas e symlinks são sinalizados e pulados.

Profundidade 3, 10.000 entradas, 2 GB expandidos e razão de 100:1. Uma zip bomb para com o motivo.

Texto e código

file_read, file_search

Código, logs, JSON, bundles minificados, PDF, arquivos do Office, HTML, XML e SVG chegam como texto com localizador de arquivo e linha. A busca por palavras cobre todos os anexos. Chaves AWS, tokens do GitHub e do Slack e chaves privadas geram aviso. Pickles são desmontados e nunca carregados.

200 MB por arquivo no chat e 5 milhões de caracteres de texto. Imagens dão só as dimensões, sem OCR.

Sua máquina

O único lugar onde comandos rodam de verdade, com a sua aprovação e na sua frente.

Agente do terminal

read, grep, glob, edit, write, bash

Lê, busca e edita o seu projeto e roda comandos localmente. No padrão, pergunta antes de cada escrita e de cada comando, mostrando o diff, e o modo plan só lê. Ler fora do projeto pergunta antes, abrir um arquivo de credencial exige digitar o nome de volta, e depois de uma leitura privada cada consulta de saída aparece para você antes de sair.

yolo só pergunta sobre arquivos de credencial. Exige --yolo a cada início e fica desligado durante um engagement.

Engagements

notholy engage

notholy engage init grava escopo, exclusões, janela de tempo e referência da permissão na sua máquina. Com um ativo, o agente lê os alvos de cada comando antes do bash rodar, faz você digitar o host para sair do escopo e acrescenta cada decisão a um log encadeado por hash. notholy connect claude instala a mesma checagem como hook.

Ele lê o texto do shell e não resolve DNS, então pega erro de operação e não é sandbox. Um alvo conhecido só em tempo de execução gera um aviso para você conferir.

A execução

O que você vê enquanto as ferramentas trabalham e o que as interrompe.

Painel de evidências

As citações abrem ao lado da resposta com a URL ou o localizador do arquivo, marcadas como observado no arquivo, fonte externa, CKE 2.0 ou índice da dark web.

A citação mostra de onde veio a afirmação. Se a fonte está certa, quem decide é você.

Linha do tempo

Cada chamada mostra o alvo e a duração enquanto acontece. A execução fica no servidor, então uma página recarregada retoma o stream de onde estava.

12 passos do modelo, 5 chamadas de ferramenta por vez, 60 segundos por ferramenta e 10 minutos por execução.

Projetos

Agrupe chats por engagement. Instruções e notas de escopo entram em toda execução do projeto.

As notas orientam o modelo e não colocam um alvo no escopo.

Qual ferramenta para qual trabalho

Engenharia reversa

Anexe o APK ou o ELF. binary_info traz imports, seções, entropia e strings, archive_list percorre o pacote e kb_search traz o teste do MASTG que se aplica.

binary_info

archive_list

file_search

kb_search

Pentest

Cole os banners do seu scan. cve_search filtra por fabricante e KEV e ordena por EPSS, e kb_search puxa o procedimento do WSTG. O agente da CLI roda suas ferramentas na sua máquina depois que você aprova o comando, e notholy engage confere cada um contra o escopo antes.

cve_search

kb_search

cve_lookup

notholy engage

Bug bounty

Anexe o lockfile ou o bundle minificado de um ativo em escopo. advisory_lookup confere cada versão fixada, file_search acha endpoints e chaves no código, e read_url lê a política do programa.

advisory_lookup

file_search

read_url

Red team

kb_search com domain attack ou offensive traz técnicas ATT&CK e entradas do LOLBAS e do GTFOBins com a fonte, e o plano cita o ID da técnica.

kb_search

kb_read

Análise de malware

Hashes, entropia, imports e strings saem do parser estático e nada é detonado. Pacotes são percorridos até a profundidade 3, e web_search pega o hash ou um domínio das strings.

binary_info

archive_list

file_read

web_search

Pesquisa de vulnerabilidade

cve_lookup dá o CWE e as versões afetadas, read_url lê o advisory ou as notas de patch, e kb_search traz a entrada do CWE e o guia de teste daquela classe.

cve_lookup

read_url

kb_search

OSINT e threat intel

web_search cobre o que está indexado na web aberta, e domain_info, ip_info e asn_lookup mapeiam a infraestrutura por trás de um nome. Quando você pede, darkweb_search lista entradas .onion de um grupo ou palavra-chave, e quem abre é você.

web_search

domain_info

ip_info

darkweb_search

Onde ele para

Nenhum tráfego dos nossos servidores para os seus alvos

As ferramentas do servidor leem. Nenhuma faz scan, sondagem ou envia payload a partir da infraestrutura da NotHoly. read_url chega a páginas públicas pela egress protegida, e o port_scan, a única ferramenta que manda tráfego a um host, roda num serviço de terceiros, dos servidores dele.

A CLI age na sua máquina

O agente do terminal roda read, grep, glob, edit, write e bash localmente, com a sua aprovação. No modo padrão ele pergunta antes de cada escrita e de cada comando, e o modo plan só lê.

Conteúdo externo vem marcado como dado

Páginas, arquivos e resultados de busca chegam ao modelo entre marcadores com id aleatório, marcados como conteúdo não confiável.

read_url continua passivo

Recusa IP literal, strings de ataque e caminhos de arquivo exposto como /.git e /.env, e para depois de 40 caminhos distintos num host em 10 minutos. Uma URL que carrega texto de um arquivo anexado ao chat também é recusada.

O que cada superfície pode chamar

O chat decide a cada turno quais ferramentas oferecer. A CLI, o MCP e a Research API entregam os mesmos dados sob o seu controle.

| Capacidade | Chat | CLI | MCP | Research API |
| --- | --- | --- | --- | --- |
| Busca na web | web_search | agent: web_search | web_search | POST /v1/web/search |
| Leitor de página | read_url | — | read_url | POST /v1/web/read |
| Busca na dark web | darkweb_search | — | darkweb_search | — |
| Leitor de página .onion | read_onion | — | — | — |
| Dados de rede | ip_info · domain_info · asn_lookup · site_check · breach_check · port_scan | agente: my_ip · port_scan | ip_info · domain_info · asn_lookup · site_check · breach_check · port_scan | — |
| Registro de CVE | cve_lookup | notholy cve · agent: cve_lookup | cve_lookup | GET /v1/cve/{id} |
| Busca de CVE | cve_search | notholy cve search | cve_search | GET /v1/cve/search |
| Advisories de pacote | advisory_lookup | — | advisory_query | POST /v1/advisories/query |
| CKE 2.0 | kb_search · kb_read | notholy kb · agent: kb_search | kb_search · kb_read | GET /v1/kb/search · GET /v1/kb/{id} |
| Grafo de entidades | kb_related | — | — | — |
| Análise de arquivos | file_list · file_read · file_search · binary_info · archive_list · disassemble | notholy analyze | analyze_file | POST /v1/files · GET /v1/files/{id} |
| Arquivos locais e comandos | — | agent: read · grep · glob · edit · write · bash | — | — |
| Escopo e log de engagement | — | notholy engage | — | — |

POST /v1/chat/completions, /v1/responses e /v1/messages são os endpoints crus dos modelos e não têm nenhuma dessas ferramentas. O modelo recebe só as function tools que você manda, e quem as executa é o seu código. Para usar esses dados no seu código, chame a Research API ou o MCP.

Canonical: https://notholy.com/pt-br/tools
