real-browser-mcp-server 1.5.1 → 2.0.0

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.
Files changed (106) hide show
  1. package/README.md +46 -41
  2. package/dist/lib/cjs/index.d.ts +14 -1
  3. package/dist/lib/cjs/index.d.ts.map +1 -1
  4. package/dist/lib/cjs/index.js +5 -3
  5. package/dist/lib/cjs/index.js.map +1 -1
  6. package/dist/lib/cjs/module/pageController.d.ts +7 -1
  7. package/dist/lib/cjs/module/pageController.d.ts.map +1 -1
  8. package/dist/lib/cjs/module/pageController.js +4 -23
  9. package/dist/lib/cjs/module/pageController.js.map +1 -1
  10. package/dist/lib/cjs/module/turnstile.d.ts +4 -1
  11. package/dist/lib/cjs/module/turnstile.d.ts.map +1 -1
  12. package/dist/lib/cjs/module/turnstile.js +14 -13
  13. package/dist/lib/cjs/module/turnstile.js.map +1 -1
  14. package/dist/lib/esm/index.d.mjs +11 -0
  15. package/dist/lib/esm/index.mjs +4 -0
  16. package/dist/lib/esm/module/pageController.d.mjs +3 -0
  17. package/dist/lib/esm/module/turnstile.d.mjs +3 -0
  18. package/dist/scripts/generate-esm.d.ts +2 -0
  19. package/dist/scripts/generate-esm.d.ts.map +1 -0
  20. package/dist/scripts/generate-esm.js +100 -0
  21. package/dist/scripts/generate-esm.js.map +1 -0
  22. package/dist/src/index.d.ts.map +1 -1
  23. package/dist/src/index.js +0 -1
  24. package/dist/src/index.js.map +1 -1
  25. package/dist/src/mcp/handlers/browser.d.ts +8 -7
  26. package/dist/src/mcp/handlers/browser.d.ts.map +1 -1
  27. package/dist/src/mcp/handlers/browser.js +4 -3
  28. package/dist/src/mcp/handlers/browser.js.map +1 -1
  29. package/dist/src/mcp/handlers/dom.d.ts +19 -18
  30. package/dist/src/mcp/handlers/dom.d.ts.map +1 -1
  31. package/dist/src/mcp/handlers/dom.js +7 -28
  32. package/dist/src/mcp/handlers/dom.js.map +1 -1
  33. package/dist/src/mcp/handlers/extract.js.map +1 -1
  34. package/dist/src/mcp/handlers/handler-utils.d.ts +14 -0
  35. package/dist/src/mcp/handlers/handler-utils.d.ts.map +1 -0
  36. package/dist/src/mcp/handlers/handler-utils.js +42 -0
  37. package/dist/src/mcp/handlers/handler-utils.js.map +1 -0
  38. package/dist/src/mcp/handlers/helpers.d.ts +0 -7
  39. package/dist/src/mcp/handlers/helpers.d.ts.map +1 -1
  40. package/dist/src/mcp/handlers/helpers.js +0 -15
  41. package/dist/src/mcp/handlers/helpers.js.map +1 -1
  42. package/dist/src/mcp/handlers/media-handlers.d.ts +2 -1
  43. package/dist/src/mcp/handlers/media-handlers.d.ts.map +1 -1
  44. package/dist/src/mcp/handlers/media-handlers.js +24 -8
  45. package/dist/src/mcp/handlers/media-handlers.js.map +1 -1
  46. package/dist/src/mcp/handlers/network-extractors.d.ts +2 -0
  47. package/dist/src/mcp/handlers/network-extractors.d.ts.map +1 -0
  48. package/dist/src/mcp/handlers/network-extractors.js +651 -0
  49. package/dist/src/mcp/handlers/network-extractors.js.map +1 -0
  50. package/dist/src/mcp/handlers/network-recorder.d.ts +119 -0
  51. package/dist/src/mcp/handlers/network-recorder.d.ts.map +1 -0
  52. package/dist/src/mcp/handlers/network-recorder.js +337 -0
  53. package/dist/src/mcp/handlers/network-recorder.js.map +1 -0
  54. package/dist/src/mcp/handlers/network.d.ts +30 -118
  55. package/dist/src/mcp/handlers/network.d.ts.map +1 -1
  56. package/dist/src/mcp/handlers/network.js +28 -1187
  57. package/dist/src/mcp/handlers/network.js.map +1 -1
  58. package/dist/src/mcp/handlers/state.d.ts +1 -0
  59. package/dist/src/mcp/handlers/state.d.ts.map +1 -1
  60. package/dist/src/mcp/handlers/state.js +17 -0
  61. package/dist/src/mcp/handlers/state.js.map +1 -1
  62. package/dist/src/mcp/handlers/utility-handlers.d.ts +8 -37
  63. package/dist/src/mcp/handlers/utility-handlers.d.ts.map +1 -1
  64. package/dist/src/mcp/handlers/utility-handlers.js +69 -31
  65. package/dist/src/mcp/handlers/utility-handlers.js.map +1 -1
  66. package/dist/src/mcp/handlers/vision-captcha.d.ts +221 -0
  67. package/dist/src/mcp/handlers/vision-captcha.d.ts.map +1 -0
  68. package/dist/src/mcp/handlers/vision-captcha.js +238 -0
  69. package/dist/src/mcp/handlers/vision-captcha.js.map +1 -0
  70. package/dist/src/mcp/handlers/vision-see-page.d.ts +32 -0
  71. package/dist/src/mcp/handlers/vision-see-page.d.ts.map +1 -0
  72. package/dist/src/mcp/handlers/vision-see-page.js +260 -0
  73. package/dist/src/mcp/handlers/vision-see-page.js.map +1 -0
  74. package/dist/src/mcp/handlers/vision.d.ts +50 -27
  75. package/dist/src/mcp/handlers/vision.d.ts.map +1 -1
  76. package/dist/src/mcp/handlers/vision.js +4 -606
  77. package/dist/src/mcp/handlers/vision.js.map +1 -1
  78. package/dist/src/mcp/index.d.ts.map +1 -1
  79. package/dist/src/mcp/index.js +11 -3
  80. package/dist/src/mcp/index.js.map +1 -1
  81. package/dist/src/shared/cache-manager.d.ts +0 -2
  82. package/dist/src/shared/cache-manager.d.ts.map +1 -1
  83. package/dist/src/shared/cache-manager.js +1 -3
  84. package/dist/src/shared/cache-manager.js.map +1 -1
  85. package/dist/src/shared/lib-core.d.ts +2 -1
  86. package/dist/src/shared/lib-core.d.ts.map +1 -1
  87. package/dist/src/shared/lib-core.js +5 -38
  88. package/dist/src/shared/lib-core.js.map +1 -1
  89. package/dist/src/shared/tools.d.ts.map +1 -1
  90. package/dist/src/shared/tools.js +6 -18
  91. package/dist/src/shared/tools.js.map +1 -1
  92. package/dist/src/types.d.ts +25 -6
  93. package/dist/src/types.d.ts.map +1 -1
  94. package/dist/test/cjs/test.js +29 -33
  95. package/dist/test/cjs/test.js.map +1 -1
  96. package/dist/test/mcp/smoke-test.d.ts.map +1 -1
  97. package/dist/test/mcp/smoke-test.js +9 -3
  98. package/dist/test/mcp/smoke-test.js.map +1 -1
  99. package/dist/test/unit/handler-test.d.ts +3 -0
  100. package/dist/test/unit/handler-test.d.ts.map +1 -0
  101. package/dist/test/unit/handler-test.js +133 -0
  102. package/dist/test/unit/handler-test.js.map +1 -0
  103. package/lib/esm/module/pageController.mjs +4 -22
  104. package/lib/esm/module/turnstile.mjs +16 -13
  105. package/package.json +5 -4
  106. package/typings.d.ts +5 -40
