--- name: cdp-browser-2650e6c40f3d description: CDP browser control at localhost:9222. Use when you need to inspect tabs, take screenshots, navigate, scroll, post to X, or run JS in a persistent browser session (e.g. logged into X, Gmail). --- # cdp-browser CLI for Chrome/Chromium at localhost:9222. Inspect tabs, take screenshots, navigate, scroll, post to X, or run JS in a persistent browser session. **Repo:** https://github.com/gostlightai/cdp-browser **Prerequisites:** Chromium running with `--remote-debugging-port=9222`. Docker Compose or a local Chrome with remote debugging enabled. ## Commands Run from the skill dir (`bin/` scripts): | Command | Description | |---------|-------------| | `status` | List all tabs (JSON from CDP) | | `tabs` | Same as status | | `new ` | Open new tab | | `goto ` | Navigate tab to URL | | `snapshot ` | Full-page screenshot (PNG) | | `close-popup ` | Dismiss dialogs/modals | | `scroll [down\|up]` | Scroll by pixels or selector | | `query getUrl` | Return current page URL | | `query getText [selector]` | Return element text (or body) | | `query getHtml [selector]` | Return element HTML (or body) | | `tweet-draft "text"` | Fill compose box only; does NOT post | | `tweet-post --confirm "text"` | Post tweet (requires `--confirm` as second arg) | | `tweet "text"` | Alias for tweet-draft (fills compose only) | ## Tweet flow - **tweet-draft** (default): Fills the compose box; user reviews in browser and posts manually. - **tweet-post**: Requires `--confirm` as second arg (strict). Use when user explicitly approves ("go ahead", "post it", or Telegram confirm button). - **Optional Telegram confirm:** When `tweet.confirmButton` is enabled in config, the agent can run `tweet-draft --save-pending` to write pending state, then send a message with an inline "Confirm Post" button. On confirm, the agent runs `tweet-post --confirm`. ### Config (required for Telegram confirm button) The Telegram "Confirm Post" button **only works if config exists**. Copy the example and place it in your workspace: ```bash # From the skill dir (e.g. ~/.openclaw/workspace/skills/cdp-browser): cp .cdp-browser.json.example ~/.openclaw/workspace/.cdp-browser.json ``` **Location:** `~/.openclaw/workspace/.cdp-browser.json` (or `$OPENCLAW_WORKSPACE/.cdp-browser.json`) | Key | Default | Description | |-----|---------|-------------| | `tweet.confirmButton` | `false` | When `true`, agent sends draft with inline "Confirm Post" button in Telegram. User clicks to approve or says "go ahead". | Without this config, the agent uses plain tweet-draft (no button); user confirms via text only. ### Telegram confirm button (agent instructions) When `tweet.confirmButton` is true (config present) and you are in a Telegram session: 1. **Draft:** Run `tweet-draft --save-pending "text"` from the skill dir. This fills the compose box and writes `~/.openclaw/workspace/.cdp-browser/pending-tweet.json`. 2. **Send with button:** Run from the skill dir: ```bash ./scripts/send-tweet-confirm.sh "" ``` Or use `openclaw message send` directly with `--buttons '[[{"text":"Confirm Post","callback_data":"cdp:tweet:confirm"}]]'`. Use the current session's reply target as ``. 3. **On confirm:** When the user clicks the button, OpenClaw delivers `callback_data: cdp:tweet:confirm`. Or the user says "go ahead"/"post it". Treat either as approval. Then: - Read `~/.openclaw/workspace/.cdp-browser/pending-tweet.json` for `text` and `tabId` - Run `tweet-post --confirm ""` - Edit or delete the message with the button (optional) - Delete the pending file ## Scripts - **cdp.js** — Fetch-only wrapper for CDP HTTP API (`/json`, `/json/list`, `/json/new`); no shell. - **pw.js** — Playwright connect to browser; runs snapshot/goto/scroll/query/tweet-draft/tweet-post. Compose launcher: SideNav_NewTweet_Button, /compose/post, Post only (avoids reply buttons). Post button: tweetButton, tweetButtonInline. ## Security See [SECURITY.md](SECURITY.md) for mitigations and operational notes. --- Source attribution: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/cdp-browser/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 skill-library-mcp contributors 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. # Mega AI Hub resource metadata Creator / publisher: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/cdp-browser/SKILL.md Attribution basis: Source repository record Fields of work: Marketing Roles: Content Marketer, Growth Marketer, Social Media Manager Specialties: API Tools: Chrome, Telegram Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 2ccc6f24107e8bf9ad75fb9c8914ba1aa37bff71b682f8000f0278ffb3276c09