fastbrowser_cli 1.0.35 → 1.0.37

package/README.md

@@ -13,7 +13,8 @@ A lighter alternative to Chrome DevTools MCP or Puppeteer, designed for AI agent
 - **Lean output** — reduces LLM input size, parsing complexity, and iteration cost while improving response quality
 
 
-## How to install the CLI tool for claude
+## How to Install it
+### How to install the CLI tool for claude terminal
 
 fastbrowser can be used at the cli level, with a SKILL.md that maps CLI commands to tools. To install the SKILL.md into a claude agent folder:
 
@@ -24,8 +25,8 @@ cd ~/.claude
 npx fastbrowser_cli install
 ```
 
-### How to include Playwright chrome extension 
-It is use by fastbrowser_mcp to ontrol the browser.
+### How to install Playwright chrome extension 
+It is used by fastbrowser_mcp to control the browser.
 
 [Playwright MCP Bridge](
 https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)
@@ -35,7 +36,7 @@ https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjad
 How to launch the MCP server that the CLI relies on to control the browser:
 
 ```bash
-npx -p fastbrowser_cli fastbrowser_mcp mcp_server
+npx -p fastbrowser_cli@latest fastbrowser_mcp mcp_server
 ```
 
 how to install it in [Claude Desktop](https://code.claude.com/docs/en/desktop) - [more details](https://modelcontextprotocol.io/docs/develop/connect-local-servers#installing-the-filesystem-server)
@@ -51,13 +52,33 @@ how to install it in [Claude Desktop](https://code.claude.com/docs/en/desktop) -
     "fastbrowser_mcp": {
       "command": "npx",
       "args": [
-        "-p", "fastbrowser_cli", "fastbrowser_mcp", "mcp_server"
+        "-p", "fastbrowser_cli@latest", "fastbrowser_mcp", "mcp_server"
       ]
     }
   }
 }
 ```
 
+### Check it is properly installed ?
+Just ask to claude `hat fastbrowser skill can do for me ?`
+
+## Warning
+
+**Never manually close pages opened by Playwright MCP Bridge.** These pages maintain the MCP connection.
+
+### Proper cleanup
+- Use `npx fastbrowser_cli close_page` to close individual pages
+- Use `npx fastbrowser_cli server stop` to shut down the daemon
+
+### If pages are manually closed
+The MCP connection will break. To recover:
+
+```bash
+npx npx fastbrowser_cli server restart
+```
+
+This re-establishes the MCP connection and opens a new control page.
+
 ## Architecture
 
 Three components ship together in this package:

package/examples/linkedin_cli/linkedin_dm.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# export NODE_OPTIONS='' 
+# export NPM_CONFIG_LOGLEVEL=silent
+# FASTBROWSER_CLI="npm run dev:cli --"
+FASTBROWSER_CLI="npx fastbrowser_cli"
+
+# Function to sleep for a random duration between delayBase - delayRange/2 and delayBase + delayRange/2
+# Usage: random_sleep <delayBase> <delayRange>
+random_sleep() {
+	local delayBase="$1"
+	local delayRange="$2"
+	local delay
+	delay=$(awk -v b="$delayBase" -v r="$delayRange" 'BEGIN { srand(); printf "%.3f", b - r/2 + rand()*r }')
+	sleep "$delay"
+}
+
+#######################################################################################
+
+# Restart the server to clear any previous state
+eval "$FASTBROWSER_CLI" server restart
+
+# Goto linkedin messaging page using the CLI commands below:
+eval "$FASTBROWSER_CLI" navigate_page --url https://www.linkedin.com/messaging/
+
+# list all the threads conversations in the left sidebar
+eval "$FASTBROWSER_CLI" query_selectors -s 'list[name="Conversation List"] > listitem heading' -a
+
+# Select the conversation with Eric Defiez
+eval "$FASTBROWSER_CLI" click -s 'list[name="Conversation List"] > listitem heading[name^="Eric Defiez"]'
+
+# Fill the message content
+eval "$FASTBROWSER_CLI" fill_form -s 'textbox[name^="Write"]' -v "Hello"
+
+# Click the "Send" button to send the message
+eval "$FASTBROWSER_CLI" click -s 'button[name^="Send"]'