# 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.
