9.7 KiB
9.7 KiB
Chrome MCP Server API 参考 📚
所有可用工具及其参数的完整参考。
📋 目录
📊 浏览器管理
get_windows_and_tabs
列出当前打开的所有浏览器窗口和标签页。
参数：无
响应：
{
"windowCount": 2,
"tabCount": 5,
"windows": [
{
"windowId": 123,
"tabs": [
{
"tabId": 456,
"url": "https://example.com",
"title": "示例页面",
"active": true
}
]
}
]
}
chrome_navigate
导航到指定 URL，可选择控制视口。
参数：
url(字符串，必需)：要导航到的 URLnewWindow(布尔值，可选)：创建新窗口（默认：false）width(数字，可选)：视口宽度（像素，默认：1280）height(数字，可选)：视口高度（像素，默认：720）
示例：
{
"url": "https://example.com",
"newWindow": true,
"width": 1920,
"height": 1080
}
chrome_close_tabs
关闭指定的标签页或窗口。
参数：
tabIds(数组，可选)：要关闭的标签页 ID 数组windowIds(数组，可选)：要关闭的窗口 ID 数组
示例：
{
"tabIds": [123, 456],
"windowIds": [789]
}
chrome_go_back_or_forward
浏览器历史导航。
参数：
direction(字符串，必需)："back" 或 "forward"tabId(数字，可选)：特定标签页 ID（默认：活动标签页）
示例：
{
"direction": "back",
"tabId": 123
}
📸 截图和视觉
chrome_screenshot
使用各种选项进行高级截图。
参数：
name(字符串，可选)：截图文件名selector(字符串，可选)：元素截图的 CSS 选择器width(数字，可选)：宽度（像素，默认：800）height(数字，可选)：高度（像素，默认：600）storeBase64(布尔值，可选)：返回 base64 数据（默认：false）fullPage(布尔值，可选)：捕获整个页面（默认：true）
示例：
{
"selector": ".main-content",
"fullPage": true,
"storeBase64": true,
"width": 1920,
"height": 1080
}
响应：
{
"success": true,
"base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
"dimensions": {
"width": 1920,
"height": 1080
}
}
🌐 网络监控
chrome_network_capture_start
使用 webRequest API 开始捕获网络请求。
参数：
url(字符串，可选)：要导航并捕获的 URLmaxCaptureTime(数字，可选)：最大捕获时间（毫秒，默认：30000）inactivityTimeout(数字，可选)：无活动后停止时间（毫秒，默认：3000）includeStatic(布尔值，可选)：包含静态资源（默认：false）
示例：
{
"url": "https://api.example.com",
"maxCaptureTime": 60000,
"includeStatic": false
}
chrome_network_capture_stop
停止网络捕获并返回收集的数据。
参数：无
响应：
{
"success": true,
"capturedRequests": [
{
"url": "https://api.example.com/data",
"method": "GET",
"status": 200,
"requestHeaders": {...},
"responseHeaders": {...},
"responseTime": 150
}
],
"summary": {
"totalRequests": 15,
"captureTime": 5000
}
}
chrome_network_debugger_start
使用 Chrome Debugger API 开始捕获（包含响应体）。
参数：
url(字符串，可选)：要导航并捕获的 URL
chrome_network_debugger_stop
停止调试器捕获并返回包含响应体的数据。
chrome_network_request
发送自定义 HTTP 请求。
参数：
url(字符串，必需)：请求 URLmethod(字符串，可选)：HTTP 方法（默认："GET"）headers(对象，可选)：请求头body(字符串，可选)：请求体
示例：
{
"url": "https://api.example.com/data",
"method": "POST",
"headers": {
"Content-Type": "application/json"
},
"body": "{\"key\": \"value\"}"
}
🔍 内容分析
search_tabs_content
跨浏览器标签页的 AI 驱动语义搜索。
参数：
query(字符串，必需)：搜索查询
示例：
{
"query": "机器学习教程"
}
响应：
{
"success": true,
"totalTabsSearched": 10,
"matchedTabsCount": 3,
"vectorSearchEnabled": true,
"indexStats": {
"totalDocuments": 150,
"totalTabs": 10,
"semanticEngineReady": true
},
"matchedTabs": [
{
"tabId": 123,
"url": "https://example.com/ml-tutorial",
"title": "机器学习教程",
"semanticScore": 0.85,
"matchedSnippets": ["机器学习简介..."],
"chunkSource": "content"
}
]
}
chrome_get_web_content
从网页提取 HTML 或文本内容。
参数：
format(字符串，可选)："html" 或 "text"（默认："text"）selector(字符串，可选)：特定元素的 CSS 选择器tabId(数字，可选)：特定标签页 ID（默认：活动标签页）
示例：
{
"format": "text",
"selector": ".article-content"
}
chrome_get_interactive_elements
查找页面上可点击和交互的元素。
参数：
tabId(数字，可选)：特定标签页 ID（默认：活动标签页）
响应：
{
"elements": [
{
"selector": "#submit-button",
"type": "button",
"text": "提交",
"visible": true,
"clickable": true
}
]
}
🎯 交互操作
chrome_click_element
使用 CSS 选择器点击元素。
参数：
selector(字符串，必需)：目标元素的 CSS 选择器tabId(数字，可选)：特定标签页 ID（默认：活动标签页）
示例：
{
"selector": "#submit-button"
}
chrome_fill_or_select
填充表单字段或选择选项。
参数：
selector(字符串，必需)：目标元素的 CSS 选择器value(字符串，必需)：要填充或选择的值tabId(数字，可选)：特定标签页 ID（默认：活动标签页）
示例：
{
"selector": "#email-input",
"value": "user@example.com"
}
chrome_keyboard
模拟键盘输入和快捷键。
参数：
keys(字符串，必需)：按键组合（如："Ctrl+C"、"Enter"）selector(字符串，可选)：目标元素选择器delay(数字，可选)：按键间延迟（毫秒，默认：0）
示例：
{
"keys": "Ctrl+A",
"selector": "#text-input",
"delay": 100
}
📚 数据管理
chrome_history
使用过滤器搜索浏览器历史记录。
参数：
text(字符串，可选)：在 URL/标题中搜索文本startTime(字符串，可选)：开始日期（ISO 格式）endTime(字符串，可选)：结束日期（ISO 格式）maxResults(数字，可选)：最大结果数（默认：100）excludeCurrentTabs(布尔值，可选)：排除当前标签页（默认：true）
示例：
{
"text": "github",
"startTime": "2024-01-01",
"maxResults": 50
}
chrome_bookmark_search
按关键词搜索书签。
参数：
query(字符串，可选)：搜索关键词maxResults(数字，可选)：最大结果数（默认：100）folderPath(字符串，可选)：在特定文件夹内搜索
示例：
{
"query": "文档",
"maxResults": 20,
"folderPath": "工作/资源"
}
chrome_bookmark_add
添加支持文件夹的新书签。
参数：
url(字符串，可选)：要收藏的 URL（默认：当前标签页）title(字符串，可选)：书签标题（默认：页面标题）parentId(字符串，可选)：父文件夹 ID 或路径createFolder(布尔值，可选)：如果不存在则创建文件夹（默认：false）
示例：
{
"url": "https://example.com",
"title": "示例网站",
"parentId": "工作/资源",
"createFolder": true
}
chrome_bookmark_delete
按 ID 或 URL 删除书签。
参数：
bookmarkId(字符串，可选)：要删除的书签 IDurl(字符串，可选)：要查找并删除的 URL
示例：
{
"url": "https://example.com"
}
📋 响应格式
所有工具都返回以下格式的响应：
{
"content": [
{
"type": "text",
"text": "包含实际响应数据的 JSON 字符串"
}
],
"isError": false
}
对于错误：
{
"content": [
{
"type": "text",
"text": "描述出错原因的错误消息"
}
],
"isError": true
}
🔧 使用示例
完整工作流示例
// 1. 导航到页面
await callTool('chrome_navigate', {
url: 'https://example.com',
});
// 2. 截图
const screenshot = await callTool('chrome_screenshot', {
fullPage: true,
storeBase64: true,
});
// 3. 开始网络监控
await callTool('chrome_network_capture_start', {
maxCaptureTime: 30000,
});
// 4. 与页面交互
await callTool('chrome_click_element', {
selector: '#load-data-button',
});
// 5. 语义搜索内容
const searchResults = await callTool('search_tabs_content', {
query: '用户数据分析',
});
// 6. 停止网络捕获
const networkData = await callTool('chrome_network_capture_stop');
// 7. 保存书签
await callTool('chrome_bookmark_add', {
title: '数据分析页面',
parentId: '工作/分析',
});
此 API 提供全面的浏览器自动化功能，具有 AI 增强的内容分析和语义搜索特性。