@youtyan/browser-pilot 0.7.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 youtyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,138 @@
+# browser-pilot
+
+Chrome ブラウザを Claude Code から操作する MCP サーバー。Chrome Extension 経由でリアルブラウザを操作する。
+
+## Quick Start
+
+### 1. MCP 設定に追加
+
+`~/.claude/settings.json` の `mcpServers` に以下を追加:
+
+```json
+{
+  "mcpServers": {
+    "browser-pilot": {
+      "command": "npx",
+      "args": ["-y", "@youtyan/browser-pilot"]
+    }
+  }
+}
+```
+
+### 2. Skills + Extension セットアップ
+
+```bash
+npx @youtyan/browser-pilot init
+```
+
+### 3. Chrome Extension を読み込み
+
+`init` の案内に従い、Chrome の Developer Mode で Extension を読み込む。
+
+## Skills
+
+以下の 7 つのスキルが含まれる:
+
+| スキル | 説明 |
+|---|---|
+| bp-usage | ブラウザ操作ガイド・ツール早見表 |
+| bp-testing | エージェント駆動 Web アプリテスト |
+| bp-test-scripts | コード駆動ブラウザテスト (HTTP API) |
+| bp-gemini-image | Gemini Web UI で画像生成 |
+| bp-x-operation | X (Twitter) 操作 (投稿, 検索, 収集) |
+| bp-annotate-coords | 座標指定スクリーンショットアノテーション |
+| bp-generate-manual | サイト操作マニュアル自動生成 |
+
+`npx skills add` でもインストール可能:
+
+```bash
+npx skills add https://github.com/youtyan/browser-pilot
+```
+
+## 利用可能ツール一覧 (35)
+
+### ブラウザ操作
+
+| ツール | 説明 |
+|---|---|
+| browser_tab | タブ管理 (list, connect, create, close, action log, manual/test生成) |
+| browser_get_page | ページ取得 (smart/compact/navigate/html/tables/forms/links/items/metadata) |
+| browser_navigation | ナビゲーション (URL遷移, 戻る/進む, リロード) |
+| browser_click | クリック (テキスト, CSSセレクタ, ref, backendNodeId) |
+| browser_set_values | フォーム値設定 (リトライ・検証付き) |
+| browser_select_option | ドロップダウン選択 (native/custom対応) |
+| browser_batch | 複数操作の一括実行 (click, setValue, scroll, wait, assert等) |
+| browser_find_elements | 要素検索 (AXセマンティック or DOM) |
+| browser_keyboard | キーボード入力 (テキスト, キー, ショートカット) |
+| browser_scroll | スクロール操作 |
+| browser_wait_for | 要素出現/消滅/数変化の待機, ms遅延 |
+| browser_assert | ページ状態アサーション (exists, visible, contains_text, count) |
+| browser_action | マウス操作 (hover, dblclick, drag, contextmenu) |
+| browser_handle_dialog | ダイアログ操作 (accept/dismiss) |
+| browser_execute_javascript | JavaScript 実行 |
+| browser_health | 接続診断 (1コール) |
+
+### キャプチャ・出力
+
+| ツール | 説明 |
+|---|---|
+| browser_screenshot | スクリーンショット (全体/要素, savePath指定) |
+| browser_pdf | ページPDF保存 |
+| browser_record | タブ録画 (WebM, savePath指定) |
+| browser_get_bounds | 要素座標・サイズ取得 |
+| browser_annotate | アノテーション (モザイク, 矢印, ラベル, バッジ) |
+| browser_get_attributes | 要素属性取得 (selector/backendNodeId) |
+| browser_paste_file | ファイルペースト |
+| browser_upload_file | ファイルアップロード |
+
+### デバッグ・診断
+
+| ツール | 説明 |
+|---|---|
+| browser_console | コンソールメッセージ (source map解決付き) |
+| browser_network | ネットワーク監視 (redaction付き) |
+| browser_performance | パフォーマンス診断 (load/layout/network/runtime/a11y/memory/page) |
+| browser_css_inspect | CSS検査・算出スタイル |
+| browser_storage | localStorage/sessionStorage検査 |
+| browser_cookie | Cookie管理 (get/set/delete) |
+
+### 連携
+
+| ツール | 説明 |
+|---|---|
+| gemini_generate_image | Gemini Web UI経由の画像生成 |
+| x_collect_tweets | X (Twitter) ツイート収集 (スクロール+重複除外) |
+
+## セキュリティに関する注意事項
+
+browser-pilot は強力なブラウザ自動化ツールです。使用前に以下のリスクを理解してください。
+
+- **`browser_execute_javascript` は Chrome タブの MAIN world で任意の JavaScript を実行します。** ページの DOM、Cookie、localStorage 等に完全にアクセスできます。
+- **MCP サーバーは `localhost:18888` にバインドされます。** トークンを持つマシン上の任意のプロセスが接続可能です。
+- **認証トークンは `~/.browser-pilot-token` にパーミッション 0600 で保存されます。**
+- **Chrome Extension は `<all_urls>` パーミッションを持ちます。** あらゆる Web サイトにアクセス可能です。
+- **信頼できる環境でのみ使用してください。**
+
+### トークンペアリング
+
+Extension はbearer トークンで認証します。ペアリング手順：
+
+1. MCP サーバーを起動
+2. `npx @youtyan/browser-pilot token` でトークンを表示
+3. Extension ポップアップに貼り付け
+
+トークンはディスク上（`~/.browser-pilot-token`）に `0600` パーミッションで保存されます。トークンを公開する HTTP エンドポイントはありません。CLI コマンドまたは手動でコピーしてください。
+
+## 開発
+
+セットアップ、アーキテクチャ、ツール追加方法、ビルド手順については [DEVELOPMENT.md](./DEVELOPMENT.md) を参照。
+
+## 更新方法
+
+```bash
+npx @youtyan/browser-pilot update
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,140 @@
+# browser-pilot
+
+[日本語版 README](./README.ja.md)
+
+An MCP server for controlling Chrome browsers from Claude Code. Operates real browsers via a Chrome Extension.
+
+## Quick Start
+
+### 1. Add MCP configuration
+
+Add the following to `mcpServers` in `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "browser-pilot": {
+      "command": "npx",
+      "args": ["-y", "@youtyan/browser-pilot"]
+    }
+  }
+}
+```
+
+### 2. Set up Skills and Extension
+
+```bash
+npx @youtyan/browser-pilot init
+```
+
+### 3. Load the Chrome Extension
+
+Follow the instructions from `init` to load the Extension in Chrome Developer Mode.
+
+## Skills
+
+Seven skills are included:
+
+| Skill | Description |
+|---|---|
+| bp-usage | Browser operation guide and tool quick reference |
+| bp-testing | Agent-driven web app testing |
+| bp-test-scripts | Code-driven browser testing (HTTP API) |
+| bp-gemini-image | Image generation via Gemini Web UI |
+| bp-x-operation | X (Twitter) operations (post, search, collect) |
+| bp-annotate-coords | Screenshot annotation with coordinates and bounds |
+| bp-generate-manual | Site operation manual generation with screenshots/video |
+
+You can also install skills with `npx skills add`:
+
+```bash
+npx skills add https://github.com/youtyan/browser-pilot
+```
+
+## Available Tools (35)
+
+### Browser Operation
+
+| Tool | Description |
+|---|---|
+| browser_tab | Tab management (list, connect, create, close, action log, manual/test generation) |
+| browser_get_page | Get page content (smart/compact/navigate/html/tables/forms/links/items/metadata modes) |
+| browser_navigation | Navigate to URL, go back/forward, reload |
+| browser_click | Click by text, CSS selector, ref, or backendNodeId |
+| browser_set_values | Set form field values (with retry and verify) |
+| browser_select_option | Select dropdown options (native and custom) |
+| browser_batch | Execute multiple actions in one round-trip (click, setValue, scroll, wait, assert, keyboard, selectOption) |
+| browser_find_elements | Find elements with semantic AX scoring or DOM search |
+| browser_keyboard | Keyboard input (type text, press keys, shortcuts) |
+| browser_scroll | Scroll page or element |
+| browser_wait_for | Wait for element appear/disappear/count change, or simple ms delay |
+| browser_assert | Assert page state (exists, visible, contains_text, count) |
+| browser_action | Mouse actions (hover, dblclick, drag, contextmenu) |
+| browser_handle_dialog | Accept or dismiss browser dialogs |
+| browser_execute_javascript | Execute JavaScript in page context |
+| browser_health | One-call connection diagnostics |
+
+### Capture & Output
+
+| Tool | Description |
+|---|---|
+| browser_screenshot | Take screenshot (full page or element, with savePath) |
+| browser_pdf | Save page as PDF |
+| browser_record | Record tab activity as WebM video (with savePath) |
+| browser_get_bounds | Get element bounding rectangles for annotation |
+| browser_annotate | Annotate screenshots (mosaic, arrows, labels, badges) |
+| browser_get_attributes | Get element attributes (selector or backendNodeId) |
+| browser_paste_file | Paste a file into page |
+| browser_upload_file | Upload file to input element |
+
+### Debugging & Diagnostics
+
+| Tool | Description |
+|---|---|
+| browser_console | Console messages (with source map resolution) |
+| browser_network | Network request monitoring (with redaction) |
+| browser_performance | Performance diagnostics (diagnose_load/layout/network/runtime/accessibility/memory/page) |
+| browser_css_inspect | CSS inspection and computed styles |
+| browser_storage | localStorage/sessionStorage inspection |
+| browser_cookie | Cookie management (get, set, delete) |
+
+### Integrations
+
+| Tool | Description |
+|---|---|
+| gemini_generate_image | Generate images via Gemini Web UI |
+| x_collect_tweets | Collect tweets from X (Twitter) with scroll and dedup |
+
+## Security Considerations
+
+browser-pilot is a powerful browser automation tool. Understand the following risks before use.
+
+- **`browser_execute_javascript` executes arbitrary JavaScript in the MAIN world of Chrome tabs.** This gives full access to the page's DOM, cookies, localStorage, and more.
+- **The MCP server binds to `localhost:18888`.** Any process on the machine can connect if it has the authentication token.
+- **The authentication token is stored in `~/.browser-pilot-token` with `0600` permissions.**
+- **The Chrome Extension has `<all_urls>` permission.** It can access any website.
+- **Only use this tool in trusted environments.**
+
+### Token Pairing
+
+The Extension authenticates via a bearer token stored in `chrome.storage.local`. To pair:
+
+1. Start the MCP server
+2. Run `npx @youtyan/browser-pilot token` to print the token
+3. Paste into the Extension popup
+
+The token is stored on disk (`~/.browser-pilot-token`) with `0600` permissions. There is no HTTP endpoint that exposes the token — it must be copied manually or via the CLI command.
+
+## Development
+
+See [DEVELOPMENT.md](./DEVELOPMENT.md) for setup, architecture, adding tools, and build instructions.
+
+## Updating
+
+```bash
+npx @youtyan/browser-pilot update
+```
+
+## License
+
+MIT