real-browser-mcp-server 1.5.1 → 2.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -41
- package/dist/lib/cjs/index.d.ts +14 -1
- package/dist/lib/cjs/index.d.ts.map +1 -1
- package/dist/lib/cjs/index.js +5 -3
- package/dist/lib/cjs/index.js.map +1 -1
- package/dist/lib/cjs/module/pageController.d.ts +7 -1
- package/dist/lib/cjs/module/pageController.d.ts.map +1 -1
- package/dist/lib/cjs/module/pageController.js +4 -23
- package/dist/lib/cjs/module/pageController.js.map +1 -1
- package/dist/lib/cjs/module/turnstile.d.ts +4 -1
- package/dist/lib/cjs/module/turnstile.d.ts.map +1 -1
- package/dist/lib/cjs/module/turnstile.js +14 -13
- package/dist/lib/cjs/module/turnstile.js.map +1 -1
- package/dist/lib/esm/index.d.mjs +11 -0
- package/dist/lib/esm/index.mjs +4 -0
- package/dist/lib/esm/module/pageController.d.mjs +3 -0
- package/dist/lib/esm/module/turnstile.d.mjs +3 -0
- package/dist/scripts/generate-esm.d.ts +2 -0
- package/dist/scripts/generate-esm.d.ts.map +1 -0
- package/dist/scripts/generate-esm.js +100 -0
- package/dist/scripts/generate-esm.js.map +1 -0
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +0 -1
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/handlers/browser.d.ts +8 -7
- package/dist/src/mcp/handlers/browser.d.ts.map +1 -1
- package/dist/src/mcp/handlers/browser.js +4 -3
- package/dist/src/mcp/handlers/browser.js.map +1 -1
- package/dist/src/mcp/handlers/dom.d.ts +19 -18
- package/dist/src/mcp/handlers/dom.d.ts.map +1 -1
- package/dist/src/mcp/handlers/dom.js +7 -28
- package/dist/src/mcp/handlers/dom.js.map +1 -1
- package/dist/src/mcp/handlers/extract.js.map +1 -1
- package/dist/src/mcp/handlers/handler-utils.d.ts +14 -0
- package/dist/src/mcp/handlers/handler-utils.d.ts.map +1 -0
- package/dist/src/mcp/handlers/handler-utils.js +42 -0
- package/dist/src/mcp/handlers/handler-utils.js.map +1 -0
- package/dist/src/mcp/handlers/helpers.d.ts +0 -7
- package/dist/src/mcp/handlers/helpers.d.ts.map +1 -1
- package/dist/src/mcp/handlers/helpers.js +0 -15
- package/dist/src/mcp/handlers/helpers.js.map +1 -1
- package/dist/src/mcp/handlers/media-handlers.d.ts +2 -1
- package/dist/src/mcp/handlers/media-handlers.d.ts.map +1 -1
- package/dist/src/mcp/handlers/media-handlers.js +24 -8
- package/dist/src/mcp/handlers/media-handlers.js.map +1 -1
- package/dist/src/mcp/handlers/network-extractors.d.ts +2 -0
- package/dist/src/mcp/handlers/network-extractors.d.ts.map +1 -0
- package/dist/src/mcp/handlers/network-extractors.js +651 -0
- package/dist/src/mcp/handlers/network-extractors.js.map +1 -0
- package/dist/src/mcp/handlers/network-recorder.d.ts +119 -0
- package/dist/src/mcp/handlers/network-recorder.d.ts.map +1 -0
- package/dist/src/mcp/handlers/network-recorder.js +337 -0
- package/dist/src/mcp/handlers/network-recorder.js.map +1 -0
- package/dist/src/mcp/handlers/network.d.ts +30 -118
- package/dist/src/mcp/handlers/network.d.ts.map +1 -1
- package/dist/src/mcp/handlers/network.js +28 -1187
- package/dist/src/mcp/handlers/network.js.map +1 -1
- package/dist/src/mcp/handlers/state.d.ts +1 -0
- package/dist/src/mcp/handlers/state.d.ts.map +1 -1
- package/dist/src/mcp/handlers/state.js +17 -0
- package/dist/src/mcp/handlers/state.js.map +1 -1
- package/dist/src/mcp/handlers/utility-handlers.d.ts +8 -37
- package/dist/src/mcp/handlers/utility-handlers.d.ts.map +1 -1
- package/dist/src/mcp/handlers/utility-handlers.js +69 -31
- package/dist/src/mcp/handlers/utility-handlers.js.map +1 -1
- package/dist/src/mcp/handlers/vision-captcha.d.ts +221 -0
- package/dist/src/mcp/handlers/vision-captcha.d.ts.map +1 -0
- package/dist/src/mcp/handlers/vision-captcha.js +238 -0
- package/dist/src/mcp/handlers/vision-captcha.js.map +1 -0
- package/dist/src/mcp/handlers/vision-see-page.d.ts +32 -0
- package/dist/src/mcp/handlers/vision-see-page.d.ts.map +1 -0
- package/dist/src/mcp/handlers/vision-see-page.js +260 -0
- package/dist/src/mcp/handlers/vision-see-page.js.map +1 -0
- package/dist/src/mcp/handlers/vision.d.ts +50 -27
- package/dist/src/mcp/handlers/vision.d.ts.map +1 -1
- package/dist/src/mcp/handlers/vision.js +4 -606
- package/dist/src/mcp/handlers/vision.js.map +1 -1
- package/dist/src/mcp/index.d.ts.map +1 -1
- package/dist/src/mcp/index.js +11 -3
- package/dist/src/mcp/index.js.map +1 -1
- package/dist/src/shared/cache-manager.d.ts +0 -2
- package/dist/src/shared/cache-manager.d.ts.map +1 -1
- package/dist/src/shared/cache-manager.js +1 -3
- package/dist/src/shared/cache-manager.js.map +1 -1
- package/dist/src/shared/lib-core.d.ts +2 -1
- package/dist/src/shared/lib-core.d.ts.map +1 -1
- package/dist/src/shared/lib-core.js +5 -38
- package/dist/src/shared/lib-core.js.map +1 -1
- package/dist/src/shared/tools.d.ts.map +1 -1
- package/dist/src/shared/tools.js +6 -18
- package/dist/src/shared/tools.js.map +1 -1
- package/dist/src/types.d.ts +25 -6
- package/dist/src/types.d.ts.map +1 -1
- package/dist/test/cjs/test.js +29 -33
- package/dist/test/cjs/test.js.map +1 -1
- package/dist/test/mcp/smoke-test.d.ts.map +1 -1
- package/dist/test/mcp/smoke-test.js +9 -3
- package/dist/test/mcp/smoke-test.js.map +1 -1
- package/dist/test/unit/handler-test.d.ts +3 -0
- package/dist/test/unit/handler-test.d.ts.map +1 -0
- package/dist/test/unit/handler-test.js +133 -0
- package/dist/test/unit/handler-test.js.map +1 -0
- package/lib/esm/module/pageController.mjs +4 -22
- package/lib/esm/module/turnstile.mjs +16 -13
- package/package.json +5 -4
- package/typings.d.ts +5 -40
package/typings.d.ts
CHANGED
|
@@ -7,6 +7,7 @@ declare module "real-browser-mcp-server" {
|
|
|
7
7
|
interface PageWithCursor extends Page {
|
|
8
8
|
realClick: GhostCursor["click"];
|
|
9
9
|
realCursor: GhostCursor;
|
|
10
|
+
realScroll: (deltaY: number, duration?: number) => Promise<void>;
|
|
10
11
|
}
|
|
11
12
|
|
|
12
13
|
type ConnectResult = {
|
|
@@ -14,23 +15,20 @@ declare module "real-browser-mcp-server" {
|
|
|
14
15
|
page: PageWithCursor;
|
|
15
16
|
/** Blocker instance for advanced usage (null if enableBlocker is false) */
|
|
16
17
|
blocker: BraveBlocker | null;
|
|
18
|
+
/** Setup function to inject stealth into new pages */
|
|
19
|
+
setupPage: (page: Page) => Promise<void>;
|
|
17
20
|
};
|
|
18
21
|
|
|
19
22
|
interface Options {
|
|
20
23
|
args?: string[];
|
|
21
24
|
headless?: boolean;
|
|
22
|
-
|
|
25
|
+
contextOptions?: Record<string, unknown>;
|
|
23
26
|
proxy?: ProxyOptions;
|
|
24
27
|
turnstile?: boolean;
|
|
25
|
-
connectOption?: any;
|
|
26
|
-
disableXvfb?: boolean;
|
|
27
|
-
ignoreAllFlags?: boolean;
|
|
28
28
|
/** Path to the browser executable (defaults to auto-detected Brave browser or falls back to Chromium) */
|
|
29
29
|
executablePath?: string;
|
|
30
30
|
/** Enable blocker on all pages (default: true) */
|
|
31
31
|
enableBlocker?: boolean;
|
|
32
|
-
/** Blocker configuration options */
|
|
33
|
-
blockerOptions?: BlockerOptions;
|
|
34
32
|
}
|
|
35
33
|
|
|
36
34
|
interface ProxyOptions {
|
|
@@ -40,46 +38,13 @@ declare module "real-browser-mcp-server" {
|
|
|
40
38
|
password?: string;
|
|
41
39
|
}
|
|
42
40
|
|
|
43
|
-
interface BlockerOptions {
|
|
44
|
-
/** Enable standard network request blocking (Ads/Trackers) - default: true */
|
|
45
|
-
enableAdBlocking?: boolean;
|
|
46
|
-
/** Enable stealth evasions (Navigator, WebGL, etc.) - default: true */
|
|
47
|
-
enableStealth?: boolean;
|
|
48
|
-
/** Enable cosmetic filtering (Element hiding) - default: true */
|
|
49
|
-
enableCosmeticFiltering?: boolean;
|
|
50
|
-
/** Enable advanced redirect and popup blocking - default: true */
|
|
51
|
-
enableRedirectBlocking?: boolean;
|
|
52
|
-
/** Enable scriptlet injection for anti-adblock evasion - default: true */
|
|
53
|
-
enableScriptlets?: boolean;
|
|
54
|
-
/** Path to custom filter list file */
|
|
55
|
-
customFiltersPath?: string;
|
|
56
|
-
/** Enable auto-update of uBlock Origin filters - default: true */
|
|
57
|
-
enableFilterAutoUpdate?: boolean;
|
|
58
|
-
/** Filter updater options */
|
|
59
|
-
filterUpdaterOptions?: FilterUpdaterOptions;
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
interface FilterUpdaterOptions {
|
|
63
|
-
/** Cache duration in milliseconds - default: 24 hours */
|
|
64
|
-
cacheDuration?: number;
|
|
65
|
-
/** Custom filters path */
|
|
66
|
-
customFiltersPath?: string;
|
|
67
|
-
/** Enable verbose logging */
|
|
68
|
-
verbose?: boolean;
|
|
69
|
-
}
|
|
70
|
-
|
|
71
41
|
/** BraveBlocker class for advanced ad/tracker blocking */
|
|
72
42
|
interface BraveBlocker {
|
|
73
43
|
/** Initialize the blocker engine */
|
|
74
44
|
init(): Promise<void>;
|
|
75
45
|
/** Enable blocking on a page */
|
|
76
|
-
|
|
46
|
+
enableBlockingInPage(page: Page): Promise<void>;
|
|
77
47
|
/** Check if a URL should be blocked */
|
|
78
48
|
shouldBlock(url: string): boolean;
|
|
79
49
|
}
|
|
80
50
|
}
|
|
81
|
-
|
|
82
|
-
declare module "real-browser-mcp-server" {
|
|
83
|
-
export * from "real-browser-mcp-server";
|
|
84
|
-
}
|
|
85
|
-
|