web_navigate

网页自动化 · macOS · Windows

效果: 发送. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

将网页会话导航到某个 URL（如有已保存的登录信息则使用），并返回最终的 URL 和页面标题。若会话不存在则打开它。读取之前请检查 `loaded`：为 false 时页面没有加载，`message` 会说明原因——此时读取会话描述的是一个空白文档，而不是该站点。用 web_read 读取页面。当调用通过云连接器到达时，这台 Mac 或其局域网的地址（localhost、127.0.0.1、192.168.x.x…）会被拒绝并返回 relay_local_address，对所有 web_* 工具均如此；在 Mac 本机上运行的 AI 应用则不受限制。

必填输入

url

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

{
  "properties": {
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

文档示例

web_navigate 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "session": "demo-browser",
  "url": "https://example.com"
}

Windows

用途

将网页会话导航到某个 URL（如有已保存的登录信息则复用），并返回最终的 URL 和页面标题。若会话尚不存在则打开它。之后请用 web_read 读取页面。首次调用返回预览，不会打开任何内容；confirm=true 才会导航。

必填输入

url

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览，并按此平台的契约授权实际操作。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview.",
      "type": "boolean"
    },
    "session": {
      "description": "Session name (a named login profile). Defaults to 'default'.",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for the page to load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https assumed if no scheme).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

文档示例

web_navigate 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "confirm": false,
  "session": "demo-browser",
  "url": "https://example.com"
}