web-fetcher-mcp 1.0.17 → 1.0.18
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 +107 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -330,19 +330,40 @@ MCP 提供了两套操作方式，使用时需要注意它们的区别：
|
|
|
330
330
|
|
|
331
331
|
### 7. open-devtools
|
|
332
332
|
|
|
333
|
-
|
|
333
|
+
打开浏览器 F12 开发者工具（DevTools）面板，支持手机设备模拟。
|
|
334
334
|
|
|
335
335
|
#### 参数说明
|
|
336
336
|
|
|
337
337
|
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|
|
338
338
|
|------|------|------|--------|------|
|
|
339
|
-
|
|
|
339
|
+
| url | string | 否 | 'current' | 网页 URL，使用 'current' 则操作当前已打开的页面 |
|
|
340
|
+
| isMobile | boolean | 否 | false | 是否开启手机设备模式 |
|
|
341
|
+
| mobileDevice | string | 否 | 'iPhone 13' | 模拟的手机设备型号（iPhone 13、Pixel 5、Galaxy S21 等） |
|
|
342
|
+
| useExistingPage | boolean | 否 | true | 是否使用已存在的页面 |
|
|
343
|
+
|
|
344
|
+
#### 示例
|
|
345
|
+
|
|
346
|
+
```json
|
|
347
|
+
// 桌面模式打开 DevTools
|
|
348
|
+
{ "isMobile": false }
|
|
349
|
+
|
|
350
|
+
// 手机模式（iPhone 13）
|
|
351
|
+
{ "isMobile": true, "mobileDevice": "iPhone 13" }
|
|
352
|
+
```
|
|
340
353
|
|
|
341
354
|
---
|
|
342
355
|
|
|
343
356
|
### 8. get-console-logs
|
|
344
357
|
|
|
345
|
-
|
|
358
|
+
获取浏览器控制台日志（console.log、console.error、console.warn 等）。
|
|
359
|
+
|
|
360
|
+
#### 参数说明
|
|
361
|
+
|
|
362
|
+
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|
|
363
|
+
|------|------|------|--------|------|
|
|
364
|
+
| url | string | 否 | 'current' | 网页 URL |
|
|
365
|
+
| logTypes | string[] | 否 | ['all'] | 日志类型：error/warn/log/info/debug/all |
|
|
366
|
+
| clearAfterGet | boolean | 否 | false | 获取后是否清空缓冲区 |
|
|
346
367
|
|
|
347
368
|
---
|
|
348
369
|
|
|
@@ -555,6 +576,89 @@ MCP 提供了两套操作方式，使用时需要注意它们的区别：
|
|
|
555
576
|
|
|
556
577
|
---
|
|
557
578
|
|
|
579
|
+
### 17. list-tabs
|
|
580
|
+
|
|
581
|
+
列出浏览器中当前打开的所有标签页，包括 ID、URL、标题和活跃状态。
|
|
582
|
+
|
|
583
|
+
#### 参数说明
|
|
584
|
+
|
|
585
|
+
无参数。
|
|
586
|
+
|
|
587
|
+
#### 示例
|
|
588
|
+
|
|
589
|
+
```json
|
|
590
|
+
{ "name": "list-tabs" }
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
返回示例：
|
|
594
|
+
```
|
|
595
|
+
总标签数: 3
|
|
596
|
+
1. [tab_1] 营业数据 (http://localhost:8090/...) ⬅️ 当前
|
|
597
|
+
2. [tab_2] uni-app官网 (https://uniapp.dcloud.net.cn/)
|
|
598
|
+
3. [tab_3] W3Schools (https://www.w3schools.com/...)
|
|
599
|
+
```
|
|
600
|
+
|
|
601
|
+
---
|
|
602
|
+
|
|
603
|
+
### 18. switch-tab
|
|
604
|
+
|
|
605
|
+
切换或关闭指定标签页。
|
|
606
|
+
|
|
607
|
+
#### 参数说明
|
|
608
|
+
|
|
609
|
+
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|
|
610
|
+
|------|------|------|--------|------|
|
|
611
|
+
| tabId | string | 是 | - | 目标标签页的 ID（通过 list-tabs 获取） |
|
|
612
|
+
| action | string | 否 | 'switch' | 操作类型：switch（切换）/ close（关闭） |
|
|
613
|
+
|
|
614
|
+
#### 示例
|
|
615
|
+
|
|
616
|
+
```json
|
|
617
|
+
// 切换到 tab_2
|
|
618
|
+
{ "tabId": "tab_2", "action": "switch" }
|
|
619
|
+
|
|
620
|
+
// 关闭 tab_3
|
|
621
|
+
{ "tabId": "tab_3", "action": "close" }
|
|
622
|
+
```
|
|
623
|
+
|
|
624
|
+
---
|
|
625
|
+
|
|
626
|
+
### 19. close-browser
|
|
627
|
+
|
|
628
|
+
断开浏览器连接。如果连接的是你已有的 Chrome，仅断开 CDP 连接（不关闭浏览器窗口）；如果是 MCP 自启动的浏览器实例，会直接关闭窗口。
|
|
629
|
+
|
|
630
|
+
#### 参数说明
|
|
631
|
+
|
|
632
|
+
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|
|
633
|
+
|------|------|------|--------|------|
|
|
634
|
+
| confirm | boolean | 否 | true | 确认操作 |
|
|
635
|
+
|
|
636
|
+
---
|
|
637
|
+
|
|
638
|
+
## 多标签页使用指南
|
|
639
|
+
|
|
640
|
+
从 v1.0.16 起，MCP 支持多标签页操作。浏览器连接在整个会话期间保持活跃，不会在每次工具调用后断开。
|
|
641
|
+
|
|
642
|
+
### 基本流程
|
|
643
|
+
|
|
644
|
+
```
|
|
645
|
+
1. fetch-web-page(url) → 打开页面（自动新建标签）
|
|
646
|
+
2. list-tabs → 查看所有标签页
|
|
647
|
+
3. switch-tab(tabId, 'switch') → 切换标签
|
|
648
|
+
4. 在当前标签上执行各种操作 → click、scroll、execute-js 等
|
|
649
|
+
5. switch-tab(tabId, 'close') → 关闭不需要的标签
|
|
650
|
+
6. close-browser → 完成后断开连接
|
|
651
|
+
```
|
|
652
|
+
|
|
653
|
+
### 注意事项
|
|
654
|
+
|
|
655
|
+
- 标签页 ID 在整个会话期间保持稳定
|
|
656
|
+
- 手动在浏览器中切换标签会被自动检测
|
|
657
|
+
- SPA（单页应用）导航后页面不会丢失
|
|
658
|
+
- MCP 重启后标签 ID 会重新分配，但会从浏览器自动恢复
|
|
659
|
+
|
|
660
|
+
---
|
|
661
|
+
|
|
558
662
|
## 数据存储
|
|
559
663
|
|
|
560
664
|
| 数据类型 | 存储位置 |
|