fastbrowser_cli 1.0.2 → 1.0.4

package/dist/fastbrowser_mcp/libs/mcp_client.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClient = void 0;
+// node import
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//	
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+class McpClient {
+    constructor(options) {
+        this.options = options;
+        this.connected = false;
+        this.client = new index_js_1.Client({
+            name: options.name,
+            version: options.version,
+        });
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        this.transport = this.createTransport(this.options.transport);
+        await this.client.connect(this.transport);
+        this.connected = true;
+    }
+    async close() {
+        if (!this.connected)
+            return;
+        await this.client.close();
+        this.connected = false;
+    }
+    async listTools() {
+        this.assertConnected();
+        const { tools } = await this.client.listTools();
+        return tools;
+    }
+    async callTool(name, args = {}) {
+        this.assertConnected();
+        return this.client.callTool({ name, arguments: args });
+    }
+    async listResources() {
+        this.assertConnected();
+        const { resources } = await this.client.listResources();
+        return resources;
+    }
+    async readResource(uri) {
+        this.assertConnected();
+        return this.client.readResource({ uri });
+    }
+    async listPrompts() {
+        this.assertConnected();
+        const { prompts } = await this.client.listPrompts();
+        return prompts;
+    }
+    async getPrompt(name, args = {}) {
+        this.assertConnected();
+        return this.client.getPrompt({ name, arguments: args });
+    }
+    createTransport(config) {
+        switch (config.type) {
+            case "stdio":
+                return new stdio_js_1.StdioClientTransport({
+                    command: config.command,
+                    args: config.args ?? [],
+                    env: config.env,
+                });
+            case "http":
+                return new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(config.url), {
+                    requestInit: { headers: config.headers },
+                });
+        }
+    }
+    assertConnected() {
+        if (!this.connected) {
+            throw new Error("McpClient is not connected. Call connect() first.");
+        }
+    }
+}
+exports.McpClient = McpClient;
+//# sourceMappingURL=mcp_client.js.map

package/dist/fastbrowser_mcp/libs/mcp_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_client.js","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/mcp_client.ts"],"names":[],"mappings":"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"}

package/dist/fastbrowser_mcp/libs/mcp_proxy.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpClient } from "./mcp_client.js";
+export declare class McpProxy {
+    private _mcpServer;
+    constructor();
+    connect(): Promise<void>;
+    getMcpServer(): Promise<McpServer>;
+    proxyToolCall(mcpClient: McpClient, toolName: string): Promise<void>;
+}
+//# sourceMappingURL=mcp_proxy.d.ts.map

package/dist/fastbrowser_mcp/libs/mcp_proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_proxy.d.ts","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/mcp_proxy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,QAAQ;IACpB,OAAO,CAAC,UAAU,CAAY;;IASxB,OAAO;IAKP,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAOlC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM;CAc1D"}

package/dist/fastbrowser_mcp/libs/mcp_proxy.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpProxy = void 0;
+// node imports
+const node_assert_1 = __importDefault(require("node:assert"));
+// npm imports
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_from_json_schema_1 = require("zod-from-json-schema");
+class McpProxy {
+    constructor() {
+        this._mcpServer = new mcp_js_1.McpServer({
+            name: "fastbrowser_mcp",
+            version: "1.0.0",
+        });
+    }
+    async connect() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this._mcpServer.connect(transport);
+    }
+    async getMcpServer() {
+        if (this._mcpServer === null) {
+            throw new Error("MCP server is not initialized");
+        }
+        return this._mcpServer;
+    }
+    async proxyToolCall(mcpClient, toolName) {
+        const mcpClientTools = await mcpClient.listTools();
+        const mcpClientTool = mcpClientTools.find((tool) => tool.name === toolName);
+        node_assert_1.default.ok(mcpClientTool !== undefined, `Tool ${toolName} not found in mcp client tools`);
+        const inputSchema = (0, zod_from_json_schema_1.convertJsonSchemaToZod)(mcpClientTool.inputSchema);
+        this._mcpServer.registerTool(toolName, {
+            description: mcpClientTool.description,
+            inputSchema: inputSchema,
+        }, async (...args) => {
+            const callResult = await mcpClient.callTool(toolName, args[0]);
+            return callResult;
+        });
+    }
+}
+exports.McpProxy = McpProxy;
+//# sourceMappingURL=mcp_proxy.js.map

