浏览网站

使用 OpenObj 访问任意网站的内容。系统会自动爬取网页，将其转换为 Markdown 格式，并挂载为一个虚拟文件系统，您可使用标准 Unix 命令进行探索。

网络访问

本技能中的所有命令均需访问 openobj.com 的网络权限。

所有 SSH 和 curl 命令均需配置 required_permissions: ["full_network"]（因其必须连接至 openobj.com）。

使用方法

首选方式：SSH exec 模式（适用于具备网络访问能力的终端）：

# required_permissions: ["full_network"]
ssh {domain}@openobj.com "{command}"

备用方式：通过 curl 调用 HTTP API（适用于沙箱化环境）：

# required_permissions: ["full_network"]
curl -s -X POST https://openobj.com/exec 
  -H 'Content-Type: application/json' 
  -d '{"site": "{domain}", "command": "{command}"}'

重要提示：若因沙箱限制导致 SSH 失败，请改用 curl HTTP API。两种方式返回结果完全一致。

可用命令

示例

通过 SSH 使用

# required_permissions: ["full_network"]
ssh docs.stripe.com@openobj.com "find /site -type f"
ssh docs.stripe.com@openobj.com "grep -rl 'webhook' /site"
ssh docs.stripe.com@openobj.com "cat /site/docs/webhooks.md"

# 变更追踪
ssh docs.stripe.com@openobj.com "cd /site && git log --oneline"
ssh docs.stripe.com@openobj.com "cd /site && git diff HEAD~1"

# 强制重新爬取并查看变更
ssh docs.stripe.com@openobj.com "openobj rediscover && cd /site && git diff HEAD~1"

通过 HTTP API（curl）使用

# required_permissions: ["full_network"]
# 列出所有页面
curl -s -X POST https://openobj.com/exec 
  -H 'Content-Type: application/json' 
  -d '{"site": "docs.stripe.com", "command": "find /site -type f"}'

# 搜索关键词
curl -s -X POST https://openobj.com/exec 
  -H 'Content-Type: application/json' 
  -d '{"site": "docs.stripe.com", "command": "grep -rl webhook /site"}'

# 读取某页面
curl -s -X POST https://openobj.com/exec 
  -H 'Content-Type: application/json' 
  -d '{"site": "docs.stripe.com", "command": "cat /site/docs/webhooks.md"}'

工作流程

1. 发现 — 运行 find /site -type f 查看所有可用页面
2. 搜索 — 使用 grep -rl '{keyword}' /site 查找相关页面
3. 阅读 — 使用 cat {path} 读取某页面的完整内容
4. 精筛 — 使用 grep -r '{term}' {path} 在特定文件内进一步搜索
5. 变更追踪 — 使用 git log 和 git diff 查看各次爬取之间的差异
6. 重新爬取 — 使用 openobj rediscover 强制执行全新爬取并更新页面

行为说明

• 首次访问某个域名将触发自动爬取（耗时约 10–30 秒）
• 后续访问均使用缓存版本（每 24 小时刷新一次）
• 可在 24 小时窗口期内使用 openobj rediscover 强制执行全新爬取
• 页面会自动从 HTML 转换为 Markdown 格式
• 每个站点最多索引 200 个页面
• 虚拟文件系统结构与网站原始 URL 结构保持一致
• 每次爬取均作为一次 git commit 记录，便于进行变更比对

积分说明

• 爬取 新站点或运行 openobj rediscover 操作，按 每页消耗 1 积分
• 读取 缓存内容（如 cat、grep、find、ls、git 等命令）始终 免费
• 免费账户初始赠送 100 次性积分
• 若收到积分不足错误，请 勿重试，应向用户说明：
  • 查询当前积分：运行 ssh {any-domain}@openobj.com "openobj credits"
  • 升级账户：告知用户在终端中运行 ssh auth@openobj.com
• 为节省积分，建议优先读取已缓存的站点内容，而非重复爬取

响应格式

HTTP API 返回 JSON 格式响应：

{
  "stdout": "...",
  "stderr": "...",
  "exitCode": 0
}

请使用 stdout 字段获取命令输出结果；非零的 exitCode 表示执行出错。