Smooth Browser — 流暢瀏覽器

平滑浏览器 Smooth CLI 是一个浏览器，允许 AI 代理与网站交互，进行身份验证，抓取数据，并使用自然语言执行复杂的基于 Web 的任务。

前提条件 假设 Smooth CLI 已经安装。如果没有，可以通过运行以下命令进行安装： pip install smooth-py 假设 API 密钥已经配置。如果遇到身份验证错误，可以通过以下命令配置： smooth config --api-key 要验证配置： smooth config --show 可以在 https://app.smooth.sh 获取 API 密钥。如果账户信用用完，请要求用户在 https://app.smooth.sh 升级计划。

基本工作流程

• 创建配置文件（可选）

配置文件用于在会话之间持久化 cookie、登录会话和浏览器状态。 smooth create-profile --profile-id "my-profile" 列出现有配置文件： smooth list-profiles

• 启动浏览器会话

smooth start-session --profile-id "my-profile" --url "https://example.com" 选项： --profile-id - 使用特定配置文件（可选，未提供则创建匿名会话） --url - 初始导航 URL（可选） --files - 逗号分隔的文件 ID，使其在会话中可用（可选） --device mobile|desktop - 设备类型（默认：mobile） --profile-read-only - 加载配置文件而不保存更改 --allowed-urls - 逗号分隔的 URL 模式，限制访问某些 URL（例如 "https://example.com/,https://api.example.com/"） --no-proxy - 禁用默认代理（见下面的注意事项） 重要：保存会话 ID 以便稍后使用。

代理行为： 默认情况下，CLI 会为浏览器会话自动配置内置代理。如果网站阻止代理或需要直接连接，可以使用 --no-proxy 禁用它。

• 在会话中运行任务

使用自然语言执行任务： smooth run -- "进入 LocalLLM subreddit 并找到前 3 个帖子" 结构化输出（适用于需要交互的任务）： smooth run -- "搜索 '无线耳机'，筛选 4+ 星级，按价格排序，并提取前 3 个结果" \ --url "https://shop.example.com" \ --response-model '{"type":"array","items":{"type":"object","properties":{"product":{"type":"string","description":"产品名称。"},"sentiment":{"type":"string","enum":["positive","negative","neutral"],"description":"产品情绪。"}},"required":["product","sentiment"]}}' 元数据（代理将）： smooth run -- "填写表单中的用户信息" \ --metadata '{"email":"user@example.com","name":"John Doe"}' 选项： --url - 在运行任务之前导航到此 URL --metadata - 任务变量的 JSON 对象 --response-model - 结构化输出的 JSON 模式 --max-steps - 代理最大步数（默认：32） --json - 以 JSON 格式输出结果

注意： 必须以适当的抽象级别给出任务。不能太具体 - 例如单步操作 - 也不能太广泛或模糊。 好的任务： "在 LinkedIn 上搜索在 Amazon 工作的 SDE，并返回 5 个个人资料 URL" "在 Amazon 上找到 iPhone 17 的价格" 坏任务： "点击搜索" -> 太具体！ "加载 google.com，写入 '附近的餐厅'，点击搜索，等待页面加载，提取前 5 个结果，并返回它们。" -> 太具体！你可以说 "在 google 上搜索附近的餐厅并返回前 5 个结果" "找到适合我们公司的软件工程师" -> 太广泛！你需要计划如何实现目标并运行定义明确的任务来实现该目标。 重要：Smooth 由智能代理提供支持，请不要过度控制它，而是给出明确的目标导向任务，而不是步骤。

• 关闭会话

必须在完成后关闭会话。 smooth close-session -- 重要：关闭后等待 5 秒，以确保 cookie 和状态保存到配置文件中，以便稍后使用。

常见用例 身份验证和持久会话 为特定网站创建配置文件： # 创建配置文件 smooth create-profile --profile-id "github-account" # 启动会话 smooth start-session --profile-id "github-account" --url "https://github.com/login" # 获取实时视图以手动身份验证 smooth live-view -- # 将 URL 提供给用户以便在浏览器中打开并登录 # 当用户确认登录后，可以关闭会话以保存配置文件数据 smooth close-session -- # 将配置文件 ID 保存在某个地方以便稍后重用

重用已身份验证的配置文件： # 下次，只需使用相同的配置文件启动会话 smooth start-session --profile-id "github-account" smooth run -- "在我的仓库 'my-project' 中创建一个新问题" 保持配置文件有序： 保存哪些配置文件用于哪些服务的身份验证，以便在未来高效地重用它们。