@@ -1,131 +1,65 @@
1
+ import type { RedirectTracerParams, NetworkRecorderParams } from '../../types';
1
2
  export declare const networkHandlers: {
2
- redirect_tracer(params: any): Promise<{
3
+ redirect_tracer(params: RedirectTracerParams): Promise<{
3
4
  success: boolean;
4
- originalUrl: any;
5
+ originalUrl: string;
5
6
  finalUrl: string;
6
7
  redirectCount: number;
7
8
  httpRedirects: any[];
8
9
  jsNavigations: any[];
9
10
  allRedirects: any[];
10
11
  }>;
11
- network_recorder(params?: any): Promise<{
12
+ network_recorder(params?: NetworkRecorderParams): Promise<{
12
13
  success: boolean;
13
14
  count: number;
14
15
  mediaUrls: {
15
- url: string;
16
- type: string | undefined;
16
+ url: any;
17
+ type: any;
17
18
  }[];
18
- navigations?: undefined;
19
- apiCalls?: undefined;
20
- interceptedApis?: undefined;
21
- note?: undefined;
22
- error?: undefined;
23
- totalMessages?: undefined;
24
- websockets?: undefined;
25
- graphql?: undefined;
26
- har?: undefined;
27
- recording?: undefined;
28
- records?: undefined;
29
19
  } | {
30
20
  success: boolean;
31
21
  count: number;
32
22
  navigations: import("../../types").NetworkRecord[];
33
- mediaUrls?: undefined;
34
- apiCalls?: undefined;
35
- interceptedApis?: undefined;
36
- note?: undefined;
37
- error?: undefined;
38
- totalMessages?: undefined;
39
- websockets?: undefined;
40
- graphql?: undefined;
41
- har?: undefined;
42
- recording?: undefined;
43
- records?: undefined;
44
23
  } | {
45
24
  success: boolean;
46
25
  count: number;
47
26
  apiCalls: {
48
- url: string;
49
- method: string;
50
- status: number | undefined;
51
- contentType: string | undefined;
52
- resourceType: string | undefined;
53
- requestBody: string | null;
54
- responseBody: string | null;
55
- responseJson: {} | null;
56
- timestamp: number;
27
+ url: any;
28
+ method: any;
29
+ status: any;
30
+ contentType: any;
31
+ resourceType: any;
32
+ requestBody: any;
33
+ responseBody: any;
34
+ responseJson: any;
35
+ timestamp: any;
57
36
  }[];
58
- mediaUrls?: undefined;
59
- navigations?: undefined;
60
- interceptedApis?: undefined;
61
- note?: undefined;
62
- error?: undefined;
63
- totalMessages?: undefined;
64
- websockets?: undefined;
65
- graphql?: undefined;
66
- har?: undefined;
67
- recording?: undefined;
68
- records?: undefined;
69
37
  } | {
70
38
  success: boolean;
71
- count: number;
72
- interceptedApis: any[];
39
+ count: any;
40
+ interceptedApis: any;
73
41
  note: string;
74
- mediaUrls?: undefined;
75
- navigations?: undefined;
76
- apiCalls?: undefined;
77
42
  error?: undefined;
78
- totalMessages?: undefined;
79
- websockets?: undefined;
80
- graphql?: undefined;
81
- har?: undefined;
82
- recording?: undefined;
83
- records?: undefined;
84
43
  } | {
85
44
  success: boolean;
86
45
  error: string;
87
46
  interceptedApis: never[];
88
47
  count?: undefined;
89
- mediaUrls?: undefined;
90
- navigations?: undefined;
91
- apiCalls?: undefined;
92
48
  note?: undefined;
93
- totalMessages?: undefined;
94
- websockets?: undefined;
95
- graphql?: undefined;
96
- har?: undefined;
97
- recording?: undefined;
98
- records?: undefined;
99
49
  } | {
100
50
  success: boolean;
101
- count: number;
51
+ count: any;
102
52
  totalMessages: any;
103
- websockets: any[];
53
+ websockets: any;
104
54
  note: string;
105
- mediaUrls?: undefined;
106
- navigations?: undefined;
107
- apiCalls?: undefined;
108
- interceptedApis?: undefined;
109
55
  error?: undefined;
110
- graphql?: undefined;
111
- har?: undefined;
112
- recording?: undefined;
113
- records?: undefined;
114
56
  } | {
115
57
  success: boolean;
116
58
  error: string;
117
59
  websockets: never[];
118
60
  count?: undefined;
119
- mediaUrls?: undefined;
120
- navigations?: undefined;
121
- apiCalls?: undefined;
122
- interceptedApis?: undefined;
123
- note?: undefined;
124
61
  totalMessages?: undefined;
125
- graphql?: undefined;
126
- har?: undefined;
127
- recording?: undefined;
128
- records?: undefined;
62
+ note?: undefined;
129
63
  } | {
130
64
  success: boolean;
131
65
  count: number;
@@ -138,17 +72,6 @@ export declare const networkHandlers: {
138
72
  response: any;
139
73
  timestamp: any;
140
74
  }[];
141
- mediaUrls?: undefined;
142
- navigations?: undefined;
143
- apiCalls?: undefined;
144
- interceptedApis?: undefined;
145
- note?: undefined;
146
- error?: undefined;
147
- totalMessages?: undefined;
148
- websockets?: undefined;
149
- har?: undefined;
150
- recording?: undefined;
151
- records?: undefined;
152
75
  } | {
153
76
  success: boolean;
154
77
  count: number;
@@ -174,41 +97,30 @@ export declare const networkHandlers: {
174
97
  };
175
98
  response: {
176
99
  status: any;
100
+ headers: {
101
+ name: string;
102
+ value: string;
103
+ }[];
177
104
  content: {
178
105
  mimeType: any;
179
106
  text: any;
107
+ size: any;
180
108
  };
181
109
  };
182
110
  time: number;
183
111
  }[];
184
112
  };
185
113
  };
186
- mediaUrls?: undefined;
187
- navigations?: undefined;
188
- apiCalls?: undefined;
189
- interceptedApis?: undefined;
190
- note?: undefined;
191
- error?: undefined;
192
- totalMessages?: undefined;
193
- websockets?: undefined;
194
- graphql?: undefined;
195
- recording?: undefined;
196
- records?: undefined;
197
114
  } | {
198
115
  success: boolean;
199
116
  recording: boolean;
200
117
  count: number;
201
118
  records: import("../../types").NetworkRecord[];
202
- mediaUrls?: undefined;
203
- navigations?: undefined;
204
- apiCalls?: undefined;
205
- interceptedApis?: undefined;
206
- note?: undefined;
207
- error?: undefined;
208
- totalMessages?: undefined;
209
- websockets?: undefined;
210
- graphql?: undefined;
211
- har?: undefined;
119
+ } | {
120
+ success: boolean;
121
+ message: string;
122
+ } | {
123
+ success: boolean;
212
124
  }>;
213
125
  extract_data(params?: any): Promise<any>;
214
126
  replay_request(params: any): Promise<{
@@ -1 +1 @@
1
- {"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/mcp/handlers/network.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe;4BACI,GAAG;;;;;;;;;8BAiHF,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA4WP,GAAG;2BA6wBD,GAAG;;;;;;;;;;;;;;;CAuBjC,CAAC"}
1
+ {"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/mcp/handlers/network.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE/E,eAAO,MAAM,eAAe;4BACI,oBAAoB;;;;;;;;;8BAmEnB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAoBzB,GAAG;2BAID,GAAG;;;;;;;;;;;;;;;CAgBjC,CAAC"}