**[→ 完全なリリースノート](https://github.com/tiliondev/fortress/releases/tag/v151.0.7908.0)**


## 目次

| | |
|---|---|
| **[概要](#what-it-is)** · **[クイックスタート](#quick-start)** | 概要、インストール、最初のスクリプト、AIエージェントのセットアップ |
| **[Fortress MCP](#the-fortress-mcp--stealth-browsing-as-agent-tools)** | AIエージェント向けの29のステルスブラウザツール（ベータ版） |
| **[なぜエンジンにパッチを当てるのか、ページではないのか](#why-patch-the-engine-not-the-page)** | 自己暴露型JSのテーゼ＋3つの検出レイヤー |
| **[Fortressの比較](#how-fortress-compares)** | puppeteer-stealth、Camoufox、CloakBrowser、クローズドベンダーとの比較 |
| **[証明：ライブ検出器の結果](#proof-live-detector-results)** | CreepJS、Sannysoft、BrowserScan、Cloudflare（スクリーンショット付き） |
| **[ペルソナの設定](#configure-the-persona)** | `--uxr-*`フィンガープリント面 |
| **[お使いのスタックとの連携](#works-with-your-stack)** | browser-use · Crawl4AI · Stagehand · LangChain |
| **[ビルドと検証](#build--verify)** | ソースからの再現、来歴の検証 |
| **[リファレンス](#reference)** | トラブルシューティング、FAQ、ロードマップ、リポジトリレイアウト |

---

## 概要

Fortressは、エンジン内部からブラウザフィンガープリントを偽装するChromiumフォークです。ボット検出器が読み取るサーフェス（canvas、WebGL、audio、fonts、navigator、および約30以上のその他）は、Chromiumの**C++**で修正されており、ページがキャッチできるJavaScriptパッチレイヤーはその上にはありません。

通常のブラウザバイナリとして提供され、CDPエンドポイントを公開します。Playwright、Puppeteer、または任意のCDPクライアントをそれに向けると、既存の自動化が変更なしで実行されます。

JavaScriptステルスパッチは、ページが見つけられる余分なレイヤーを残します：`.toString()`はオーバーライドのソースを表示し、iframeやワーカーから同じプリミティブを再取得すると、それを超えてしまいます。Fortressは代わりにエンジン内のサーフェスを修正するため、`navigator.vendor`は本当のC++ゲッターに解決され、`[native code]`を報告し、すべてのレルムから同じ値を読み取ります。ページが自身を検査すると、標準のChromiumが見えます。そのため、以前はフラグが立てられていた場所でも自動化が通過し、残っているブロックはプロキシと行動に起因するものであり、ブラウザには起因しません。[なぜエンジンにパッチを当てるのか、ページではないのか](#why-patch-the-engine-not-the-page)で検出メカニズムの全容を説明しています。```python
from tilion_fortress import Fortress
from playwright.sync_api import sync_playwright

with Fortress() as f:                                   # launches the stealth engine on a CDP endpoint
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(f.cdp_url)
        page = browser.new_page()
        page.goto("https://bot.sannysoft.com")
        page.screenshot(path="all-green.png")

import { Fortress } from "tilion-fortress";
import { chromium } from "playwright";

const f = await Fortress.launch();                      // stealth engine on a CDP endpoint
const browser = await chromium.connectOverCDP(f.cdpUrl);
const page = await browser.newPage();
await page.goto("https://browserscan.net");
await browser.close();
await f.close();

> [!TIP]
> SDK にはコンパイル済みビルドに加えて **`patches/`** が同梱されています。そのため、エンジンを自分でリビルドし、すべての表面修正をソースに対して検証できます。ダウンロードは、リリースの `SHA256SUMS` に対して自動的に SHA-256 検証されます。

### バージョン

Fortress は **2つの Chromium ベース** で提供されます。普及度と最新性のトレードオフを選択してください:

| チャンネル | Chromium | 使用するタイミング |
|---|---|---|
| **`stable`** *(デフォルト)* | **149** | 推奨 — 実際のユーザーの大多数が使用している Chrome バージョンと一致するため、最も自然に溶け込みます |
| **`latest`** | **151** | 最新のエンジン（stable よりわずかに新しいバージョンとして報告されます） |```python
Fortress().start()                     # Python: stable (149) by default
Fortress(channel="latest").start()     # opt into 151

await Fortress.launch();               // Node: stable (149) by default
await Fortress.launch({ channel: "latest" });

docker run --rm -p 9222:9222 tilion/fortress:149   # or :151
# or set FORTRESS_CHANNEL=latest for either SDK

## The Fortress MCP — エージェントツールとしてのステルスブラウジング &nbsp;<sub>ベータ</sub>

Raw CDP は、あなたが書くコードのためのものです。**Fortress MCP** は、**ツール** を呼び出すエージェントのためのものです: Claude、Cursor、または任意の MCP クライアントにステルスブラウザを提供する [Model Context Protocol](https://modelcontextprotocol.io) サーバーで、フェッチがブロックされた瞬間にツールを呼び出してページを取得します。**29 のツール、ローカルで無料** — `fetch_protected_page`、`extract_page`、`crawl_site`、`recon_site_apis`、`search_web`、`run_browser_task`、`save_profile`、`get_stealth_cdp_endpoint` など。

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/795/8f328e2498b09d7433208c5b4a9002450643537f2ee6b0519ac10420ef581bf3.gif" alt="同じサイト、同じプロンプト: 通常のブラウザは PerimeterX によってブロックされるが、Fortress MCP を使用したエージェントはクリーン JSON を返す" width="760"/></p>

<sub><i>実際の、日付入りの実行結果: <b>stockx.com</b> (PerimeterX)。標準ブラウザは <b>HTTP 403 — “Access denied”</b> を受け取る一方、Fortress MCP を使用したエージェントはクリーンな JSON を返す — 同じサイト、同じプロンプト。フレームワークリポジトリから再現できます。</i></sub>

### 30秒でセットアップ

2つのランナー — 一つ選んでください。`npx` は PATH に Python が必要です；`pip` は直接インストールします：```bash
pip install "tilion[mcp]"      # command:  tilion-mcp
#   —or, zero-install—
npx -y tilion-mcp              # auto-runs the server via uv (no global install)

<sub>npxをお好みですか？ <code>"command": "npx", "args": ["-y", "tilion-mcp"]</code>を使用してください。Claudeを再起動すると、<b>fortress</b>ツールが表示されます。</sub>

**Claude Code** (CLI) — 一行:```bash
claude mcp add fortress -- tilion-mcp          # or:  claude mcp add fortress -- npx -y tilion-mcp

そして、エージェントに「このStockXページから価格を取得して」と指示するだけで、自動的に`fetch_protected_page`を呼び出します。

### エージェントが取得できるもの

| | tools |
|---|---|
| **ブロックされたページの取得** | `fetch_protected_page` · `read_page` · `get_page_html` · `search_web` |
| **構造化データ** | `extract_page` (schema-aware) · `extract_document` (PDF/DOCX/XLSX) |
| **サイト全体** | `crawl_site` (auto-SPA) · `recon_site_apis` (プライベートJSON APIを見つける) |
| **ページ操作** | `page_elements` · `click_button` · `fill_field` · `press_key` · `wait_for` · `evaluate_js` |
| **マルチステップフロー** | `run_browser_task` (ログイン, ページネーション, 無限スクロール, チェックアウト, …) |
| **キャプチャ / 認証** | `screenshot_page` · `save_page` · `download_file` · `save_profile` / `load_profile` |
| **独自のものを使用** | `get_stealth_cdp_endpoint` → Playwright / Puppeteer / browser-use 用のCDP URL |

ツールには注釈が付けられています（読み取りは自動承認、書き込みはゲート）、起動時に**プリウォーム**（最初の呼び出しは約100ms）、並行セーフ、タイムアウトおよびSSRF対策済み。**住宅用エグレス**を備えたホスト型エンドポイントが近日公開予定です。

→ 全29ツールのテーブル、ベンチマーク、エージェントスキル: **[`mcp/`](https://github.com/tiliondev/fortress/blob/HEAD/mcp/README.md)**

---

## なぜページではなくエンジンにパッチを当てるのか

通常のアプローチでは、`navigator.webdriver`にパッチを当て、WebGLベンダーを偽装し、スクリプトから`navigator.plugins`をオーバーライドします。しかし、CreepJSなどの検出器は依然としてそれを検出します。その理由は、**構造的**なものであり、単に別のプロパティが露出していないからではありません。JavaScriptによる偽装は、ネイティブ関数があるべき場所に置かれた関数です。検出器は返された値を脇に置き、それを返すものがネイティブかどうかを問い詰めます。

| 兆候 | JS偽装を検出する理由 |
|---|---|
| `toString`の自己開示 | ネイティブメソッドは `function get vendor() { [native code] }` のように文字列化されますが、オーバーライドは自身のソースコードを文字列化するため、`.toString()` を1回実行するだけで検出されます。 |
| ディスクリプタと`hasOwnProperty` | `getOwnPropertyDescriptor` は再定義されたプロパティを公開し、`hasOwnProperty('toString')` は改ざんされた関数では `true` を返しますが、ネイティブ関数では `false` を返します。 |
| `failsTypeError` | ネイティブゲッターは間違った `this` に対して特定の `TypeError` をスローします。単純なシムは沈黙しますが、その沈黙が合図となります。 |

レルム再取得は、すべてのメインワールドパッチを無効にするものです。検出器は別のレルムからプリミティブなプリミティブを取得し、あなたの関数に適用します。```js
const iframe = document.createElement('iframe'); document.body.appendChild(iframe);
const realToString = iframe.contentWindow.Function.prototype.toString;
realToString.call(navigator.__lookupGetter__('vendor')); // returns your source code. Caught.

| 環境変数 | 目的 |
|---|---|
| `TILION_NO_DEFAULTS=1` | デフォルトのペルソナをスキップ (ベア起動) |
| `TILION_TZ` / `TILION_LANG` | タイムゾーン / 言語のクイックオーバーライド |

> [!NOTE]
> **現在、ペルソナはコマンドライン上で動作します。** `--uxr-*` スイッチは `/proc/<pid>/cmdline` 経由で全プロセスから読み取り可能なため、起動ごとに1つのペルソナとなり、ホスト上の他のプロセスからも見えます。次に `MaskConfig` ランタイムが導入されます: これはIPC経由でペルソナを配信し、1プロセスあたりの制限を解除します ([今後の予定](#whats-next) を参照)。

---

## あなたのスタックと連携

Fortress は `:9222` で生のCDPを公開しているため、Playwright、Puppeteer、またはCDPを話すあらゆるものにシームレスに統合できます。

| フレームワーク | 接続方法 |
|---|---|
| [**browser-use**](https://github.com/browser-use/browser-use) (〜7万スター) | `cdp_url="http://localhost:9222"` |
| [**Crawl4AI**](https://github.com/unclecode/crawl4ai) (〜5.8万スター) | CDP エンドポイント |
| [**Stagehand**](https://github.com/browserbase/stagehand) (〜2.1万スター) | `connectOverCDP` |
| [**LangChain**](https://github.com/langchain-ai/langchain) Playwright ツールキット | Playwright CDP |
| **Playwright / Puppeteer** (Python & JS) | `connect_over_cdp` / `connect` |```python
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")   # Fortress under the hood

出力先: `out/Fortress/chrome`。フォークは34個の小さな単一面のパッチ（`patches/`）で構成されているため、ほとんどのパッチは上流リリースにクリーンに再適用されます。その後、ガントレットがリグレッションの発生を検知するとリリースを差し止めます。

| プラットフォーム | ステータス |
|---|---|
| Linux x64 (ネイティブ) · **Windows x64 (ネイティブ)** · Docker経由の任意のOS | <img src="https://raw.githubusercontent.com/tiliondev/fortress/HEAD/docs/assets/icons/check.svg" width="15" alt="yes"> **提供中** |
| コード署名付きインストーラー · macOS `.app` · `linux/arm64` | 進行中 |

### 本当に私たちのものか確認する

Fortressは4つの公式チャネルから提供されています。それ以外のものは信頼できないものとして扱ってください。

| | 公式ソース |
|---|---|
| **ソース** | [github.com/tiliondev/fortress](https://github.com/tiliondev/fortress) |
| **Docker** | [`tilion/fortress`](https://hub.docker.com/r/tilion/fortress) |
| **Python** | [`tilion-fortress`](https://pypi.org/project/tilion-fortress/) |
| **Node** | [`tilion-fortress`](https://www.npmjs.com/package/tilion-fortress) |

**ダウンロードを検証する。** 各リリースには`SHA256SUMS`が含まれており、`pip`/`npm` SDKはインストール時にこれを自動的に実行します:```bash
BASE=https://github.com/tiliondev/fortress/releases/download/v151.0.7908.0
curl -LO $BASE/tilion-fortress-linux-x64.tar.gz
curl -Ls $BASE/SHA256SUMS | sha256sum -c --ignore-missing     # -> OK

**何も信頼せず、再構築してください。** フォーク全体は `patches/` にある34の読み取り可能なパッチです；`build/build.sh` はChromiumソースからバイナリを再現するので、自分でビルドしたものと配布物の差分を確認できます。

---

## 参考情報

<details><summary><b>トラブルシューティング</b></summary>

<br/>

**Cloudflare、DataDome、Kasadaでまだブロックされる場合。** ほとんどの場合、これはあなたの**IP**の問題であり、フィンガープリントではありません。ページスクリプトが実行される前にデータセンターレンジがフラグされます。発信を住宅用プロキシまたはモバイルプロキシ経由でルーティングして再試行してください。解除されれば、フィンガープリントは問題ありませんでした。

**Linuxホストでフィンガープリントがおかしい場合。** デフォルトのペルソナはWindowsですが、TLSシェイプや一部のOS向けシグナルは、そのマシンの実OSに従います。ペルソナを発信元OSに合わせるか、関連する `--uxr-*` フラグを設定して、OS設定とトラフィックの発信元を一致させてください。

**macOSはDockerイメージをプルします。** 現在、ネイティブのLinux + Windowsバイナリを提供しています。macOSは依然として公式Dockerイメージ（`tilion/fortress`）を介してFortressを実行します。Docker Desktopをインストールするか、Linux/Windows x64でネイティブバイナリを実行してください。

**ペルソナが `/proc/<pid>/cmdline` に表示される場合。** `--uxr-*` フラグはホスト上の他のプロセスから読み取り可能で、起動ごとに1つのペルソナが設定されます。ランタイムの `MaskConfig` が実装されるまでは、プロセスごとに1つのペルソナを維持し、信頼できないコードとホストを共有しないでください。

**検出器が何かをフラグするが、テストセットは通過する場合。** 検知技術は常に進化しています。現在のChromiumリベースを使用していることを確認し、テストページとともにissueを開いてください。そのページが次のパッチになります。

</details>

<details><summary><b>FAQ</b></summary>

<br/>

**これは合法ですか？** Fortressは、公開データの正当な自動化、テスト、スクレイピングのためのブラウザエンジニアリングプロジェクトです。各サイトの利用規約とお住まいの地域の法律を尊重してください。

**本当に無料ですか？** はい。BSD-3ライセンスで、完全にオープンでセルフホスティング可能です。パッチシリーズも公開されているので、現在のエンジンをソースから自分でビルドできます。

**なぜpuppeteer-stealthやundetected-chromedriverを使わないのですか？** それらはページがブラウザを検査できるようになった*後*でJS/CDPレイヤーにパッチを当てるため、`toString`やレルム再取得によって自己露出します。Fortressは偽装をC++に移し、ページがネイティブコードを発見するようにします。（「なぜエンジンにパッチを当てるのか、ページではないのか」を参照）

**Camoufoxとの違いは？** C++インターセプションという同じアイデアです。CamoufoxはFirefoxをフォークしています（トラフィックの約3%、常に異常値として扱われます）が、FortressはChromiumとV8（主要エンジン）をフォークするため、Chromeユーザーエージェントが構造的に一貫します。

**永遠にすべてを通過し続けますか？** いいえ。検知技術は常に進化するため、日付付きで再現可能なテストセットと毎月のChromiumリベースを提供します。現在何が通過するかを正確に確認できます。

</details>

<details><summary><b>ロードマップ</b></summary>

<br/>

- [ ] ランタイムJSON設定をC++の `MaskConfig` に統合（1つのバイナリで多くの一貫したフィンガープリント、コマンドラインには何も表示されない）
- [ ] ファーストパーティMCPサーバーとPuppeteer / raw-CDP SDK（AIエージェント用のドロップイン）
- [ ] コード署名されたWindows `.exe` とmacOS `.app`
- [ ] `linux/arm64` Dockerイメージ
- [ ] `patches/` をBraveスタイルの `chromium_src/` オーバーライドに移行
- [ ] reCAPTCHA v3 / DataDome / Kasadaのベンチマーク行を公開（日付付き、再現可能）

</details>

<details><summary><b>リポジトリ構成</b></summary>```
patches/     34 per-surface C++ patches (+ series), the source of truth for the fork
build/       args.gn, build.sh, apply-patches.sh, rebase-monthly.sh, windows/, macos/
packaging/   tilion launcher, fonts.conf, Dockerfile, .deb + bundle builders
fonts/       33 metric-compatible Windows-named fonts (incl. color emoji)
sdk/         python + node (tilion-fortress) prebuilt-binary SDKs
tools/       gauntlet.py, the CreepJS / Sannysoft / BrowserScan CI gate
docs/        GAUNTLET_RESULTS, BUILD_NATIVE, BENCHMARK