fastbrowser_cli 1.0.37 → 1.0.40

package/skills/fastbrowser/SKILL.md

@@ -15,7 +15,7 @@ maps 1-to-1 to a FastBrowser tool and returns the tool's response on stdout.
 Run the CLI directly via `tsx`:
 
 ```bash
-npx fastbrowser_cli <command> [flags]
+npx fastbrowser_cli@latest <command> [flags]
 ```
 
 ## Typical Workflow
@@ -35,20 +35,20 @@ uid=1_0 RootWebArea "Example Domain" url="https://example.com/"
 
 ```bash
 # List all open browser pages
-npx fastbrowser_cli list_pages
+npx fastbrowser_cli@latest list_pages
 
 # Open a new page at a URL
-npx fastbrowser_cli new_page --url https://example.com
+npx fastbrowser_cli@latest new_page --url https://example.com
 
 # Close a page by its numeric id
-npx fastbrowser_cli close_page --page-id 1
+npx fastbrowser_cli@latest close_page --page-id 1
 
 # Navigate the current page to a URL
-npx fastbrowser_cli navigate_page --url https://example.com
+npx fastbrowser_cli@latest navigate_page --url https://example.com
 
 # Restart the daemon - run this if pages opened by the bridge were closed manually
 # and the MCP connection has broken
-npx fastbrowser_cli server restart
+npx fastbrowser_cli@latest server restart
 ```
 
 
@@ -66,10 +66,10 @@ The daemon binds to one backend at startup. If it is already running with a diff
 
 ```bash
 # Use chrome-devtools-mcp for one command
-npx fastbrowser_cli --mcp-target chrome_devtools list_pages
+npx fastbrowser_cli@latest --mcp-target chrome_devtools list_pages
 
 # Switch the running daemon to a different backend
-npx fastbrowser_cli --mcp-target chrome_devtools server restart
+npx fastbrowser_cli@latest --mcp-target chrome_devtools server restart
 ```
 
 
@@ -224,47 +224,54 @@ Example queries on it:
 
 ```bash
 # Query the accessibility tree returning the FIRST match per selector (--selector is repeatable)
-npx fastbrowser_cli query_selectors --selector "button" --selector "link"
+npx fastbrowser_cli@latest query_selectors --selector "button" --selector "link"
 
 # Include ancestor nodes in the result
-npx fastbrowser_cli query_selectors --selector 'heading[level="1"]' --with-ancestors
+npx fastbrowser_cli@latest query_selectors --selector 'heading[level="1"]' --with-ancestors
 
 # Include the descendant subtree of each match
-npx fastbrowser_cli query_selectors --selector 'main' --with-children
+npx fastbrowser_cli@latest query_selectors --selector 'main' --with-children
 
 # Per-selector control over withAncestors / withChildren via JSON
-npx fastbrowser_cli query_selectors \
+npx fastbrowser_cli@latest query_selectors \
   --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withChildren":true}]'
 
 # Pass --all to return every match per selector; --limit caps results per selector (0 = unlimited)
-npx fastbrowser_cli query_selectors --all --selector "button" --selector "link" --limit 5
+npx fastbrowser_cli@latest query_selectors --all --selector "button" --selector "link" --limit 5
 
 # Include ancestor nodes in the result
-npx fastbrowser_cli query_selectors --all --selector 'heading[level="1"]' --with-ancestors
+npx fastbrowser_cli@latest query_selectors --all --selector 'heading[level="1"]' --with-ancestors
 
 # Per-selector control over limit / withAncestors / withChildren via JSON (with --all)
-npx fastbrowser_cli query_selectors --all \
+npx fastbrowser_cli@latest query_selectors --all \
   --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withChildren":true}]'
 
 # Take an accessibility-tree full page snapshot of the current page - very expensive, prefer targeted queries when possible
-npx fastbrowser_cli take_snapshot
+npx fastbrowser_cli@latest take_snapshot
 ```
 
 ## Interaction
 
 ```bash
 # Click by a direct uid reference (fast path - no accessibility-tree lookup)
-npx fastbrowser_cli click --selector "#1_42"
+npx fastbrowser_cli@latest click --selector "#1_42"
 
 # Click by any CSS-like selector - resolved to a uid internally
-npx fastbrowser_cli click -s 'button[name="Submit"]'
+npx fastbrowser_cli@latest click -s 'button[name="Submit"]'
 
 # Fill a single form field - selector can be a uid (#1_7) or any CSS-like selector
-npx fastbrowser_cli fill_form -s 'textbox[name="Email"]' -v "hello@example.com"
+npx fastbrowser_cli@latest fill_form -s 'textbox[name="Email"]' -v "hello@example.com"
 
 # Press a comma-separated sequence of keys (literals and named keys both work)
-npx fastbrowser_cli press_keys --keys "Tab, Tab, Enter"
-npx fastbrowser_cli press_keys --keys "Hello, Tab, Enter"
+npx fastbrowser_cli@latest press_keys --keys "Tab, Tab, Enter"
+npx fastbrowser_cli@latest press_keys --keys "Hello, Tab, Enter"
+
+# Evaluate a JS function in the page context and get its JSON-able return value
+npx fastbrowser_cli@latest evaluate_script --script 'function() { return { title: document.title, url: location.href }; }'
+
+# Same, reading the function from a file or piped stdin
+npx fastbrowser_cli@latest evaluate_script ./my_script.js
+echo 'function() { return document.querySelectorAll("a").length; }' | npx fastbrowser_cli@latest evaluate_script
 ```
 
 ## Batch Execution
