# Agent Preflight URL Intelligence

> Agent Preflight URL Intelligence is a paid API for AI agents from agent-preflight-mainnet.vectorbuildhq.workers.dev, paid per call via x402, $0.75/call, status unknown (last checked 2026-09-14).

Analyzes a URL for reachability, redirects, page type, login/CAPTCHA signals, product data, API/PDF clues, robots guidance, risk flags, and recommended automation method.

## Facts

- Endpoint: GET https://agent-preflight-mainnet.vectorbuildhq.workers.dev/v1/preflight
- Price: $0.75/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-preflight-url-intelligence-f2b6db52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wOqOxLZ660NFhhY5FXk-q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-preflight-url-intelligence-f2b6db52
```

Example prompt: Before I try to automate anything on https://www.example.com/products/widget-123, can you run a preflight check on it with a 'purchase' intent — tell me if it's reachable, whether it needs a login or has a CAPTCHA, what type of page it is, and what the recommended automation approach is?

## When to prefer this

Use this endpoint when an AI agent needs to assess a URL before committing to automation or scraping — especially when you need to know upfront whether a page requires login, has CAPTCHA protection, is the right page type, or is safe to automate. Prefer this over generic HTTP checks when you need rich classification signals like page type, price detection, structured data availability, and a recommended automation strategy all in one call.

## Known failure modes

- URL is unreachable — reachable: false returned with no further analysis
- Invalid or non-HTTP/HTTPS URL — input validation error
- Target page returns non-200 status — status field reflects actual code
- Payment not processed — x402 payment required response
- Timeout reaching target URL — latency exceeds threshold, reachable may be false
- Robots.txt blocks inspection — risk flag included in response

## How this service works

Full URL intelligence: reachability, redirects, page type, login and CAPTCHA signals, product data, API and PDF clues, robots guidance, risks, evidence, and recommended automation method.

## Output

Returns a structured report including: request ID, final URL after redirects, redirect chain, HTTP status, content type, page type classification (product/login/booking/pdf/api_docs/article/data/generic), reachability boolean, login requirement flag, bot challenge detection flag, structured data availability, detected price and currency, automation difficulty rating, recommended action, risk flags array, confidence score, latency in ms, and supporting evidence items.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "description": "Absolute HTTP or HTTPS URL to inspect."
      },
      "intent": {
       "enum": [
        "research",
        "purchase",
        "scrape",
        "contact",
        "download",
        "apply",
        "book",
        "monitor"
       ],
       "type": "string",
       "default": "research"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "requestId",
      "requestedUrl",
      "intent",
      "reachable",
      "checkedAt"
     ],
     "properties": {
      "intent": {
       "type": "string"
      },
      "status": {
       "type": "integer"
      },
      "evidence": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "finalUrl": {
       "type": "string",
       "format": "uri"
      },
      "pageType": {
       "enum": [
        "product",
        "login",
        "booking",
        "pdf",
        "api_docs",
        "article",
        "data",
        "generic"
       ],
       "type": "string"
      },
      "checkedAt": {
       "type": "string",
       "format": "date-time"
      },
      "latencyMs": {
       "type": "integer"
      },
      "reachable": {
       "type": "boolean"
      },
      "requestId": {
       "type": "string"
      },
      "riskFlags": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "confidence": {
       "type": "number"
      },
      "contentType": {
       "type": "string"
      },
      "availability": {
       "type": [
        "string",
        "null"
       ]
      },
      "requestedUrl": {
       "type": "string",
       "format": "uri"
      },
      "priceCurrency": {
       "type": [
        "string",
        "null"
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-preflight-url-intelligence-f2b6db52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-preflight-mainnet.vectorbuildhq.workers.dev](https://www.zero.xyz/host/agent-preflight-mainnet.vectorbuildhq.workers.dev/llms.txt)