StoreClaw Chrome 插件用于连接 StoreClaw 与您的本地 Chrome 浏览器。连接完成后，StoreClaw 可以在您主动发起的任务中打开网页、读取页面内容，并协助完成依赖真实浏览器环境的操作。
这适用于需要使用当前登录状态、处理动态网页、进入电商后台，或在必要时由您配合完成登录和人机验证的场景。
当前仅支持本地 Chrome 浏览器。云端浏览器以及 Edge、Safari 支持将在后续版本推出。
典型使用场景
- 抓取网页信息：提取竞品页面、产品详情页、搜索结果页或后台报表中的实时内容。
- 辅助完成后台操作：在您的授权和指令下，进入电商后台完成查找、填写、点击等操作。
- 处理动态页面：访问必须在真实浏览器中打开的页面，例如需要登录、动态加载或人机验证的页面。
使用前准备
请先确认您的设备和浏览器满足以下要求：
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 或 Windows |
| 浏览器 | Chrome |
| Chrome 版本 | 建议使用 Chrome 100 或以上版本 |
建议使用最新稳定版 Chrome，以获得更好的兼容性和安全性。
安装插件
第一步：在 StoreClaw 中点击连接
- 登录 StoreClaw。
- 点击左下角头像，进入 设置。
- 在设置页面中，点击 浏览器。
- 在 Chrome 卡片中点击 连接。
- 页面会自动跳转到 Chrome 应用商店中的 StoreClaw 插件页面。
您也可以直接访问以下链接安装插件： StoreClaw - Chrome Web Store
第二步：在 Chrome 应用商店中安装
- 在插件页面点击 添加至 Chrome。
- 当 Chrome 弹出确认窗口时，点击 添加扩展程序。
- 安装完成后，Chrome 工具栏中会出现 StoreClaw 插件图标。
第三步：回到 StoreClaw 完成连接
- 安装完成后，回到 StoreClaw -> 设置 -> 浏览器 页面。
- 刷新当前页面，或等待几秒。
- StoreClaw 会自动检测插件状态并完成配对，无需手动输入额外参数。
备用路径：手动打开 Chrome 应用商店页面
如果您没有从 StoreClaw 页面直接跳转成功，也可以手动访问以下链接安装：
验证连接状态
插件安装前，StoreClaw 的浏览器页面中，Chrome 卡片通常会显示 未检测到浏览器插件 或 连接 按钮。
安装完成后，回到 StoreClaw -> 设置 -> 浏览器 页面并刷新。StoreClaw 会自动检测插件状态并完成配对，无需手动输入额外参数。
您可以通过以下方式确认连接是否成功：
- StoreClaw 浏览器页面：Chrome 一行显示为 已连接。
- Chrome 工具栏：右上角出现 StoreClaw 插件图标。
- 会话测试：在会话中发送一条需要网页操作的指令，StoreClaw 可以调用本地浏览器执行任务。
连接后可以做什么
连接成功后，StoreClaw 可以在您主动发起的任务中调用本地浏览器能力，例如：
- 打开指定网页并提取页面内容
- 进入店铺后台查找订单、产品或报表信息
- 在动态页面中完成点击、滚动、切换标签页等操作
- 使用当前浏览器中的登录状态访问相关页面
- 在需要登录或人机验证时，由您手动完成验证后继续执行任务
常见示例指令：
打开这个竞品详情页，帮我提取标题、价格、评论数和主要卖点登录后进入 Shopify 后台，帮我看看今天有没有新的高风险订单打开 Amazon 搜索结果页，整理前 10 个竞品的价格区间和评论量
权限与安全说明
StoreClaw Chrome 插件仅用于执行您主动发起的浏览器任务。连接成功后，StoreClaw 不会持续访问您的浏览器，也不会在未触发任务的情况下主动操作网页。
在执行浏览器任务时，请注意：
- 插件可能会读取当前任务相关网页的页面内容。
- 如果页面已登录，StoreClaw 可能会基于当前登录状态访问该页面。
- 涉及账号登录、付款、提交表单等敏感操作时，建议您在执行前确认任务内容。
- 如任务过程中出现验证码或人机验证，请由您在本地浏览器中手动完成。
与其他功能的关系
与会话配合
本地浏览器操作通常从会话中发起。您可以直接用自然语言描述目标页面和任务，StoreClaw 会在需要时调用 Chrome 插件执行。
与技能配合
某些技能在执行过程中可能需要访问网页或后台页面。当任务依赖真实浏览器环境时，技能会调用 Browser 能力完成相关步骤。
与定时任务的区别
定时任务默认在云端执行。依赖本地 Chrome 的操作需要您的设备、Chrome 浏览器和插件保持可用，因此不适合作为完全无人值守的云端定时任务直接运行。
常见问题
Q: 安装插件后刷新页面，仍然没有显示“已连接”怎么办？
A: 请按以下顺序检查：
- 确认 Chrome 浏览器仍在运行。
- 打开 Chrome 扩展管理页，确认 StoreClaw 已安装。
- 确认插件开关处于开启状态。
- 回到 StoreClaw -> 设置 -> 浏览器 页面，刷新页面并等待几秒。
- 如果您使用了多个 Chrome 用户配置，请确认插件安装在当前登录 StoreClaw 的同一个 Chrome 用户配置中。
Q: Chrome 提示无法安装扩展程序，怎么办？
A: 请先确认您使用的是 Chrome 浏览器，并且可以正常访问 Chrome 应用商店页面： StoreClaw - Chrome Web Store
如果网络、账号策略或浏览器策略限制了扩展安装，建议稍后重试，或联系本地设备管理员检查 Chrome 扩展安装权限。
Q: 通过 Chrome 应用商店安装后，还需要开启开发者模式吗？
A: 不需要。StoreClaw Chrome 插件现已通过 Chrome 应用商店分发，正常安装时无需开启开发者模式，也无需手动拖拽本地文件夹。
Q: 连接后，StoreClaw 会一直访问我的浏览器吗？
A: 不会。StoreClaw 只会在您主动发送指令，或明确触发的任务需要调用 Browser 能力时，才会操作本地浏览器。
Q: 可以同时使用多个 Chrome 窗口吗？
A: 可以。但为了减少任务执行中断，建议将目标网页所在的窗口保持打开，并避免在任务执行期间关闭 Chrome 或切换到无关页面。
Q: Edge 和 Safari 支持什么时候上线？
A: 当前 Edge 和 Safari 支持仍在规划中。如果页面显示为 Coming Soon，表示相关浏览器支持尚未开放。
注意事项
- 执行任务期间，请不要关闭 Chrome，否则当前浏览器任务可能中断。
- 如果同时打开多个 Chrome 窗口，建议将目标网页所在窗口保持打开，方便观察执行过程。
- 如果页面需要登录、授权或人机验证，请在本地浏览器中手动完成。
- 当前版本仍处于 Beta 阶段。如遇异常行为，可通过 设置 -> 获取帮助 反馈。