botbrowser-mcp 0.1.9 → 1.0.1
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/dist/db/database.js +8 -0
- package/dist/db/database.js.map +1 -1
- package/dist/db/repositories/profile.d.ts +2 -0
- package/dist/db/repositories/profile.js +6 -3
- package/dist/db/repositories/profile.js.map +1 -1
- package/dist/playwright/manager.js +20 -11
- package/dist/playwright/manager.js.map +1 -1
- package/package.json +1 -1
- package/readme.md +63 -9
package/dist/db/database.js
CHANGED
|
@@ -22,6 +22,7 @@ export function initDatabase() {
|
|
|
22
22
|
executable_path TEXT NOT NULL,
|
|
23
23
|
fingerprint_path TEXT,
|
|
24
24
|
storage_state_path TEXT,
|
|
25
|
+
user_data_dir TEXT,
|
|
25
26
|
description TEXT,
|
|
26
27
|
proxy_server TEXT,
|
|
27
28
|
proxy_username TEXT,
|
|
@@ -31,6 +32,13 @@ export function initDatabase() {
|
|
|
31
32
|
last_used TEXT
|
|
32
33
|
)
|
|
33
34
|
`);
|
|
35
|
+
// 迁移：为现有表添加 user_data_dir 字段（如果不存在）
|
|
36
|
+
try {
|
|
37
|
+
db.exec(`ALTER TABLE browser_profiles ADD COLUMN user_data_dir TEXT`);
|
|
38
|
+
}
|
|
39
|
+
catch (error) {
|
|
40
|
+
// 字段已存在，忽略错误
|
|
41
|
+
}
|
|
34
42
|
// 账号表
|
|
35
43
|
db.exec(`
|
|
36
44
|
CREATE TABLE IF NOT EXISTS accounts (
|
package/dist/db/database.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEnD,SAAS;AACT,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAA2B,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AAGhE,SAAS;AACT,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/B,MAAM,UAAU,YAAY;IAC1B,SAAS;IACT,EAAE,CAAC,IAAI,CAAC
|
|
1
|
+
{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEnD,SAAS;AACT,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAA2B,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AAGhE,SAAS;AACT,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/B,MAAM,UAAU,YAAY;IAC1B,SAAS;IACT,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;GAeP,CAAC,CAAC;IAEH,oCAAoC;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa;IACf,CAAC;IAED,MAAM;IACN,EAAE,CAAC,IAAI,CAAC;;;;;;;;;GASP,CAAC,CAAC;IAEH,SAAS;IACT,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;GAWP,CAAC,CAAC;IAEH,OAAO;IACP,EAAE,CAAC,IAAI,CAAC;;;;GAIP,CAAC,CAAC;AACL,CAAC"}
|
|
@@ -3,6 +3,7 @@ export interface BrowserProfile {
|
|
|
3
3
|
executable_path: string;
|
|
4
4
|
fingerprint_path?: string;
|
|
5
5
|
storage_state_path?: string;
|
|
6
|
+
user_data_dir?: string;
|
|
6
7
|
description?: string;
|
|
7
8
|
proxy_server?: string;
|
|
8
9
|
proxy_username?: string;
|
|
@@ -18,4 +19,5 @@ export declare class ProfileRepository {
|
|
|
18
19
|
update(alias: string, updates: Partial<BrowserProfile>): void;
|
|
19
20
|
delete(alias: string): void;
|
|
20
21
|
updateLastUsed(alias: string): void;
|
|
22
|
+
updateUserDataDir(alias: string, userDataDir: string): void;
|
|
21
23
|
}
|
|
@@ -12,11 +12,11 @@ export class ProfileRepository {
|
|
|
12
12
|
create(profile) {
|
|
13
13
|
const stmt = db.prepare(`
|
|
14
14
|
INSERT INTO browser_profiles (
|
|
15
|
-
alias, executable_path, fingerprint_path, storage_state_path,
|
|
15
|
+
alias, executable_path, fingerprint_path, storage_state_path, user_data_dir,
|
|
16
16
|
description, proxy_server, proxy_username, proxy_password, proxy_bypass
|
|
17
|
-
) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
17
|
+
) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
18
18
|
`);
|
|
19
|
-
stmt.run(profile.alias, profile.executable_path, profile.fingerprint_path || null, profile.storage_state_path || null, profile.description || null, profile.proxy_server || null, profile.proxy_username || null, profile.proxy_password || null, profile.proxy_bypass || null);
|
|
19
|
+
stmt.run(profile.alias, profile.executable_path, profile.fingerprint_path || null, profile.storage_state_path || null, profile.user_data_dir || null, profile.storage_state_path || null, profile.description || null, profile.proxy_server || null, profile.proxy_username || null, profile.proxy_password || null, profile.proxy_bypass || null);
|
|
20
20
|
}
|
|
21
21
|
update(alias, updates) {
|
|
22
22
|
const fields = [];
|
|
@@ -38,5 +38,8 @@ export class ProfileRepository {
|
|
|
38
38
|
updateLastUsed(alias) {
|
|
39
39
|
db.prepare("UPDATE browser_profiles SET last_used = datetime('now') WHERE alias = ?").run(alias);
|
|
40
40
|
}
|
|
41
|
+
updateUserDataDir(alias, userDataDir) {
|
|
42
|
+
db.prepare('UPDATE browser_profiles SET user_data_dir = ? WHERE alias = ?').run(userDataDir, alias);
|
|
43
|
+
}
|
|
41
44
|
}
|
|
42
45
|
//# sourceMappingURL=profile.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/db/repositories/profile.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/db/repositories/profile.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAiBpC,MAAM,OAAO,iBAAiB;IAC5B,MAAM;QACJ,OAAO,EAAE,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,GAAG,EAAsB,CAAC;IAChF,CAAC;IAED,UAAU,CAAC,KAAa;QACtB,OAAO,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,KAAK,CAA+B,CAAC;IAC/G,CAAC;IAED,MAAM,CAAC,OAAyD;QAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;KAKvB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CACN,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAChC,OAAO,CAAC,kBAAkB,IAAI,IAAI,EAClC,OAAO,CAAC,aAAa,IAAI,IAAI,EAC7B,OAAO,CAAC,kBAAkB,IAAI,IAAI,EAClC,OAAO,CAAC,WAAW,IAAI,IAAI,EAC3B,OAAO,CAAC,YAAY,IAAI,IAAI,EAC5B,OAAO,CAAC,cAAc,IAAI,IAAI,EAC9B,OAAO,CAAC,cAAc,IAAI,IAAI,EAC9B,OAAO,CAAC,YAAY,IAAI,IAAI,CAC7B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAAgC;QACpD,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC;QAElB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEhC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,EAAE,CAAC,OAAO,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,KAAa;QAC1B,EAAE,CAAC,OAAO,CAAC,yEAAyE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;IAED,iBAAiB,CAAC,KAAa,EAAE,WAAmB;QAClD,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACtG,CAAC;CACF"}
|
|
@@ -8,6 +8,8 @@ import { AccountRepository } from '../db/repositories/account.js';
|
|
|
8
8
|
import fs from 'fs/promises';
|
|
9
9
|
import path from 'path';
|
|
10
10
|
import os from 'os';
|
|
11
|
+
// 用户数据目录，与数据库在同一位置
|
|
12
|
+
const USER_DATA_BASE_DIR = path.join(os.homedir(), '.botbrowser-mcp', 'user-data');
|
|
11
13
|
export class PlaywrightManager {
|
|
12
14
|
instances = new Map();
|
|
13
15
|
profileRepo = new ProfileRepository();
|
|
@@ -21,6 +23,11 @@ export class PlaywrightManager {
|
|
|
21
23
|
if (!profile) {
|
|
22
24
|
throw new Error(`浏览器配置不存在: ${profileAlias}`);
|
|
23
25
|
}
|
|
26
|
+
// 检查该 profile 是否已有运行中的实例（同一指纹不能多开）
|
|
27
|
+
const existingInstance = Array.from(this.instances.values()).find(inst => inst.profileAlias === profileAlias);
|
|
28
|
+
if (existingInstance) {
|
|
29
|
+
throw new Error(`Profile "${profileAlias}" already has a running instance (ID: ${existingInstance.id}). Cannot launch multiple instances with the same fingerprint.`);
|
|
30
|
+
}
|
|
24
31
|
// 验证账号
|
|
25
32
|
if (accountId) {
|
|
26
33
|
const account = this.accountRepo.getById(accountId);
|
|
@@ -28,10 +35,18 @@ export class PlaywrightManager {
|
|
|
28
35
|
throw new Error(`账号 ${accountId} 不属于配置 ${profileAlias}`);
|
|
29
36
|
}
|
|
30
37
|
}
|
|
31
|
-
//
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
38
|
+
// 使用固定的 userDataDir（每个 profile 一个目录）
|
|
39
|
+
let userDataDir = profile.user_data_dir;
|
|
40
|
+
// 如果数据库中没有 userDataDir，创建并保存
|
|
41
|
+
if (!userDataDir) {
|
|
42
|
+
userDataDir = path.join(USER_DATA_BASE_DIR, profileAlias);
|
|
43
|
+
await fs.mkdir(USER_DATA_BASE_DIR, { recursive: true });
|
|
44
|
+
this.profileRepo.updateUserDataDir(profileAlias, userDataDir);
|
|
45
|
+
}
|
|
46
|
+
else {
|
|
47
|
+
// 确保目录的父目录存在
|
|
48
|
+
await fs.mkdir(path.dirname(userDataDir), { recursive: true });
|
|
49
|
+
}
|
|
35
50
|
// 使用传入的 launchOptions，如果没有则使用默认值
|
|
36
51
|
const options = launchOptions || {};
|
|
37
52
|
// 确保有基本的 args 数组
|
|
@@ -129,13 +144,7 @@ export class PlaywrightManager {
|
|
|
129
144
|
}
|
|
130
145
|
// 关闭浏览器
|
|
131
146
|
await instance.context.close();
|
|
132
|
-
//
|
|
133
|
-
try {
|
|
134
|
-
await fs.rm(instance.userDataDir, { recursive: true, force: true });
|
|
135
|
-
}
|
|
136
|
-
catch (err) {
|
|
137
|
-
console.error(`清理用户数据目录失败: ${instance.userDataDir}`, err);
|
|
138
|
-
}
|
|
147
|
+
// 注意：不再删除 userDataDir，保留以便下次使用
|
|
139
148
|
// 从内存和数据库删除
|
|
140
149
|
this.instances.delete(instanceId);
|
|
141
150
|
this.instanceRepo.delete(instanceId);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/playwright/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAA2B,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/playwright/manager.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/readme.md
CHANGED
|
@@ -2,7 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
多实例浏览器自动化 MCP Server，集成 [@playwright/mcp](https://www.npmjs.com/package/@playwright/mcp) 的 22 个浏览器工具，支持配置管理、账号管理和多实例切换。
|
|
4
4
|
|
|
5
|
-
**版本:** v0.1.
|
|
5
|
+
**版本:** v0.1.9
|
|
6
|
+
**平台:** Windows | Linux | macOS
|
|
7
|
+
|
|
8
|
+
> 📖 查看 [平台兼容性说明](PLATFORM_COMPATIBILITY.md) 了解不同平台的配置差异
|
|
6
9
|
|
|
7
10
|
## 安装
|
|
8
11
|
|
|
@@ -43,8 +46,10 @@ npm install -g botbrowser-mcp
|
|
|
43
46
|
|
|
44
47
|
1. **浏览器配置 (Profile)** - 定义浏览器启动参数
|
|
45
48
|
- Chrome 可执行文件路径
|
|
46
|
-
- Cookie/LocalStorage
|
|
49
|
+
- Cookie/LocalStorage 存储路径（可选）
|
|
50
|
+
- 用户数据目录（自动管理，存储缓存/扩展/设置等）
|
|
47
51
|
- 代理设置
|
|
52
|
+
- **限制：同一 Profile 同时只能启动一个实例**
|
|
48
53
|
|
|
49
54
|
2. **账号 (Account)** - 绑定到配置的用户账号
|
|
50
55
|
- 平台标识（twitter, github 等）
|
|
@@ -54,6 +59,7 @@ npm install -g botbrowser-mcp
|
|
|
54
59
|
- 基于某个配置启动
|
|
55
60
|
- 可选关联某个账号
|
|
56
61
|
- 同时只有一个实例为活跃状态
|
|
62
|
+
- 复用配置的 userDataDir（保留浏览器状态）
|
|
57
63
|
|
|
58
64
|
## 快速开始
|
|
59
65
|
|
|
@@ -63,7 +69,12 @@ npm install -g botbrowser-mcp
|
|
|
63
69
|
# 1. 创建浏览器配置
|
|
64
70
|
create_browser_profile(
|
|
65
71
|
alias: "twitter-bot",
|
|
66
|
-
|
|
72
|
+
# Windows 路径示例
|
|
73
|
+
executable_path: "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
|
|
74
|
+
# Linux 路径示例
|
|
75
|
+
# executable_path: "/usr/bin/google-chrome",
|
|
76
|
+
# macOS 路径示例
|
|
77
|
+
# executable_path: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
|
|
67
78
|
storage_state_path: "/Users/me/.botbrowser/twitter_cookies.json"
|
|
68
79
|
)
|
|
69
80
|
|
|
@@ -251,19 +262,45 @@ metadata: '{"password":"abc123","2fa":"JBSWY3DP","recovery":["c1","c2"]}'
|
|
|
251
262
|
metadata: "密码是 abc123，双因素认证是 JBSWY3DP，备用邮箱 backup@gmail.com"
|
|
252
263
|
```
|
|
253
264
|
|
|
265
|
+
### 用户数据目录管理
|
|
266
|
+
|
|
267
|
+
**自动管理:**
|
|
268
|
+
- 每个 Profile 使用固定的 userDataDir: `~/.botbrowser-mcp/user-data/{profile_alias}/`
|
|
269
|
+
- 首次启动自动创建并存储到数据库
|
|
270
|
+
- 停止实例时**不会删除** userDataDir，下次启动继续使用
|
|
271
|
+
- 保留浏览器缓存、扩展、网站数据、会话等
|
|
272
|
+
|
|
273
|
+
**双重状态保存:**
|
|
274
|
+
1. **userDataDir** - 完整的浏览器状态（缓存、扩展、设置等）
|
|
275
|
+
2. **storage_state_path** (可选) - 仅保存 Cookies 和 LocalStorage
|
|
276
|
+
|
|
277
|
+
**多开限制:**
|
|
278
|
+
- 同一 Profile 不能同时启动多个实例（Playwright 限制）
|
|
279
|
+
- 需要多开请创建多个 Profile（可使用相同的 executable_path）
|
|
280
|
+
|
|
254
281
|
## 数据存储
|
|
255
282
|
|
|
256
|
-
所有数据存储在: `~/.botbrowser-mcp
|
|
283
|
+
所有数据存储在: `~/.botbrowser-mcp/`
|
|
284
|
+
|
|
285
|
+
**目录结构:**
|
|
286
|
+
```
|
|
287
|
+
~/.botbrowser-mcp/
|
|
288
|
+
├── botbrowser.db # SQLite 数据库
|
|
289
|
+
└── user-data/ # 浏览器用户数据目录
|
|
290
|
+
├── twitter-bot/ # Profile: twitter-bot
|
|
291
|
+
├── work-profile/ # Profile: work-profile
|
|
292
|
+
└── personal/ # Profile: personal
|
|
293
|
+
```
|
|
257
294
|
|
|
258
295
|
**数据库表:**
|
|
259
|
-
- `browser_profiles` -
|
|
296
|
+
- `browser_profiles` - 浏览器配置（包含 user_data_dir）
|
|
260
297
|
- `accounts` - 账号信息
|
|
261
298
|
- `browser_instances` - 运行中的实例
|
|
262
299
|
|
|
263
300
|
可使用 SQLite 客户端查看：
|
|
264
301
|
```bash
|
|
265
302
|
sqlite3 ~/.botbrowser-mcp/botbrowser.db
|
|
266
|
-
SELECT
|
|
303
|
+
SELECT alias, user_data_dir FROM browser_profiles;
|
|
267
304
|
```
|
|
268
305
|
|
|
269
306
|
## 常见问题
|
|
@@ -276,11 +313,28 @@ A: 可以！有两种方式：
|
|
|
276
313
|
1. 在每个工具调用时指定 `instance_id` 参数（推荐）
|
|
277
314
|
2. 使用 `switch_browser_instance` 切换活跃实例
|
|
278
315
|
|
|
279
|
-
**Q:
|
|
280
|
-
A:
|
|
316
|
+
**Q: 为什么同一个 Profile 不能多开？**
|
|
317
|
+
A: Playwright 的 `launchPersistentContext` 会锁定 userDataDir，同一目录只能被一个实例使用。如需多开，请创建多个 Profile。
|
|
318
|
+
|
|
319
|
+
**Q: 如何实现多账号同时登录？**
|
|
320
|
+
A: 为每个账号创建独立的 Profile：
|
|
321
|
+
```
|
|
322
|
+
create_browser_profile(alias: "twitter-account1", ...)
|
|
323
|
+
create_browser_profile(alias: "twitter-account2", ...)
|
|
324
|
+
launch_browser(profile_alias: "twitter-account1")
|
|
325
|
+
launch_browser(profile_alias: "twitter-account2")
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
**Q: userDataDir 什么时候清理？**
|
|
329
|
+
A: 不会自动清理。停止实例时保留 userDataDir 以便下次使用。如需清理，手动删除 `~/.botbrowser-mcp/user-data/{profile}/`。
|
|
281
330
|
|
|
282
331
|
**Q: Cookie 什么时候保存？**
|
|
283
|
-
A:
|
|
332
|
+
A:
|
|
333
|
+
- userDataDir 中的数据实时保存
|
|
334
|
+
- storage_state_path（如果配置）在停止实例时保存
|
|
335
|
+
|
|
336
|
+
**Q: 什么时候需要使用 instance_id 参数？**
|
|
337
|
+
A: 当你需要频繁在多个浏览器之间切换操作时，使用 `instance_id` 更方便，避免反复调用 `switch_browser_instance`。
|
|
284
338
|
|
|
285
339
|
**Q: 孤立实例记录是什么？**
|
|
286
340
|
A: 如果程序异常退出，浏览器已关闭但数据库记录还在，使用 `cleanup_orphaned_instances` 清理。
|