Registro de Transformações OGI

Transformações comunitárias para OGI, uma ferramenta OSINT e de análise de links de código aberto.

Como funciona

Cada diretório em transforms/ é uma transformação instalável de forma independente. A CLI do OGI e a IU do Transform Hub leem index.json (gerado automaticamente a cada merge) para descobrir o que está disponível.

Instalar uma transformação

Use a CLI do projeto backend do OGI:

cd backend
uv sync
uv run ogi transform search shodan
uv run ogi transform install shodan-host-lookup

Ou use a IU do Transform Hub dentro do OGI.

Substituições de limites em tempo de execução

As transformações comunitárias neste registro herdam as substituições de limites de transformação do lado do host do OGI. Os operadores podem limitar ou remover centralmente configurações máximas comuns, como max_results, max_urls, max_links, max_content_chars ou timeout_seconds com a env var do backend:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=50,max_urls=25,max_links=40

Para remover um limite em uma implantação local:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

Isso é configurado no aplicativo principal do OGI, não neste repositório de registro.

Transformações integradas (incluídas no OGI)

Contribuir com uma transformação

1. Faça um fork deste repositório
2. Adicione sua transformação em transforms/<category>/<slug>/
3. Inclua plugin.yaml, README.md e transforms/*.py
4. Declare segredos necessários em api_keys_required, não em transform_settings
5. Abra um PR - o CI valida automaticamente

Ao adicionar configurações limitadas, prefira nomes comuns como max_results, max_urls, max_links, max_content_chars ou timeout_seconds, a menos que a configuração seja genuinamente específica da transformação. Isso mantém as substituições do lado do operador previsíveis em todo o ecossistema.

Veja o CONTRIBUTING.md para o guia completo.

Licença

AGPLv3