読み込み

Echolotは、他のツールにある既存のデータをワークスペースに読み込みます。リクエスト、フォルダ、認証、変数、環境、スクリプトが対象です。 形式は内容から判別し、認証情報はキーチェーンに移し、取り込めなかった内容はレポートで知らせます。

Echolotが読み込むものCopy Anchor Link

コレクション、仕様、HARファイル、Brunoフォルダは、その名前の専用フォルダに取り込まれます。cURLコマンドは1件のリクエストになります。

Claude Desktop、Claude Code、Cursor、VS Code、CodexのMCPサーバ設定も、MCPサーバとして読み込めます。サーバの追加を参照してください。

アプリで読み込むCopy Anchor Link

次のどの方法でも読み込めます。読み込み先は、サイドバーで選択しているフォルダ、または選択がなければワークスペースの最上位です。

• ファイル › 読み込む…（⇧⌘I）、またはサイドバーの+メニューやコマンドパレットの読み込む…。1つまたは複数のファイル、あるいはBrunoのコレクションフォルダを選びます。
• ファイルやBrunoフォルダを、ウインドウのコンテンツパネルのどこか、またはサイドバーのフォルダにドロップします。
• cURLコマンド、またはコレクションや仕様のテキストを、サイドバーにペーストします（サイドバーにフォーカスして⌘V）。
• リクエストのアドレスフィールドにcURLコマンドをペーストします。この方法ではリクエストは新規作成されません。開いているリクエストのメソッド、アドレス、ヘッダー、ボディ、認証、設定が置き換わり、名前と位置は変わりません。 使えなかった内容は、アドレスバーの下にcURLの注記として一覧表示されます。

読み込みレポートCopy Anchor Link

読み込みが終わると、レポートが開きます。タイトルには取り込んだ内容が表示されます（「22件のリクエスト、7件のフォルダを読み込みました」）。その下に、読み込み元の形式と、すべて読み込めたかどうかが表示されます。続いて、ファイルごとに次の内容が並びます。

• そのままでは取り込めなかった内容についての注記。注記なしに捨てられるものはありません。
• シークレット：ファイルではなくキーチェーンに保存された値の名前。値そのものは表示されません。

サイドバーに表示で読み込んだ項目が選択されます。完了でレポートが閉じます。注記のない単独のcURLコマンドは、レポートなしですぐに開きます。

シークレットはキーチェーンへCopy Anchor Link

ワークスペースのファイルには、パスワード、トークン、キーが平文で書き込まれることはありません。そのため、Gitにコミットできます。

• リクエストに入力された認証情報（認証、Authorizationヘッダー、APIキーのヘッダー）は、リクエストとフィールドの名前が付いたシークレット変数になります。 たとえばcurl -u heidi:alpenglow https://demo.echolot.dev/echo/basic-auth/heidi/alpenglowは、heidi-alpenglowというリクエストを作り、パスワードは{{heidi_alpenglow_password}}になります。値はキーチェーンに保存されます。
• 環境とコレクションのシークレットの値も、同じようにキーチェーンに保存されます。

アドレスのクエリ文字列、ボディ、user:password@形式のアドレスにある認証情報は、まだ移されません。読み込んだワークスペースをコミットする前に確認してください。シークレットを参照してください。

スクリプトCopy Anchor Link

Postmanのプリリクエストスクリプトとテストスクリプトは取り込まれ、Echolotのpm.*サンドボックスで実行されます。 読み込まれたスクリプトは、信頼するまで実行されません。レポートにはスクリプトの数が表示され、それが必要な最初の送信で確認を求められます（スクリプトを確認…）。 Brunoのスクリプトとテストは記述のまま取り込まれますが、Brunoのbru、req、resはPostmanのpmとは異なるため、実行前に修正が必要な場合があります。 スクリプトとテストを参照してください。

取り込まれないものCopy Anchor Link

該当する内容は、レポートにそのつど記載されます。

OpenAPIファイルはリンクされたままになるCopy Anchor Link

OpenAPIまたはSwaggerのファイルを読み込むと、そのコピーがワークスペースのspecs/フォルダにも保存され、新しいリクエストのフォルダはその仕様に従います。 仕様が変わると、Echolotは変更内容を表示し、リクエストに反映できます。仕様は仕様ページで編集します。

コマンドラインから読み込むCopy Anchor Link

echolot importは同じ形式をワークスペースのフォルダに読み込みます。移行のスクリプト化や、CIでの読み込みに使えます。

echolot import Alpenglow.postman_collection.json -w "Alpenglow.echolot"
echolot import staging.postman_environment.json -w "Alpenglow.echolot"
echolot import openapi.yaml -w "Alpenglow.echolot" --folder catalog
pbpaste | echolot import - -w "Alpenglow.echolot"       # a cURL command from the clipboard

形式は内容から判別します。--formatを指定すると判別を省略できます（curl、postman-collection、postman-environment、openapi、swagger、insomnia、har、paw、mcp-config）。同じレポートが出力されます。

Imported 22 requests, 7 folders from Postman collection v2.1.
warning: 19 pre-request or test scripts were imported; Echolot runs them once you trust them.

Macでは、アプリと同じようにシークレットがキーチェーンに保存されます。キーチェーンがない環境（Linux、またはECHOLOT_KEYCHAIN=0）では、シークレットはファイルに残らず、送信する場所でどのECHOLOT_SECRET_<NAME>変数を設定すればよいかがツールから示されます。 コマンドラインツール自体は、Newmanと同じく、すべてのスクリプトを確認なしで実行します。

Postmanコレクションは、読み込まなくても実行できます。echolot run collection.jsonで、そのまま実行されます。 読み込みと書き出しとecholot runを参照してください。

逆方向については、書き出しを参照してください。