edgeLakeBotScore

Analyze bot traffic for a domain using Cloudflare bot detection scores. Returns request counts grouped by bot score ranges and a time-series chart.

Parameters

Parameter
Type
Required
Description

channelId

string (UUID)

Yes

The Edge Lake channel ID. Must be a channel with providerId: "edgeLake". Get this from the domains tool.

teamId

string (UUID)

Yes

The team ID the domain belongs to.

startDateTime

string

Yes

Start date/time in ISO 8601 format, e.g., 2024-01-01T00:00:00.000Z.

endDateTime

string

Yes

End date/time in ISO 8601 format, e.g., 2024-01-31T23:59:59.999Z.

granularity

enum

No

Time granularity: DAY, HOUR, or MINUTE. Defaults to DAY.

timezone

string

No

IANA timezone, e.g., America/New_York.

Bot score ranges

Cloudflare assigns each request a bot score from 0 to 100:

Score range
Classification

0-10

Almost certainly a bot

11-30

Likely a bot

31-50

Uncertain

51-80

Likely human

81-100

Almost certainly human

Output

Returns:

  • overview - Request counts grouped by bot score ranges

  • chart - Time-series of bot score distribution

Example

"How much bot traffic are we getting?"

The AI assistant will call edgeLakeBotScore and display the distribution of bot vs. human traffic.

Last updated

Was this helpful?