目录收录

Cloudflare Trace API

Cloudflare Trace - Get IP Address, User Agent, Country Code, TLS/SSL Version and more. Cloudflare Trace 通过 Cloudflare CDN 节点获取访问者 IP 信息，包括 IP 地址、国家代码、机场代码、用户代理、TLS 版本等。适合 IP 检测和地理位置服务开发。

来源类型: 目录收录
可用方式: 免费可用
认证方式: 无需认证
协议格式: REST
计费摘要: 免费为主
稳定性说明: 以来源方说明为准

面向 Agent

如何调用 Cloudflare Trace API

供 Hermes、OpenClaw、浏览器自动化 Agent 等读取。优先解析 <head> 内 #boyapi-agent-spec JSON。

Hermes OpenClaw Coding Agent Browser Agent

1. 确认调用目标
业务请求发往 https://one.one.one.one/cdn-cgi，不要向 boyapi.com 发送 Cloudflare Trace 业务 API。
2. 构造 HTTP 请求
- 方法：GET
- 路径：/trace
- 鉴权：无需 API Key
3. 最小可执行示例
复制以下 cURL 试调：
```
curl -sS 'https://one.one.one.one/cdn-cgi/trace'
```
4. 解析响应
解析返回的纯文本数据，格式为 key=value，每行一个。包含 ip、loc（国家代码）、colo（机场）、uag（用户代理）、tls（TLS版本）等字段。
5. 环境与限制
CORS：Yes。浏览器联调以实际结果为准。

机器可读规范（JSON）

application/json · #boyapi-agent-spec

{
  "spec_version": "1.0",
  "page_type": "boyapi_api_detail",
  "api": {
    "slug": "cloudflare-trace",
    "name": "Cloudflare Trace"
  },
  "invocation": {
    "method": "GET",
    "base_url": "https://one.one.one.one/cdn-cgi",
    "path": "/trace",
    "full_url_example": "https://one.one.one.one/cdn-cgi/trace"
  }
}

完整字段以 <head> 中 #boyapi-agent-spec 为准。

Agent 注意：boyapi.com 仅提供目录与文档，不提供第三方 API 代理网关。

接入信息

可用方式

目录定位: 免费目录收录（public-apis）
认证要求: 无需认证（auth=No）
HTTPS: 支持（https=Yes）
CORS: Yes — 可在浏览器前端直接调用
接口名称: Cloudflare Trace
典型端点: GET /trace
功能描述: Cloudflare Trace - Get IP Address, User Agent, Country Code, TLS/SSL Version and more
文档链接: https://github.com/fawazahmed0/cloudflare-trace-api

平台支持

目录收录 API，实际请求发往 Cloudflare CDN 节点
CORS 支持 Yes，浏览器可直接调用
多端点可用：one.one.one.one、1.0.0.1、cloudflare-dns.com 等
无需注册，免费使用