OpenWeb_开发编程 skill-PHP中文网

OpenWeb

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过类型化的 JSON 接口访问 90+ 真实网站，包括 Google、Amazon、Reddit、YouTube、GitHub、Instagram、Bloomberg、Zillow 等，覆盖搜索、购物、旅行等场景。

OpenWeb

功能概述

OpenWeb是一项面向实际任务的技能，主要用于Agent- 本地方式访问任何网站..；Bridging agent CLI 和 web GUI 通过 API.；

核心要点

Load June. 不要读取此文件夹中的每个文件. .；
Start with SKILL. md.。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

OpenWeb

面向 Agent 的网站访问方式。通过 API 桥接 Agent CLI 与 Web GUI。

加载规范

不要读取该目录下的所有文件。
从 SKILL.md 入手，每次仅沿一条路径推进。

使用已有站点

1. 查找站点

openweb sites                        # 列出所有可用站点

若该站点尚无对应包，切勿声明“不支持”，应转至 add-site/guide.md。

2. 检查就绪状态

openweb                        # 传输层、认证方式、操作列表

Requires browser: yes — 需要时自动启动浏览器；无需手动配置
Requires login: yes — 用户需通过其浏览器会话完成登录

3. 阅读站点说明文档

若工作区中存在站点文档，请优先查阅：

源码仓库：先阅读 src/sites//SKILL.md（了解工作流与意图映射），再阅读 src/sites//DOC.md（了解内部实现）。
已发布/运行时包：仅 DOC.md、规格说明（specs）、清单（manifest）、示例（examples）及适配器（adapters）被保证包含在内。各站点专属的 SKILL.md 和 PROGRESS.md 属于源码树文档，不会被发布至 $OPENWEB_HOME/sites// 目录下。

若仅有已发布的包可用，则依赖 openweb 、openweb 、示例及 DOC.md 进行操作。

4. 检查操作详情

openweb                    # 参数定义、响应结构、权限等级
openweb   --example        # 来自 fixtures 的真实参数示例

执行前请确认该操作的权限等级：

等级	默认行为	说明
`read`	allow	类 GET 操作 — 可自由执行
`write`	prompt	创建/更新类操作 — 执行前须向用户确认
`delete`	prompt	破坏性操作 — 执行前须向用户确认
`transact`	deny	涉及资金或不可逆操作 — 始终跳过

5. 执行操作

openweb   '{"key":"value"}'    # stdout 输出 JSON，stderr 输出 JSON 格式错误信息

自动溢出（Auto-spill）：响应体超过 4096 字节时，将写入临时文件。

openweb exec '{...}' 等价于上述命令 — 当第三个参数为 JSON 时，可省略 exec。

6. 执行失败处理

stderr 中的错误信息包含 failureClass 字段：

failureClass	应对措施
`needs_browser`	浏览器将自动启动；若失败，请检查 Chrome 安装状态。备用方案：`openweb browser start`
`needs_login`	执行 `openweb login` ，然后执行 `openweb browser restart`
`needs_page`	在浏览器中新开一个标签页并访问该站点 URL
`bot_blocked`	执行 `openweb browser restart --no-headless`，用户在可见浏览器中完成 CAPTCHA 验证后重试。对于长期使用的站点，可在配置中设置 `"browser": {"headless": false}`
`permission_denied`	更新 `$OPENWEB_HOME/config.json` 中的 `permissions` 配置项
`permission_required`	向用户请求确认，然后重试
`retriable`	等待数秒后重试（最多重试 2 次）
`fatal`	不可重试 — 请修正参数或核对站点名称

若上表未覆盖当前问题，请查阅 references/troubleshooting.md。

7. 站点缺失或功能覆盖不足

站点不存在，或缺少所需操作？请阅读 add-site/guide.md。

添加 / 扩展 / 升级站点

请阅读 add-site/guide.md

修复问题

请阅读 references/troubleshooting.md

文件映射

所有路径均相对于 skills/openweb/。

add-site/（工作流 — 按顺序加载）

文件	加载时机
`add-site/guide.md`	添加/扩展工作流的入口文档
`add-site/probe.md`	探测阶段：基于 CDP 的浏览器端发现
`add-site/capture.md`	捕获阶段：录制浏览器网络流量
`add-site/review.md`	审核阶段：解析 analysis-summary.json
`add-site/curate-operations.md`	整理阶段：命名、去噪、参数设计、权限设定
`add-site/curate-runtime.md`	整理阶段：认证、传输、数据提取逻辑
`add-site/curate-schemas.md`	整理阶段：响应 Schema、示例、PII 处理
`add-site/verify.md`	验证阶段：运行时 + 规格说明 + 文档闭环验证
`add-site/document.md`	文档阶段：生成各站点专属的 SKILL.md、DOC.md、PROGRESS.md，并同步知识库更新

references/（查阅用 — 可独立加载）

文件	加载时机
`references/cli.md`	CLI 命令语法、标志位（flags）、stdout/stderr 行为
`references/x-openweb.md`	x-openweb 字段完整 Schema 定义
`references/troubleshooting.md`	系统异常 — 分类、诊断与修复指南

knowledge/（模式库 — 在关键决策点加载）

文件	加载时机
`knowledge/archetypes.md`	按站点类别预设的典型操作集合
`knowledge/auth-routing.md`	认证类型未知时 — 通过信号查找所属认证族
`knowledge/auth-primitives.md`	认证配置方法 — 配置项说明与常见陷阱
`knowledge/bot-detection.md`	传输层/捕获策略决策依据
`knowledge/extraction.md`	数据提取信号 — SSR/DOM 模式识别
`knowledge/graphql.md`	GraphQL 相关 — 持久化查询、批量请求
`knowledge/ws.md`	WebSocket 相关 — 消息/连接模式识别
`knowledge/adapter-recipes.md`	适配器开发模式、代码模板与易错点
`knowledge/transport-upgrade.md`	传输层升级决策、Node 可行性评估、API 探测策略