ダブルクリックで英日反転
Applied Sciences · Engineering
browser-to-api: From CDP Trace to OpenAPI Spec
A Browserbase agent skill that post-processes a recorded browser session (CDP network log) entirely offline and emits a ready-to-use OpenAPI 3.1 spec, coverage report, and client module — no live traffic capture needed.
Two-Skill Pipeline
- browser-trace (capture): records the full CDP firehose to .o11y/<run>/cdp/network/*.jsonl during automation.
- browser-to-api (synthesis): reads those jsonl files offline — no side effects, deterministic, re-runnable.
- Strict separation: capture has side effects; synthesis has none. Rerun post-processing as often as needed.
What the Synthesis Step Does
- Pairs CDP request/response events from the recorded trace.
- Templatises observed URLs: /users/123 → /users/{id}.
- Infers JSON schemas from response samples.
- Outputs openapi.yaml, a human-readable coverage report, and client.mjs.
When to Use It
- Need a proper OpenAPI spec for an undocumented third-party web API.
- Want to extract endpoints/schemas from an existing browser-automation record.
- Building a client/SDK against a site that publishes no spec.
Ecosystem & Installation
- Part of Browserbase's official skills catalogue (skills.sh / browse.sh).
- Install: npx skills add browserbase/skills. Invoke with /browser-to-api in Claude Code or Codex.
- Similar prior art: AndrewWalsh/openapi-devtools (browser extension, manual/local form).
→ By splitting capture (side-effectful) from synthesis (offline, deterministic), browser-to-api lets coding agents one-shot a documented API client for any site — as Codex did for OpenTable in a single prompt.
Applied Sciences · Engineering
browser-to-api：CDPトレースからOpenAPIスペックを自動生成
Browserbase（＝ブラウザ自動化プラットフォーム）の公式エージェントスキル。録画済みのCDP（Chrome DevTools Protocol）ネットワークログをオフラインで解析し、OpenAPI 3.1スペック・カバレッジレポート・クライアントモジュールを生成する。
2スキル構成のパイプライン
- browser-trace（キャプチャ）：自動化実行中にCDPの全通信ログを .o11y/<run>/cdp/network/*.jsonl に記録。
- browser-to-api（合成）：そのjsonlをオフラインで処理。副作用ゼロ・決定論的・何度でも再実行可能。
- 設計の核心：副作用を持つキャプチャと副作用を持たない合成を完全に分離している。
合成ステップの処理内容
- CDPのリクエスト／レスポンスイベントをペアリング（対応づけ）。
- 観測されたURLをテンプレート化：/users/123 → /users/{id}。
- レスポンスのサンプルからJSONスキーマを推論。
- openapi.yaml・人間が読めるカバレッジレポート・client.mjs を出力。
使いどころ
- ドキュメントが存在しないサードパーティWebAPIのOpenAPIスペックが欲しい場合。
- 既存のブラウザ自動化の記録からエンドポイントとスキーマを抽出したい場合。
- スペックを公開していないサイト向けのクライアント／SDKを作りたい場合。
エコシステムと導入方法
- Browserbaseの公式スキルカタログ（skills.sh / browse.sh）の一部。
- インストール：npx skills add browserbase/skills。呼び出し：/browser-to-api（Claude CodeやCodexから）。
- 類似の先行ツール：AndrewWalsh/openapi-devtools（ブラウザ拡張・手動ローカル版）。
→ キャプチャ（副作用あり）と合成（オフライン・決定論的）を分離することで、コーディングエージェントが任意のサイトに対してAPIクライアントをワンショットで生成できる——CodexがOpenTableを単一プロンプトで実証した手法がこれ。
Applied Sciences · Engineering
browser-to-api: From CDP Trace to OpenAPI Spec
A Browserbase agent skill that post-processes a recorded browser session (CDP network log) entirely offline and emits a ready-to-use OpenAPI 3.1 spec, coverage report, and client module — no live traffic capture needed.
Two-Skill Pipeline
- browser-trace (capture): records the full CDP firehose to .o11y/<run>/cdp/network/*.jsonl during automation.
- browser-to-api (synthesis): reads those jsonl files offline — no side effects, deterministic, re-runnable.
- Strict separation: capture has side effects; synthesis has none. Rerun post-processing as often as needed.
What the Synthesis Step Does
- Pairs CDP request/response events from the recorded trace.
- Templatises observed URLs: /users/123 → /users/{id}.
- Infers JSON schemas from response samples.
- Outputs openapi.yaml, a human-readable coverage report, and client.mjs.
When to Use It
- Need a proper OpenAPI spec for an undocumented third-party web API.
- Want to extract endpoints/schemas from an existing browser-automation record.
- Building a client/SDK against a site that publishes no spec.
Ecosystem & Installation
- Part of Browserbase's official skills catalogue (skills.sh / browse.sh).
- Install: npx skills add browserbase/skills. Invoke with /browser-to-api in Claude Code or Codex.
- Similar prior art: AndrewWalsh/openapi-devtools (browser extension, manual/local form).
→ By splitting capture (side-effectful) from synthesis (offline, deterministic), browser-to-api lets coding agents one-shot a documented API client for any site — as Codex did for OpenTable in a single prompt.
Applied Sciences · Engineering
browser-to-api：CDPトレースからOpenAPIスペックを自動生成
Browserbase（＝ブラウザ自動化プラットフォーム）の公式エージェントスキル。録画済みのCDP（Chrome DevTools Protocol）ネットワークログをオフラインで解析し、OpenAPI 3.1スペック・カバレッジレポート・クライアントモジュールを生成する。
2スキル構成のパイプライン
- browser-trace（キャプチャ）：自動化実行中にCDPの全通信ログを .o11y/<run>/cdp/network/*.jsonl に記録。
- browser-to-api（合成）：そのjsonlをオフラインで処理。副作用ゼロ・決定論的・何度でも再実行可能。
- 設計の核心：副作用を持つキャプチャと副作用を持たない合成を完全に分離している。
合成ステップの処理内容
- CDPのリクエスト／レスポンスイベントをペアリング（対応づけ）。
- 観測されたURLをテンプレート化：/users/123 → /users/{id}。
- レスポンスのサンプルからJSONスキーマを推論。
- openapi.yaml・人間が読めるカバレッジレポート・client.mjs を出力。
使いどころ
- ドキュメントが存在しないサードパーティWebAPIのOpenAPIスペックが欲しい場合。
- 既存のブラウザ自動化の記録からエンドポイントとスキーマを抽出したい場合。
- スペックを公開していないサイト向けのクライアント／SDKを作りたい場合。
エコシステムと導入方法
- Browserbaseの公式スキルカタログ（skills.sh / browse.sh）の一部。
- インストール：npx skills add browserbase/skills。呼び出し：/browser-to-api（Claude CodeやCodexから）。
- 類似の先行ツール：AndrewWalsh/openapi-devtools（ブラウザ拡張・手動ローカル版）。
→ キャプチャ（副作用あり）と合成（オフライン・決定論的）を分離することで、コーディングエージェントが任意のサイトに対してAPIクライアントをワンショットで生成できる——CodexがOpenTableを単一プロンプトで実証した手法がこれ。
Related notes
- Agentic Commerce — ACP and Visibility into Being 'Bought by AI'
- AI Search Evaluation: The 12 Metrics — Gateway
- AI Search Evaluation ①Citation Rate — How Many URLs Are Pulled In Per Answer
- AI Search Evaluation ②Source Diversity — How Unskewed the Cited Sources Are
- AI Search Evaluation ③Accuracy Score — How Often It Answers Factual Questions Correctly
- AI Search Evaluation ④Answer Length — How Many Characters It Returns to the User on Average