package/dist/fastbrowser_mcp/libs/mcp_proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_proxy.js","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/mcp_proxy.ts"],"names":[],"mappings":";;;;;;AAAA,eAAe;AACf,8DAAiC;AAEjC,cAAc;AACd,oEAAoE;AACpE,wEAAiF;AACjF,+DAA8D;AAK9D,MAAa,QAAQ;IAGpB;QACC,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAS,CAAC;YAC/B,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,OAAO;SAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAoB,EAAE,QAAgB;QACzD,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAA;QAClD,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC5E,qBAAM,CAAC,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,QAAQ,QAAQ,gCAAgC,CAAC,CAAA;QAExF,MAAM,WAAW,GAAG,IAAA,6CAAsB,EAAC,aAAa,CAAC,WAAkB,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE;YACtC,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,WAAW,EAAE,WAAW;SACxB,EAAE,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;YAC3B,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9D,OAAO,UAAU,CAAA;QAClB,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AApCD,4BAoCC"}

package/dist/fastbrowser_mcp/libs/schemas.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const QuerySelectorInputSchema: z.ZodObject<{
+    selector: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    withAncestors: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const QuerySelectorsInputSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        withAncestors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const QuerySelectorFirstInputSchema: z.ZodObject<{
+    selector: z.ZodString;
+    withAncestors: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const QuerySelectorsFirstInputSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        withAncestors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QuerySelectorInput = z.infer<typeof QuerySelectorInputSchema>;
+export type QuerySelectorsInput = z.infer<typeof QuerySelectorsInputSchema>;
+export type QuerySelectorFirstInput = z.infer<typeof QuerySelectorFirstInputSchema>;
+export type QuerySelectorsFirstInput = z.infer<typeof QuerySelectorsFirstInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/fastbrowser_mcp/libs/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,wBAAwB;;;;iBASnC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAMxC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;iBAGzC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/fastbrowser_mcp/libs/schemas.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuerySelectorsFirstInputSchema = exports.QuerySelectorFirstInputSchema = exports.QuerySelectorsInputSchema = exports.QuerySelectorInputSchema = void 0;
+// npm imports
+const zod_1 = require("zod");
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//	Authoritative query selector schemas — shared between the MCP server
+//	and the HTTP/CLI layer. Kept out of the fastbrowser_mcp.ts entrypoint so
+//	importing the schemas does not execute the CLI's top-level `main()`.
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+exports.QuerySelectorInputSchema = zod_1.z.object({
+    selector: zod_1.z.string()
+        .describe("CSS-like selector to query the accessibility tree"),
+    limit: zod_1.z.number()
+        .describe("Maximum number of nodes to return (excluding ancestors). Set to 0 for no limit.")
+        .default(0),
+    withAncestors: zod_1.z.boolean()
+        .describe("Whether to include ancestor nodes in the result")
+        .default(true),
+});
+exports.QuerySelectorsInputSchema = zod_1.z.object({
+    selectors: zod_1.z.array(exports.QuerySelectorInputSchema)
+        .describe("List of selectors to query the accessibility tree"),
+});
+exports.QuerySelectorFirstInputSchema = zod_1.z.object({
+    selector: zod_1.z.string()
+        .describe("CSS-like selector to query the accessibility tree"),
+    withAncestors: zod_1.z.boolean()
+        .describe("Whether to include ancestor nodes in the result")
+        .default(true),
+});
+exports.QuerySelectorsFirstInputSchema = zod_1.z.object({
+    selectors: zod_1.z.array(exports.QuerySelectorFirstInputSchema)
+        .describe("List of selectors; for each, the first matching node is returned"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/fastbrowser_mcp/libs/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/schemas.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,6BAAwB;AAExB,+EAA+E;AAC/E,+EAA+E;AAC/E,uEAAuE;AACvE,2EAA2E;AAC3E,uEAAuE;AACvE,+EAA+E;AAC/E,+EAA+E;AAElE,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,iFAAiF,CAAC;SAC3F,OAAO,CAAC,CAAC,CAAC;IACZ,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE;SACxB,QAAQ,CAAC,iDAAiD,CAAC;SAC3D,OAAO,CAAC,IAAI,CAAC;CACf,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;SAC1C,QAAQ,CAAC,mDAAmD,CAAC;CAC/D,CAAC,CAAC;AAEU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE;SACxB,QAAQ,CAAC,iDAAiD,CAAC;SAC3D,OAAO,CAAC,IAAI,CAAC;CACf,CAAC,CAAC;AAEU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,qCAA6B,CAAC;SAC/C,QAAQ,CAAC,kEAAkE,CAAC;CAC9E,CAAC,CAAC"}

package/docs/brainstorm_scrap_by_ai.md

@@ -29,4 +29,4 @@
   - possible by selector language ? yes
 - get link with an url starting with "https://www.welcometothejungle.com/fr/companies/"
   - on a https://www.welcometothejungle.com/fr/jobs?refinementList%5Boffices.country_code%5D%5B%5D=FR&query=machine%20learning&page=7
-  - `npx tsx ./src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`
+  - `npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts query_selectors_all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`

package/docs/feature_support_cli.md

@@ -1,22 +1,22 @@
-# FastWeb MCP
+# FastBrowser MCP
 
 ## Overview
 
-FastWeb is a Model Context Protocol (MCP) server accessible via STDIO. It acts as a smarter proxy in front of the official `chrome-devtools-mcp`, exposing a leaner, more efficient toolset tuned for LLM agents.
+FastBrowser is a Model Context Protocol (MCP) server accessible via STDIO. It acts as a smarter proxy in front of the official `chrome-devtools-mcp`, exposing a leaner, more efficient toolset tuned for LLM agents.
 
-Where the standard Chrome DevTools MCP exposes a broad, low-level API, FastWeb adds a structured accessibility-tree query layer (`querySelectorsAll`) that lets an agent extract exactly the page nodes it needs in a single call — rather than consuming the entire raw snapshot. This reduces token usage and round-trips, making FastWeb noticeably more efficient for web automation tasks.
+Where the standard Chrome DevTools MCP exposes a broad, low-level API, FastBrowser adds a structured accessibility-tree query layer (`querySelectorsAll`) that lets an agent extract exactly the page nodes it needs in a single call — rather than consuming the entire raw snapshot. This reduces token usage and round-trips, making FastBrowser noticeably more efficient for web automation tasks.
 
 ## HTTP Server Architecture
 
-Connecting to `fastweb-mcp` on every invocation is slow: the MCP process starts cold, handshakes with `chrome-devtools-mcp`, and tears down after each session. To eliminate that overhead, `fastweb-http-server` acts as a persistent MCP client that connects to `fastweb-mcp` once and keeps that connection alive. It then re-exposes the same capabilities over a REST API, so `fastweb-cli` can issue commands with minimal latency. This splits the stack into two roles — a long-lived server that owns the MCP connection, and a thin client that issues commands and reads results — making interactions dramatically faster and easier to script.
+Connecting to `fastbrowser-mcp` on every invocation is slow: the MCP process starts cold, handshakes with `chrome-devtools-mcp`, and tears down after each session. To eliminate that overhead, `fastbrowser-httpd` acts as a persistent MCP client that connects to `fastbrowser-mcp` once and keeps that connection alive. It then re-exposes the same capabilities over a REST API, so `fastbrowser-cli` can issue commands with minimal latency. This splits the stack into two roles — a long-lived server that owns the MCP connection, and a thin client that issues commands and reads results — making interactions dramatically faster and easier to script.
 
 ## Components
 
-FastWeb is made up of three tools that work together:
+FastBrowser is made up of three tools that work together:
 
-- **fastweb-mcp** — The MCP server, accessible via STDIO. It connects directly to Chrome via `chrome-devtools-mcp` and exposes a curated, efficient toolset to any MCP-compatible LLM agent.
-- **fastweb-http-server** — A persistent HTTP server that acts as an MCP client connecting to `fastweb-mcp`. By keeping that MCP connection alive, it eliminates the cold-start penalty and exposes the same capabilities over a REST API for other clients to consume.
-- **fastweb-cli** — A lightweight command-line client that talks to `fastweb-http-server` over a REST API. It provides a fast, scriptable interface to browser automation without the overhead of spawning a new MCP process each time.
+- **fastbrowser-mcp** — The MCP server, accessible via STDIO. It connects directly to Chrome via `chrome-devtools-mcp` and exposes a curated, efficient toolset to any MCP-compatible LLM agent.
+- **fastbrowser-httpd** — A persistent HTTP server that acts as an MCP client connecting to `fastbrowser-mcp`. By keeping that MCP connection alive, it eliminates the cold-start penalty and exposes the same capabilities over a REST API for other clients to consume.
+- **fastbrowser-cli** — A lightweight command-line client that talks to `fastbrowser-httpd` over a REST API. It provides a fast, scriptable interface to browser automation without the overhead of spawning a new MCP process each time.
 
 ### Tools exposed
 
@@ -32,49 +32,49 @@ FastWeb is made up of three tools that work together:
 | `querySelectors` | Query the accessibility tree and return the first matching node per selector |
 | `pressKeys` | Send a sequence of keyboard events |
 
-## FastWeb CLI Command Lines
+## FastBrowser CLI Command Lines
 
-Each command maps 1-to-1 to a FastWeb MCP tool and sends the request to `fastweb-http-server` via REST.
+Each command maps 1-to-1 to a FastBrowser MCP tool and sends the request to `fastbrowser-httpd` via REST.
 
 ```bash
 # List all open browser pages
-fastweb-cli list_pages
+fastbrowser-cli list_pages
 
 # Open a new browser page
-fastweb-cli new_page
+fastbrowser-cli new_page
 
 # Close a page by its ID
-fastweb-cli close_page --page-id <pageId>
+fastbrowser-cli close_page --page-id <pageId>
 
 # Navigate the current page to a URL
-fastweb-cli navigate_page --url https://example.com
+fastbrowser-cli navigate_page --url https://example.com
 
 # Click an element by accessibility selector (fast path: "#1_42" is a direct uid reference)
-fastweb-cli click --selector "#1_42"
-fastweb-cli click -s 'button[name="Submit"]'
+fastbrowser-cli click --selector "#1_42"
+fastbrowser-cli click -s 'button[name="Submit"]'
 
 # Fill a form field by accessibility selector
-fastweb-cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
+fastbrowser-cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
 
 # Query the accessibility tree — --selector can be repeated for multiple selectors.
 # --limit and --with-ancestors apply to all selectors equally.
-fastweb-cli query_selectors_all --selector "button" --selector "link" --limit 5 --with-ancestors
-fastweb-cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
+fastbrowser-cli query_selectors_all --selector "button" --selector "link" --limit 5 --with-ancestors
+fastbrowser-cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
 
 # For per-selector control over limit/withAncestors, pass a JSON array directly:
-fastweb-cli query_selectors_all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
+fastbrowser-cli query_selectors_all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
 
 # Query the accessibility tree for the first matching element per selector (mirrors DOM querySelector).
 # --selector can be repeated for multiple selectors; --with-ancestors applies to all.
-fastweb-cli query_selectors --selector "button"
-fastweb-cli query_selectors --selector "button" --selector "link" --no-with-ancestors
+fastbrowser-cli query_selectors --selector "button"
+fastbrowser-cli query_selectors --selector "button" --selector "link" --no-with-ancestors
 
 # For per-selector control over withAncestors, pass a JSON array directly:
-fastweb-cli query_selectors --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
+fastbrowser-cli query_selectors --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
 
 # Press a sequence of keys
-fastweb-cli press_keys --keys "Tab, Tab, Enter"
-fastweb-cli press_keys --keys "Hello, Tab, Enter"
+fastbrowser-cli press_keys --keys "Tab, Tab, Enter"
+fastbrowser-cli press_keys --keys "Hello, Tab, Enter"
 ```
 
 ## Implementation Notes
@@ -82,5 +82,5 @@ fastweb-cli press_keys --keys "Hello, Tab, Enter"
 - The HTTP server is built with **Express**.
 - All REST request and response payloads are validated with **Zod**.
 - Every data structure has both a TypeScript `type` alias and a corresponding Zod schema — the type is derived from the schema via `z.infer<>` to keep them in sync.
-- `fastweb-http-server` lives in `contrib/fastweb-http-server/`.
-- `fastweb-cli` lives in `contrib/fastweb-cli/`.
+- `fastbrowser-httpd` lives in `contrib/fastbrowser-httpd/`.
+- `fastbrowser-cli` lives in `contrib/fastbrowser-cli/`.

package/package.json

@@ -1,16 +1,16 @@
 {
     "name": "fastbrowser_cli",
-    "version": "1.0.2",
+    "version": "1.0.4",
     "description": "",
-    "main": "dist/fastweb_cli/fastweb_cli.js",
+    "main": "dist/fastbrowser_cli/fastbrowser_cli.js",
     "bin": {
-        "fastbrowser_cli": "./dist/fastweb_cli/fastweb_cli.js"
+        "fastbrowser_cli": "./dist/fastbrowser_cli/fastbrowser_cli.js"
     },
     "scripts": {
-        "start:fastweb_mcp": "npx tsx ./src/fastweb_mcp/fastweb_mcp.ts",
-        "start:http-server": "npx tsx ./src/fastweb_http_server/fastweb_http_server.ts",
-        "start:cli": "npx tsx ./src/fastweb_cli/fastweb_cli.ts",
-        "inspect:fastweb_mcp": "npx @modelcontextprotocol/inspector npx tsx ./src/fastweb_mcp/fastweb_mcp.ts mcp_server",
+        "start:fastbrowser_mcp": "npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts",
+        "start:http-server": "npx tsx ./src/fastbrowser_httpd/fastbrowser_httpd.ts",
+        "start:cli": "npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts",
+        "inspect:fastbrowser_mcp": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server",
         "inspect:chrome-devtools": "npx @modelcontextprotocol/inspector npx chrome-devtools-mcp@latest --autoconnect",
         "build": "tsc -p tsconfig.json",
         "publish:all": "npm run build && npm version patch && npm publish --access public",

package/{tmp/.claude/skills/fastweb → skills/fastbrowser}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: fastweb
+name: fastbrowser
 description: >
-  Control a live browser from the command line: navigate, click, fill forms, and query the accessibility tree with CSS-like selectors. Lighter alternative to Chrome DevTools MCP or Puppeteer. Triggers on: navigate/click/fill actions, page snapshots, or mentions of fastweb.
+  Control a live browser from the command line: navigate, click, fill forms, and query the accessibility tree with CSS-like selectors. Lighter alternative to Chrome DevTools MCP or Puppeteer. Triggers on: navigate/click/fill actions, page snapshots, or mentions of fastbrowser.
 ---
 
-# fastweb Skill
+# fastbrowser Skill
 
-`fastweb-cli` is a command-line client for the FastWeb HTTP server, which keeps a persistent
+`fastbrowser-cli` is a command-line client for the FastWeb HTTP server, which keeps a persistent
 MCP connection to a Chrome browser alive so commands incur minimal latency. Each command
 maps 1-to-1 to a FastWeb tool and returns the tool's response on stdout.
 
@@ -15,7 +15,7 @@ maps 1-to-1 to a FastWeb tool and returns the tool's response on stdout.
 Run the CLI directly via `tsx`:
 
 ```bash
-npx tsx ../src/fastweb_cli/fastweb_cli.ts <command> [flags]
+npx fastbrowser_cli <command> [flags]
 ```
 
 ## Typical Workflow
@@ -35,16 +35,16 @@ uid=1_0 RootWebArea "Example Domain" url="https://example.com/"
 
 ```bash
 # List all open browser pages
-npx tsx ../src/fastweb_cli/fastweb_cli.ts list_pages
+npx fastbrowser_cli list_pages
 
 # Open a new page at a URL
-npx tsx ../src/fastweb_cli/fastweb_cli.ts new_page --url https://example.com
+npx fastbrowser_cli new_page --url https://example.com
 
 # Close a page by its numeric id
-npx tsx ../src/fastweb_cli/fastweb_cli.ts close_page --page-id 1
+npx fastbrowser_cli close_page --page-id 1
 
 # Navigate the current page to a URL
-npx tsx ../src/fastweb_cli/fastweb_cli.ts navigate_page --url https://example.com
+npx fastbrowser_cli navigate_page --url https://example.com
 ```
 
 
@@ -150,44 +150,44 @@ Example queries on it:
 
 ```bash
 # Query the accessibility tree returning the FIRST match per selector (--selector is repeatable)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors --selector "button" --selector "link"
+npx fastbrowser_cli query_selectors --selector "button" --selector "link"
 
 # Exclude ancestor nodes from the result
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors --selector 'heading[level="1"]' --no-with-ancestors
+npx fastbrowser_cli query_selectors --selector 'heading[level="1"]' --no-with-ancestors
 
 # Per-selector control over withAncestors via JSON
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors \
+npx fastbrowser_cli query_selectors \
   --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
 
 # Query the accessibility tree returning ALL matches per selector (--selector is repeatable)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector "button" --selector "link" --limit 5
+npx fastbrowser_cli query_selectors_all --selector "button" --selector "link" --limit 5
 
 # Exclude ancestor nodes from the result
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
+npx fastbrowser_cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
 
 # Per-selector control over limit / withAncestors via JSON
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all \
+npx fastbrowser_cli query_selectors_all \
   --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
 
 # Take an accessibility-tree full page snapshot of the current page - very expensive, prefer targeted queries when possible
-npx tsx ../src/fastweb_cli/fastweb_cli.ts take_snapshot
+npx fastbrowser_cli take_snapshot
 ```
 
 ## Interaction
 
 ```bash
 # Click by a direct uid reference (fast path - no accessibility-tree lookup)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts click --selector "#1_42"
+npx fastbrowser_cli click --selector "#1_42"
 
 # Click by any CSS-like selector - resolved to a uid internally
-npx tsx ../src/fastweb_cli/fastweb_cli.ts click -s 'button[name="Submit"]'
+npx fastbrowser_cli click -s 'button[name="Submit"]'
 
 # Fill a single form field - selector can be a uid (#1_7) or any CSS-like selector
-npx tsx ../src/fastweb_cli/fastweb_cli.ts fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
+npx fastbrowser_cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
 
 # Press a comma-separated sequence of keys (literals and named keys both work)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts press_keys --keys "Tab, Tab, Enter"
-npx tsx ../src/fastweb_cli/fastweb_cli.ts press_keys --keys "Hello, Tab, Enter"
+npx fastbrowser_cli press_keys --keys "Tab, Tab, Enter"
+npx fastbrowser_cli press_keys --keys "Hello, Tab, Enter"
 ```
 
 ## Command Reference
@@ -211,4 +211,4 @@ npx tsx ../src/fastweb_cli/fastweb_cli.ts press_keys --keys "Hello, Tab, Enter"
 ## Output & Errors
 
 Tool output is written to **stdout** — one line per response content part. On failure the
-CLI writes `fastweb-cli error: <message>` to **stderr** and exits with code 1.
+CLI writes `fastbrowser-cli error: <message>` to **stderr** and exits with code 1.

package/src/{fastweb_cli/fastweb_cli.ts → fastbrowser_cli/fastbrowser_cli.ts}

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 
+// node imports
+import fs from 'node:fs';
+import path from 'node:path';
+
 // npm imports
 import { Command } from 'commander';
 
 // local imports
 import { HttpClient } from './libs/http-client.js';
 import { ServerManager } from './libs/server-manager.js';
-import type { QuerySelectorInput, QuerySelectorFirstInput, QuerySelectorsAllRequest, QuerySelectorRequest } from '../fastweb_http_server/libs/tool-schemas.js';
+import type { QuerySelectorInput, QuerySelectorFirstInput, QuerySelectorsAllRequest, QuerySelectorRequest } from '../fastbrowser_httpd/libs/tool-schemas.js';
 
 
 ///////////////////////////////////////////////////////////////////////////////
@@ -40,7 +44,7 @@ async function runTool(cmd: Command, routeName: string, body: unknown): Promise<
 		HttpClient.printResponse(response);
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
-		console.error(`fastweb-cli error: ${message}`);
+		console.error(`fastbrowser-cli error: ${message}`);
 		process.exit(1);
 	}
 }
@@ -127,54 +131,84 @@ function buildQuerySelectorFirstBody(opts: {
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
 
+async function runInstall(skillFolder: string): Promise<void> {
+	const sourceSkillMd = path.resolve(__dirname, '../../skills/fastbrowser/SKILL.md');
+	const targetDir = path.resolve(skillFolder, 'skills', 'fastbrowser');
+	const targetSkillMd = path.join(targetDir, 'SKILL.md');
+	try {
+		await fs.promises.mkdir(targetDir, { recursive: true });
+		await fs.promises.copyFile(sourceSkillMd, targetSkillMd);
+		console.log(`Installed fastbrowser SKILL.md at ${targetSkillMd}`);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		console.error(`fastbrowser-cli error: ${message}`);
+		process.exit(1);
+	}
+}
+
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+
 async function main(): Promise<void> {
+	const installIdx = process.argv.indexOf('--install');
+	if (installIdx !== -1) {
+		const next = process.argv[installIdx + 1];
+		const skillFolder = (next !== undefined && next.startsWith('-') === false) ? next : '.';
+		await runInstall(skillFolder);
+		return;
+	}
+
 	const program = new Command();
 	program
-		.name('fastweb-cli')
-		.description('CLI client for fastweb-http-server2')
-		.option('--server <url>', 'fastweb-http-server URL (default: env FASTWEB_SERVER or http://localhost:8787)')
+		.name('fastbrowser-cli')
+		.description('CLI client for fastbrowser')
+		.option('--server <url>', 'fastbrowser-httpd URL (default: env FASTBROWSER_SERVER or http://localhost:8787)')
 		.option('--autostart', 'Auto-start the server before a command if it is not running', true)
-		.option('--no-autostart', 'Do not auto-start the server before a command');
+		.option('--no-autostart', 'Do not auto-start the server before a command')
+		.option('--install [skill-folder]', 'Install SKILL.md into <skill-folder>/skills/fastbrowser (default: .)');
 
 	const serverCmd = program
 		.command('server')
-		.description('Manage the fastweb HTTP server');
+		.description('Manage the fastbrowser HTTP server');
 
 	serverCmd
 		.command('start')
-		.description('Start the fastweb HTTP server as a detached daemon')
+		.description('Start the fastbrowser HTTP server as a detached daemon')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			try {
 				await ServerManager.start(server);
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				console.error(`fastweb-cli error: ${message}`);
+				console.error(`fastbrowser-cli error: ${message}`);
 				process.exit(1);
 			}
 		});
 
 	serverCmd
 		.command('stop')
-		.description('Stop the fastweb HTTP server')
+		.description('Stop the fastbrowser HTTP server')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			try {
 				await ServerManager.stop(server);
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				console.error(`fastweb-cli error: ${message}`);
+				console.error(`fastbrowser-cli error: ${message}`);
 				process.exit(1);
 			}
 		});
 
 	serverCmd
 		.command('status')
-		.description('Report whether the fastweb HTTP server is running')
+		.description('Report whether the fastbrowser HTTP server is running')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			const state = await ServerManager.status(server);
-			console.log(`fastweb server at ${server}: ${state}`);
+			console.log(`fastbrowser server at ${server}: ${state}`);
 			if (state === 'stopped') process.exit(1);
 		});
 
@@ -254,7 +288,7 @@ async function main(): Promise<void> {
 			try {
 				body = buildQuerySelectorsBody(opts);
 			} catch (err) {
-				console.error(`fastweb-cli error: ${(err as Error).message}`);
+				console.error(`fastbrowser-cli error: ${(err as Error).message}`);
 				process.exit(1);
 			}
 			await runTool(cmd, 'query_selectors_all', body);
@@ -279,7 +313,7 @@ async function main(): Promise<void> {
 			try {
 				body = buildQuerySelectorFirstBody(opts);
 			} catch (err) {
-				console.error(`fastweb-cli error: ${(err as Error).message}`);
+				console.error(`fastbrowser-cli error: ${(err as Error).message}`);
 				process.exit(1);
 			}
 			await runTool(cmd, 'query_selectors', body);