`radar_ai_bots`

Pack: cloudflare-radar · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/radar_ai_bots for the schema, then POST the same URL with its arguments for the data.

Cloudflare Radar AI bots: which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Bytespider, Amazonbot, …) generate how much of AI-bot traffic. Returns percentage shares by user agent, by crawl purpose (training, search, user action) or by industry of the crawled sites, over a date range, globally or for one country. Pass user_agent to get a single crawler’s share; an unknown user agent returns found:false.

Parameters

Name	Type	Required	Description
`dimension`	string	no	user_agent \| crawl_purpose \| industry (default user_agent)
`date_range`	string	no	Lookback window: 1d \| 7d \| 14d \| 28d \| 12w \| 24w \| 52w (default 28d)
`location`	string	no	2-letter country code (e.g., “US”). Omit for global.
`user_agent`	string	no	Only with dimension=user_agent: look up one crawler by name, e.g. “GPTBot”.
`limit`	number	no	Max rows returned, 1-100 (default 25)

Example call

Arguments

{
  "dimension": "user_agent",
  "date_range": "28d"
}

curl

curl -X POST https://gateway.pipeworx.io/cloudflare-radar/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"radar_ai_bots","arguments":{"dimension":"user_agent","date_range":"28d"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('radar_ai_bots', {
  "dimension": "user_agent",
  "date_range": "28d"
});

More examples

{
  "dimension": "crawl_purpose",
  "date_range": "7d",
  "location": "US"
}

Response shape

Field	Type	Description
`found`	boolean
`source`	string
`dimension`	string
`location`	string
`date_range`	string
`range_start`	string \| null
`range_end`	string \| null
`data_as_of`	string \| null
`total_rows`	number
`rows`	array
`user_agent`	string
`share_pct`	number
`rank`	number
`of`	number
`note`	string
`known_user_agents`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "source": {
      "type": "string"
    },
    "dimension": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "date_range": {
      "type": "string"
    },
    "range_start": {
      "type": [
        "string",
        "null"
      ]
    },
    "range_end": {
      "type": [
        "string",
        "null"
      ]
    },
    "data_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "total_rows": {
      "type": "number"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "share_pct": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    },
    "user_agent": {
      "type": "string"
    },
    "share_pct": {
      "type": "number"
    },
    "rank": {
      "type": "number"
    },
    "of": {
      "type": "number"
    },
    "note": {
      "type": "string"
    },
    "known_user_agents": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the cloudflare-radar pack

{
  "mcpServers": {
    "cloudflare-radar": {
      "url": "https://gateway.pipeworx.io/cloudflare-radar/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

radar_ai_bots