update-browser
Modify browser profile settings in AdsPower, including domain, cookies, proxy configuration, fingerprint parameters, and group assignments.
Instructions
Update the browser
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domainName | No | The domain name of the browser, eg: facebook.com | |
| openUrls | No | The open urls of the browser, eg: ["https://www.google.com"] | |
| cookie | No | The cookie of the browser, eg: "[{"domain":".baidu.com","expirationDate":"","name":"","path":"/","sameSite":"unspecified","secure":true,"value":"","id":1}]" | |
| username | No | The username of the browser, eg: "user" | |
| password | No | The password of the browser, eg: "password" | |
| groupId | No | The group id of the browser, must be a numeric string (e.g., "123"). You can use the get-group-list tool to get the group list or create a new group | |
| name | No | The name of the browser, eg: "My Browser" | |
| country | No | The country of the browser, eg: "CN" | |
| sysAppCateId | No | The sys app cate id of the browser, you can use the get-application-list tool to get the application list | |
| userProxyConfig | No | The user proxy config of the browser | |
| fingerprintConfig | No | The fingerprint config of the browser, default is automatic_timezone: 0, timezone: "", language: [], flash: "", fonts: [], webrtc: disabled, browser_kernel_config: ua_auto, random_ua: ua_version: [], ua_system_version: [], tls_switch: 0, tls: "" | |
| storageStrategy | No | The storage strategy of the browser, default is 0 | |
| userId | Yes | The user id of the browser to update, it is required when you want to update the browser |
Implementation Reference
- src/handlers/browser.ts:66-78 (handler)The core handler function that implements the logic for updating a browser by sending a POST request to the backend API endpoint with the provided parameters, handling success and error responses.
async updateBrowser(params: UpdateBrowserParams) { const requestBody = buildRequestBody({ ...params }); requestBody.user_id = params.userId; const response = await axios.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_BROWSER}`, requestBody); if (response.data.code === 0) { return `Browser updated successfully with: ${Object.entries(response.data.data).map(([key, value]) => `${key}: ${value}`).join('\n')}`; } throw new Error(`Failed to update browser: ${response.data.msg}`); }, - src/utils/toolRegister.ts:20-21 (registration)Registration of the 'update-browser' tool in the MCP server, specifying name, description, input schema, and the wrapped handler function.
server.tool('update-browser', 'Update the browser', schemas.updateBrowserSchema.shape, wrapHandler(browserHandlers.updateBrowser)); - src/types/schemas.ts:83-97 (schema)Zod schema defining the input parameters for the 'update-browser' tool, including optional fields like domainName, openUrls, cookie, etc., and required userId.
updateBrowserSchema: z.object({ domainName: z.string().optional().describe('The domain name of the browser, eg: facebook.com'), openUrls: z.array(z.string()).optional().describe('The open urls of the browser, eg: ["https://www.google.com"]'), cookie: z.string().optional().describe('The cookie of the browser, eg: "[{\"domain\":\".baidu.com\",\"expirationDate\":\"\",\"name\":\"\",\"path\":\"/\",\"sameSite\":\"unspecified\",\"secure\":true,\"value\":\"\",\"id\":1}]"'), username: z.string().optional().describe('The username of the browser, eg: "user"'), password: z.string().optional().describe('The password of the browser, eg: "password"'), groupId: z.string().optional().describe('The group id of the browser, must be a numeric string (e.g., "123"). You can use the get-group-list tool to get the group list or create a new group'), name: z.string().optional().describe('The name of the browser, eg: "My Browser"'), country: z.string().optional().describe('The country of the browser, eg: "CN"'), sysAppCateId: z.string().optional().describe('The sys app cate id of the browser, you can use the get-application-list tool to get the application list'), userProxyConfig: userProxyConfigSchema.optional(), fingerprintConfig: fingerprintConfigSchema.optional(), storageStrategy: z.number().optional().describe('The storage strategy of the browser, default is 0'), userId: z.string().describe('The user id of the browser to update, it is required when you want to update the browser') }),