
Python製CTI向けエージェントメモリ — STIXナレッジグラフ、脅威アクターのエイリアス解決、オフラインファーストRAG、Claude CodeおよびLangChainエージェント向けMCPサーバー
サイバー脅威インテリジェンスのために作られた唯一のエージェント型メモリシステム。
シニアアナリストが退職すると、2〜3年分のコンテキストも一緒に失われます。顧客環境、過去の調査、アクターのTTP、誤検知のパターン、そして「待って、これ前に見たぞ」という苦労して得た知見のすべてです。ZettelForgeは、そのコンテキストをチームに留めておくために作られたエージェント型メモリシステムです。
アナリストのノートや脅威レポートからCVE、脅威アクター、IOC、ATT&CKテクニックを抽出し、エイリアス(APT28 = Fancy Bear = STRONTIUM = Sofacy)を解決し、STIX 2.1ナレッジグラフを構築して、過去のあらゆる調査をアナリストに、そしてMCP経由でClaude Codeに、自然言語で提供します。すべてインプロセスで動作します。APIキー不要。クラウド不要。データがホストの外に出ることはありません。
Star · pip install zettelforge · Docs · ThreatRecall (hosted) · Changelog
v2.6.2(2026-04-27):設定Webエディタが、すべてのenumフィールド(LLM/埋め込みプロバイダー、ログレベル、PIIアクション、合成フォーマット)に対して動作するドロップダウンと、機能するApplyボタンを備えて提供されます。新しい
[crewai]エクストラはZettelForgeをCrewAIツールとして公開します --pip install zettelforge[crewai]。完全な変更履歴
ZettelForgeがあなたの運用するCTIワークフローに合うなら、スターがこのカテゴリに投資を続ける価値があるという最も手早いシグナルになります。
Python 3.11以降と新しい仮想環境を使用してください。このセキュリティ アップデートでは、上流がパッチ適用済みの依存関係をサポートするまで、Maigretの ユーザー名検出を一時的に無効化します。その他のOSINTコレクターは引き続き利用可能です。 詳細はセキュリティとアップグレードの注意事項を参照してください。
どのSOCもアナリストを失います。彼らが去るとき、調査のコンテキスト、アクターの帰属、環境固有の誤検知パターンも一緒に失われます。後任者は同じチケットを再び開き、同じレポートを読み直し、同じメンタルモデルをゼロから再構築します。
汎用のAIメモリシステムは、セキュリティチームにとってこれを解決できません。APT28とFancy Bearを区別できず、CVE-2024-3094がXZ Utilsのバックドアであることを知らず、SigmaやYARAを解析できず、MITRE ATT&CKテクニックIDという概念も持ちません。CTIアナリストが1年分のインテリジェンスレポートを渡しても、返ってくるのはチャット履歴に対する曖昧なセマンティック検索だけです。
ZettelForgeは、脅威グラフで考えるアナリストのために作られました。CVE、脅威アクター、IOC、ATT&CKテクニックを自動的に抽出し、命名規則をまたいでエイリアスを解決し、因果関係を備えたナレッジグラフを構築し、意図を認識したブレンド検索を用いてメモリを取得します -- すべてインプロセスで、外部APIへの依存はありません。
メモリ拡張により、CTIタスクにおける小規模モデルと大規模モデルの差の33%が埋まる(CTI-REALM, Microsoft 2026、大規模モデルのベースラインとしてGPT-4を使用)。手法と比較の詳細は完全なベンチマークレポートを参照。
| 機能 | ZettelForge | Mem0 | Graphiti | Cognee |
|---|---|---|---|---|
| CTIエンティティ抽出(CVE、アクター、IOC) | 対応 | 非対応 | 非対応 | 非対応 |
| STIX 2.1オントロジー | 対応 | 非対応 | 非対応 | 非対応 |
| 脅威アクターのエイリアス解決 | 対応(APT28 = Fancy Bear) | 非対応 | 非対応 | 非対応 |
| 因果トリプルを用いたナレッジグラフ | 対応 | 非対応 | 対応 | 対応 |
| 意図分類に基づく検索(5種類) | 対応 | 非対応 | 非対応 | 非対応 |
| インプロセス動作/外部API不要 | 対応 | 非対応 | 非対応 | 非対応 |
| OCSFスキーマでの監査ログ | 対応 | 非対応 | 非対応 | 非対応 |
| MCPサーバー(Claude Code) | 対応 | 非対応 | 非対応 | 非対応 |
エンティティ抽出 -- CVE、脅威アクター、IOC(IP、ドメイン、ハッシュ、URL、メール)、MITRE ATT&CKテクニック、キャンペーン、侵入セット、ツール、人物、場所、組織を自動的に識別します。正規表現 + LLM NERをSTIX 2.1タイプ全体で使用します。
ナレッジグラフ -- エンティティはノードになり、共起はエッジになります。LLMが因果トリプルを推論します(「APT28がCobalt Strikeを使用」)。時間的エッジと置換(supersession)により、インテリジェンスがどのように進化するかを追跡します。
エイリアス解決 -- APT28、Fancy Bear、Sofacy、STRONTIUMはすべて同じアクターノードに解決されます。保存時と検索時に自動的に機能します。
ブレンド検索 -- ベクトル類似度(768次元fastembed、ONNX)+ グラフ走査(ナレッジグラフのエッジに対するBFS)を、意図分類によって重み付けします。5つの意図タイプ:事実、時間、関係、探索、因果。
メモリ進化 -- evolve=Trueを指定すると、新しいインテリジェンスが既存のメモリと比較されます。LLMがADD、UPDATE、DELETE、またはNOOPを決定します。古いインテリジェンスは置換されます。矛盾は解決されます。重複はスキップされます。
RAG統合 -- direct_answer形式で、保存されたすべてのメモリにわたって回答を統合します。
アーキテクチャによるインプロセス動作 -- 埋め込みにはfastembed(ONNX)、オプションのローカルLLM推論にはllama-cpp-python、ストレージにはSQLite + LanceDB、デフォルトではlocalhost上のOllamaを使用します。外部APIキーは不要です。初回実行時に埋め込み/LLMモデルをダウンロードする際に外部ネットワークアクセスが発生する場合がありますが、モデルを事前にロードした後は完全にオフラインで動作できます(エアギャップされたホストを含む)。
OCSFスキーマでの監査ログ -- すべての操作は、Open Cybersecurity Schema Framework形式の構造化イベントを出力します。ログストリームをどう扱うか(SIEM、WORMストア、何もしない)はあなた次第です。
pip install zettelforge
from zettelforge import MemoryManager
mm = MemoryManager()
# Store CTI -- entities (CVEs, actors, ATT&CK IDs, IOCs) extracted via regex
mm.remember("APT28 uses Cobalt Strike for lateral movement via T1021")
mm.remember("APT28 (Fancy Bear) targets NATO defense contractors with spear-phishing")
mm.remember("CVE-2024-3094 is the XZ Utils backdoor (CVSS 10.0) affecting sshd")
# Recall blends vector + graph search; alias resolution kicks in (Fancy Bear -> APT28)
for note in mm.recall("What tools does Fancy Bear use?", k=3):
print(f"[{note.metadata.tier}] {note.content.raw}")
これは新規の pip install で動作し、外部サービスは不要です。埋め込みは fastembed によりプロセス内で実行されます(初回呼び出し時に約80MBのONNXモデルがダウンロードされます)。MemoryManager() はデフォルトで ~/.amem/ に書き込みます。ZETTELFORGE_DATA_DIR または設定で上書きできます。実行可能なコピーは examples/quickstart.py にあります。
ollama pull qwen3.5:9b && ollama serve
# With Ollama running, synthesize() returns a real summary across stored notes
answer = mm.synthesize("Summarize known APT28 TTPs")
print(answer["synthesis"]["answer"])
# Background LLM NER also enriches stored notes with additional entities
ZettelForge は Ollama を自動検出します。別のプロバイダー(local の llama-cpp、100 以上のプロバイダー向けの litellm、テスト用の mock)を使用するには、Configuration を参照してください。LLM がない場合でも、synthesize() は構造化されたレスポンスを返しますが、answer フィールドはフォールバックのプレースホルダーになります。pip-only モードでは、remember と recall のみが有用な結果を生成します。
# New intel arrives -- evolve=True enables memory evolution:
# LLM extracts facts, compares to existing notes, decides ADD/UPDATE/DELETE/NOOP
mm.remember(
"APT28 has shifted tactics. They dropped DROPBEAR and now exploit edge devices.",
domain="cti",
evolve=True, # existing APT28 note gets superseded, not duplicated
)
remember() を呼び出すたびに、パイプラインが起動します: