OGI トランスフォームレジストリ

OGI（オープンソースのOSINTおよびリンク分析ツール）向けのコミュニティトランスフォームです。

仕組み

transforms/以下の各ディレクトリは、個別にインストール可能なトランスフォームです。OGI CLIとTransform Hub UIはindex.json（マージごとに自動生成）を読み取り、利用可能なものを検出します。

トランスフォームのインストール

OGIバックエンドプロジェクトからCLIを使用します：

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

または、OGI内のTransform Hub UIを使用します。

ランタイムキャップオーバーライド

このレジストリのコミュニティトランスフォームは、OGIのホスト側トランスフォームキャップオーバーライドを継承します。オペレーターは、バックエンドの環境変数を使用して、max_results、max_urls、max_links、max_content_chars、timeout_secondsなどの一般的な最大設定を一元的に制限または削除できます：

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

ローカルデプロイメントでキャップを削除するには：

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

これはメインのOGIアプリで設定され、このレジストリリポジトリでは設定しません。

組み込みトランスフォーム（OGIに同梱）

カテゴリ	トランスフォーム
DNS	domain-to-ip, domain-to-mx, domain-to-ns, ip-to-domain, whois-lookup
証明書	domain-to-certs, cert-transparency
メール	domain-to-emails, email-to-domain
IP	ip-to-asn, ip-to-geolocation
ソーシャル	username-search
ハッシュ	hash-lookup
Web	domain-to-urls, url-to-headers, url-to-links, url-to-content, content-to-iocs
インフラストラクチャ	organization-to-team-members

トランスフォームのコントリビュート

このリポジトリをフォーク
transforms/<category>/<slug>/ 以下にトランスフォームを追加
plugin.yaml、README.md、transforms/*.py を含める
必要なシークレットは api_keys_required に宣言し、transform_settings には宣言しない
PRを開く - CIが自動的に検証

キャップ付き設定を追加する場合は、設定が本当にトランスフォーム固有でない限り、max_results、max_urls、max_links、max_content_chars、timeout_secondsなどの一般的な名前を優先してください。これにより、エコシステム全体でオペレーター側のオーバーライドが予測可能になります。

詳細なガイドは CONTRIBUTING.md を参照してください。

ライセンス

AGPLv3

ogi-transforms

人気