@@ -281,16 +288,16 @@ By default, the batch stops at the first failing line (shell `set -e` semantics)
 
 ```bash
 # From a file
-npx fastbrowser_cli batch ./demo.fbs
+npx fastbrowser_cli@latest batch ./demo.fbs
 
 # Piped on stdin
-cat demo.fbs | npx fastbrowser_cli batch
+cat demo.fbs | npx fastbrowser_cli@latest batch
 
 # Inline script
-npx fastbrowser_cli batch --script $'press_keys --keys "Enter"\nclick -s \'button[name^="Tout effacer"]\''
+npx fastbrowser_cli@latest batch --script $'press_keys --keys "Enter"\nclick -s \'button[name^="Tout effacer"]\''
 
 # Continue through failures
-npx fastbrowser_cli batch --no-stop-on-error ./demo.fbs
+npx fastbrowser_cli@latest batch --no-stop-on-error ./demo.fbs
 ```
 
 Example `demo.fbs`:
@@ -315,6 +322,7 @@ press_keys --keys "Tab, Enter"
 | `click` | Click an element by accessibility selector | `--selector` / `-s` |
 | `fill_form` | Fill a form field by accessibility selector | `--selector` / `-s`, `--value` |
 | `press_keys` | Press a comma-separated key sequence | `--keys` |
+| `evaluate_script` | Run a JS function in the page context and return its JSON-able result | one of: `<file>`, `--script`, or piped stdin |
 | `batch` | Run multiple commands from a file, piped stdin, or `--script` inline | one of: `<file>`, `--script`, or piped stdin |
 | `install [skill-folder]` | Install bundled skills into `<skill-folder>/skills/` (default: `.`) | — |
 | `server start` | Start the HTTP server daemon | — |

package/src/contribs/_shared/fastbrowser_helper.ts

