はじめに

Guida は WebView2 を基盤にした Windows ブラウザー自動化システムです。Guida Complete は通常のデスクトップアプリです。Guida Node はブラウザーとワークスペース自動化向けの headed リモート executor です。どちらも Remote Ops を公開でき、MCP はローカル AI エージェント連携のサーフェスとして残ります。

Guida Control は、ブラウザーで利用する独立した運用アプリです。Remote Ops を介して Complete または Node に接続し、ノードのワークスペースファイルやデータベースを直接読みません。現在のアルファ版の境界は Guida Control を参照してください。

初日にすべての機能を理解する必要はありません。最初に達成したい目的から読み始めてください。

入口を選ぶ

ブラウザー作業を自分で自動化したい

クリック、入力、ページ移動、コンテンツ抽出、自作スクリプトの実行から始める場合の入口です。

1. Guida をインストール
2. 最初のスクリプトを実行
3. レシピ ページを開いて調べるを試す
4. Tools > Developer > Generate Scripting Support Files… でエディター補完、言語ガイド、ローカル LLM 用コンテキストファイルを生成する

AI エージェントに監督付きで操作させたい

Claude Code、Claude Desktop、その他の MCP クライアントに、承認、ドメイン制御、監査ログ付きで Guida を操作させる場合の入口です。

1. MCP 連携を読む
2. ワークスペースを開き、エージェントがプロジェクトローカルのスクリプトと設定を使えるようにする
3. 繰り返し使うワークスペース固有の操作がある場合はカスタムツールを追加する
4. オープンソースとクローズドソースで、何がローカルに残り、何が監査証跡に記録され、どの抽出層が非公開かを確認する

データを抽出して保存したい

抽出、ローカル保存、外部システムへの受け渡しが最初の目的である場合の入口です。

1. クイックスタートでスクリプトの基本サイクルを覚える
2. レシピ ページデータを抽出して保存するを試す
3. g.store、g.queue、g.search、S3 互換ストレージ、MongoDB、PostgreSQL、Elasticsearch についてデータとストレージを読む
4. 外部データベースやオブジェクトストレージが必要な場合はデータベース連携を使う

キューとワーカーを使いたい

大量の URL やレコードを複数のブラウザータブで処理する場合の入口です。

1. ワークスペースを開き、Guida がキューとストレージ用データベースを作成できるようにする
2. レシピ URL をキューに入れて処理するを試す
3. 宣言的またはプログラム的なワーカープールについてキューワーカーを読む
4. レシピ 並列ワーカーを実行するを試す

リモート実行ノードを使いたい

別のマシンで headed ブラウザー自動化、ワークスペースワーカー、キュー、Remote Ops を実行し、信頼済みのプライベートチャネル経由で制御したい場合の入口です。

1. リモート実行が明確に必要な場合だけ Guida Node をインストールします。通常は Guida Complete をインストールします
2. Guida Complete と Guida Node のどちらを使うべきかはインストールで確認します
3. 信頼済みチャネルの JSON-RPC 制御プレーンについて Remote Ops APIを読みます
4. クライアントがライブのブラウザータブをストリーミングまたは制御する場合は Remote Viewを使います

ローカル LLM 機能を使いたい

スクリプトからローカルモデルで分類、要約、データ抽出を行う場合の入口です。

1. LLM 設定で Ollama または LlamaSharp を設定する
2. レシピ ローカル LLM に問い合わせるを試す
3. g.llm.promptLocalLlm() と HTTP ヘルパーについて AI、HTTP、ツールを読む
4. バッチ分類や抽出では LLM 呼び出しとキューワーカーを組み合わせる

セキュリティと認証情報を理解したい

機密性の高いワークフロー、API 認証情報、AI 支援ナビゲーションを評価する場合の入口です。

1. MCP 連携で許可済みドメイン、ツール承認、監査ログを確認する
2. 認証情報で DPAPI 暗号化と MCP 由来スクリプトの制限を読む
3. オープンソースとクローズドソースで公開インフラと非公開の製品層の境界を理解する
4. PostgreSQL、MongoDB、S3 互換ストレージ、Elasticsearch の接続情報を使う場合はデータベース連携を読む

よくある最初の作業

作業	入口
Guida をインストールする	インストール
Complete と Node を選ぶ	インストール
最初のスクリプトを実行する	クイックスタート
ワークスペースを開く	ワークスペース
MCP クライアントを接続する	MCP 連携
リモートノードを制御する	Remote Ops API
認証情報を安全に使う	認証情報
キューワーカーを実行する	キューワーカー
抽出データを保存または検索する	データとストレージ
ネットワーク通信を記録する	レシピ: ネットワーク通信を記録する

仕組み

スクリプトは g.* API を使ってブラウザータブを操作し、DOM を調べ、データを保存し、キューを処理し、ローカル LLM を呼び出し、ワークスペースサービスへ接続します。JavaScript と Janet のメソッドは値を直接返し、失敗時には例外を投げます。Lua は複数戻り値を使います。

await g.nav.navigateToUrl("https://example.com");
await g.dom.waitForDomStable();

const html = await g.page.getDom();
g.store.put("pages", "example", { html });

すべては手元のマシンで動きます。ワークスペースデータはワークスペースフォルダーに残り、アプリケーション状態は Windows ユーザープロファイルに残ります。Guida はアカウント、テレメトリ、クラウド同期を必要としません。