ブラウザエージェントでSaaSをディレクトリにローンチ

ブラウザエージェントに必要なもの

リポジトリのファイルへのアクセス

エージェントは、プラットフォームのプレイブック、product.json、identity.jsonを読める必要があります。ブラウザツールを持つコーディングエージェントなら直接読めます。純粋なホスト型のブラウザエージェントには、プラットフォームごとに該当するプレイブックとプロダクトの事実をあなたが渡す必要があります。

あなたがログインしているブラウザ

申請はあなたのアカウントで行います。独自のリモートブラウザで動くブラウザエージェントは、あなたとしてログインしておらず、確認コードのためにメールボックスを読むこともできません。リポジトリのガイドは、あなたから見えるChromeを前提にしています。

結果を記録する手段

record.pyとローカルダッシュボードは、あなたのマシン上のPythonスクリプトです。ブラウザエージェントがこれを実行できない場合は、実行後にあなたがダッシュボードで結果を1件ずつ記録します。

ランブックの停止条件

まず重複を検索し、プラットフォームごとに身元情報を確認し、購入はせず、CAPTCHAやあいまいな点があれば止まる。これらはエージェントが実際に従わなければならない指示であって、最初から備わっている機能ではありません。

ブラウザエージェントをあなたのChromeにつなぐ

BROWSER-SETUP.mdは、あなたが見守るChromeに接続するエージェント向けに書かれています。ブラウザエージェントがブラウザツールを持つコーディングエージェントなら、ガイドはそのまま当てはまります。普段使いのChrome（144以降）にauto-connectで接続するChrome DevTools MCPか、ローカルのデバッグポートを使う専用のChromeプロファイルで、まとまりごとに長く保つ接続を1つ使います。

独自のリモートブラウザしか使えないエージェントは、対応している接続の要件を満たしません。ローカルのChromeでChrome DevTools MCPを設定し、始める前に目で見る動作確認を行ってください。

関係のない機密性の高いタブは閉じ、そのプロダクトに許可されたサイトだけを使い、Cookieやブラウザのプロファイルは決してエクスポートしないでください。ツール呼び出しが完了しても、それはツール呼び出しが終わったというだけです。保存されたかどうかは、ページを読み直して確かめてください。

ブラウザエージェントがブラウザツールを持つコーディングエージェントなら、これがBROWSER-SETUP.mdにある汎用のサーバー定義です。エージェントによっては別のファイルや形式で保存します。どこに置くかは、そのエージェント自身のセットアップ画面で決まります。

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

github.comのドキュメントに記載された形式です（2026年9月30日に確認）。 ↗

このようなサーバーを読み込めないエージェントは、対応している経路には乗りません。それでも、貼り付けたプレイブックをもとにフォームを1つ入力することはでき、結果はあなたがダッシュボードで記録します。

コーディングエージェントをChromeに接続する →

開始プロンプト

START.mdにある公開の開始プロンプトを、そのまま使います。このプロンプトは、クローンしたフォルダでPythonを実行できるエージェント、つまり多くの場合ブラウザツールを持つコーディングエージェントを前提にしています。純粋なホスト型のブラウザエージェントの場合は、START.mdにある「doing it yourself」のコマンドを代わりにターミナルで実行し、ダッシュボードからプラットフォームごとのプロンプトをコピーしてエージェントに渡してください。

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

プレイブックと指示は英語のMarkdownで書かれています。コーディングエージェントが最も得意とする形式です。プロダクトの文章は、ディレクトリが受け付ける言語なら何語でもかまいません。エージェントはあなたの言語で返答します。

どちらの場合も、ワークスペース、product.json、authorizations.json、submissions.jsonはあなたのマシン上のファイルになり、ダッシュボードには公開済み、審査待ち、予定、あなたの対応待ちのものが表示されます。

3ステップでLaunchRepoを始める →

実行の様子

下の図はトップページと同じもので、1つのまとまりの中の各プラットフォームが、実際に確認された状態で終わっています。ブラウザエージェントでは、状態を実行後にあなたが入力することもあります。どちらにしても、状態はこのページではなくトラッカーから取られます。

ブラウザエージェントが行き詰まったとき

ブラウザエージェントは、コーディングエージェントとは違う形でつまずきます。まとまりがおかしな方向に進む前に、早めに気づきたい3つの状況です。

どこにもログインしていない

エージェントが独自のリモートブラウザや管理下のブラウザで作業しています。ディレクトリのアカウントもメールボックスもあなたのChromeにあるので、Chrome DevTools MCPを通じて実行をそちらに移すか、エージェントの作業を下書きとして扱い、仕上げはあなたが行ってください。

サイトに拒否される

自分のブラウザでは問題なく使えても、ホスト型ブラウザの自動エージェントを制限するサイトがあります。そのプラットフォームをあなたの対応待ちにして、プレイブックを開きながら手で申請してください。

前回やったことを覚えていない

ブラウザエージェントがセッションをまたいで記録を残すことはまれです。実行が終わったらすぐに、各結果をダッシュボードに入力してください。そうすれば次のまとまりは、記憶ではなくトラッカーから始まります。

--autoConnectでブラウザツールがタイムアウトする場合は、次の4点を確認してください。Chrome 144以降がすでに起動していること、chrome://inspect/#remote-debuggingでリモートデバッグがオンになっていること、Chromeの接続確認を許可したこと、同じブラウザを他のツールが使っていないこと。Chrome DevTools MCPは開いているタブをすべて読み込むので、不要なタブは閉じておきましょう。

あなたの対応が必要なこと

LaunchRepoは、あえてバックグラウンドで動くサービスにしていません。次の場面では実行が止まり、人への引き継ぎとして記録されます。エージェントがそれを迂回することはありません。

CAPTCHAとボット確認

どのエージェントでも、チャレンジは想定したウィンドウであなたが解きます。トラッカーはprepared_needs_humanを記録します。どのプレイブックにも、ステルスや回避の手順はありません。

2FAと確認コード

ほとんどのディレクトリはメールで確認します。ブラウザエージェントがあなたのメールボックスを読めない場合、コードと確認のクリックは人への引き継ぎになり、自動のアクセスとしてではなく、そのとおりに記録されます。

有料オプションへの誘導

有料限定のルートはdeferred_paidとして記録されます。ブラウザエージェントには購入しないよう伝える必要があります。プレイブックはすべてのプラットフォームでそう書いていて、判断するのはあなたです。

記録と確認

エージェントがrecord.pyを実行できない場合は、あなたがローカルダッシュボードに結果を入力します。「公開済み」には、常に公開URLとあなたの確認が必要です。

ベンチマークも順位付けもしていません。ブラウザエージェントの互換性をうたうのは、上の2つの要件を満たす場合であって、ほかのエージェントと比較測定したからではありません。

よくある質問