@@ -0,0 +1,54 @@
+import { execSync } from 'node:child_process';
+
+const __dirname = new URL('.', import.meta.url).pathname;
+const __filename = new URL(import.meta.url).pathname;
+
+export class FastBrowserHelper {
+	static async run(command: string): Promise<string> {
+		const duringDev = __filename.endsWith('.ts') ? true : false;
+		const baseCommand = duringDev
+			? `npx tsx ${__dirname}../../fastbrowser_cli/fastbrowser_cli.ts`
+			: `node ${__dirname}../../fastbrowser_cli/fastbrowser_cli.js`;
+		const fullCommand = `${baseCommand} ${command}`;
+		// console.log(`FastBrowserHelper: meta.url: ${import.meta.url}`);
+		// console.error(`FastBrowserHelper: Running command: ${fullCommand}`);
+		return execSync(fullCommand, { encoding: 'utf8' });
+	}
+
+	static async navigatePage(url: string): Promise<void> {
+		await FastBrowserHelper.run(`navigate_page --url '${url}'`);
+	}
+
+	static async fillForm(selector: string, value: string): Promise<void> {
+		await FastBrowserHelper.run(`fill_form --selector '${selector}' --value '${value}'`);
+	}
+
+	static async pressKeys(keys: string): Promise<void> {
+		await FastBrowserHelper.run(`press_keys --keys '${keys}'`);
+	}
+
+	static async click(selector: string): Promise<void> {
+		await FastBrowserHelper.run(`click -s '${selector}'`);
+	}
+
+	static async querySelectorsAll(selector: string, limit: number): Promise<string> {
+		return await FastBrowserHelper.run(`query_selectors --all --selector '${selector}' --limit ${limit}`);
+	}
+
+	static async querySelectorsAllWithChildren(selector: string, limit: number): Promise<string> {
+		return await FastBrowserHelper.run(`query_selectors --all --selector '${selector}' --limit ${limit} --with-ancestors --with-children`);
+	}
+
+	static async takeSnapshot(): Promise<string> {
+		return await FastBrowserHelper.run('take_snapshot');
+	}
+
+	static async querySelectors(selector: string, withAncestors = true): Promise<string> {
+		const flag = withAncestors === false ? ' --no-with-ancestors' : '';
+		return await FastBrowserHelper.run(`query_selectors --selector '${selector}'${flag}`);
+	}
+
+	static async evaluateScript(functionText: string): Promise<string> {
+		return await FastBrowserHelper.run(`evaluate_script --script "${functionText}"`);
+	}
+}

package/src/contribs/linkedin_cli/README.md

@@ -0,0 +1,80 @@
+# linkedin_cli
+
+Command-line tool to interact with LinkedIn through a real browser session, driven by `fastbrowser_cli`.
+
+It lets you create posts on the feed and manage direct-message conversations (list, read, send) from the terminal.
+
+## Requirements
+
+- A running `fastbrowser_cli` session already authenticated on `linkedin.com`.
+- The `_shared/fastbrowser_helper.ts` wrapper located in the sibling `contribs/_shared/` folder.
+
+## Usage
+
+```bash
+npx tsx ./src/cli.ts <command> [args]
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `post <content>` | Create a post on the LinkedIn feed. |
+| `dm_page` | Navigate to the LinkedIn messaging page. Run this first before any `dm_*` command. |
+| `dm_list` | List the names of people you have conversations with. |
+| `dm_send <target_user> <message>` | Send a message in an existing conversation with `target_user`. |
+| `dm_thread <target_user>` | Print the message thread of a conversation with `target_user`. |
+| `profile <slug>` | Export a LinkedIn profile by slug (the path component of `/in/<slug>/`). Use `-f json` for JSON output. |
+
+`target_user` is matched against the conversation heading via a prefix match (e.g. `"Jerome"` matches `"Jerome Etienne"`).
+
+### Examples
+
+Create a post:
+
+```bash
+npx tsx ./src/cli.ts post "Hello LinkedIn from the CLI"
+```
+
+List your conversations:
+
+```bash
+npx tsx ./src/cli.ts dm_page
+npx tsx ./src/cli.ts dm_list
+```
+
+Read a thread:
+
+```bash
+npx tsx ./src/cli.ts dm_thread "Jerome Etienne"
+```
+
+Output is one message per line in the form:
+
+```
+2026-05-03T14:32:00:Jerome Etienne: hey, are you free this week?
+```
+
+Send a reply:
+
+```bash
+npx tsx ./src/cli.ts dm_send "Jerome Etienne" "Sure, Thursday afternoon works."
+```
+
+Export a profile as markdown (default):
+
+```bash
+npx tsx ./src/cli.ts profile jeromeetienne
+```
+
+Export the same profile as JSON:
+
+```bash
+npx tsx ./src/cli.ts profile jeromeetienne -f json
+```
+
+## Layout
+
+- [src/cli.ts](src/cli.ts) — Commander entry point, defines the commands and orchestrates browser actions through `FastBrowserHelper`.
+- [src/libs/linkedin_thread_helper.ts](src/libs/linkedin_thread_helper.ts) — Parses the LinkedIn message thread from an accessibility tree snapshot into timestamped lines.
+- [src/libs/linkedin_profile_helper.ts](src/libs/linkedin_profile_helper.ts) — Parses a LinkedIn profile snapshot into a typed `LinkedinProfile` (header, About, Experience, Education) with markdown rendering.