让 AI 编程工具接入穿云 API

从一次网页请求开始,把穿云接入你正在使用的编辑器、命令行或 Agent 工作流。按工具找到操作说明,按任务复用访问经验。

  • 公共 HTTP API:现在即可开始验证
  • MCP:连接工具;Skill:组织任务步骤
  • 代理、会话、状态与错误处理保持可控

仅用于经过授权的网页访问、开发测试与数据工作流。

网页访问 API 与自动化工作流示意

选择适合项目的接入方式

先选择最小可用路径,再逐步增加工具与任务复杂度。

直接调用公共 API

沿用项目的 HTTP 客户端,自己控制请求、会话和结果处理。现在即可验证。

API 文档

使用 Skill 组织任务

让 AI 读取接入规则,再按任务准备参数、检查状态和处理失败。

Cloudbypass Skill

通过 MCP 连接工具

已有 HTTP MCP 须支持自定义请求头与安全凭据注入。官方托管服务仍在规划中。

穿云托管 MCP

访问层负责连接,工作流负责业务

明确职责,让同一套规则可以在不同 AI 工具中复用。

  • 访问层版本、凭据、代理、会话与响应状态。
  • 任务工作流提取、分页、去重、保存与任务截止时间。
  • 站点配方按域名和任务加载规则,记录验证条件与限制。
HTTP API 请求与会话管理示意

先完成一次最小请求

让 AI 读取官方指南,然后在实际运行环境中配置凭据。

从最小请求开始HTTP API
curl --include --request GET \
  "https://api.cloudbypass.com/" \
  --header "x-cb-host: example.com" \
  --header "x-cb-apikey: ${CLOUDBYPASS_APIKEY:?}" \
  --max-time 90

# POSIX shell 示例;密钥先在安全环境中配置。
# 同时检查 x-cb-status、目标状态与实际内容。
# V2 / V2s 按文档添加版本和稳定代理参数。
先在运行环境配置密钥。示例不会在页面中执行。
代理网络与访问路由示意

常见问题

现在应该使用哪种接入方式?

先使用现有公共 HTTP API 完成最小验证。OpenClaw 可使用已发布 Skill;已有 HTTP MCP 工具需要支持请求头与安全凭据注入。官方托管 MCP 仍在规划中。

能否保证所有目标都可以访问?

不能保证。相关能力包括 Cloudflare JavaScript Challenge、Turnstile、DataDome 与 Imperva / Incapsula,仍需按目标和条件验证。本方案不把 reCAPTCHA、hCaptcha 作为当前访问能力宣传,也不替代目标账号权限。

密钥和代理密码应该放在哪里?

保存在实际运行环境或可信服务端的安全配置中。不要放进网页前端、共享仓库、提示词、截图或公开日志。远程服务的环境与本机独立。

MCP 或 Skill 会自动完成分页和提取吗?

不默认承担。访问层负责请求与响应;分页、字段提取、去重、登录态与业务签名由任务工作流或站点配方负责。验证失败时先定位原因,不无限重试。

先验证一次,再开始集成

确认目标兼容性,把正确的访问流程带入项目。