> ## Documentation Index
> Fetch the complete documentation index at: https://agent-traffic.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Tell agents, AI crawlers, search crawlers and bots apart from people.

`agent-traffic` classifies HTTP requests. It's a curated, tested dataset of the user agents, headers and official verification sources of real agents and crawlers, plus one small function that applies it.

## Get started with your agent

Install the skill in Claude Code, Cursor, Codex or any coding agent. It teaches your agent how agent-traffic works and how to use it, so you can ask for whatever you need.

Install the agent-traffic skill

Install the agent-traffic skill with `npx skills add mintlify/agent-traffic`.

> [card] [Quickstart](https://agent-traffic.mintlify.site/quickstart.md)
>
> Other ways to install and what the skill covers.

## What it does

```js theme={null}
import { classify } from '@mintlify/agent-traffic'

classify({ userAgent: 'Claude-User (claude-code/2.1.308; +https://support.anthropic.com/)' })
// { category: 'agent', kind: 'coding', name: 'Claude Code', operator: 'Anthropic', version: '2.1.308', ... }
```

## Why it exists

Most bot lists match a user agent substring and return a label. That breaks down for AI traffic in three ways:

* **Claims aren't verified.** Anyone can send `GPTBot` in a user agent. `agent-traffic` checks crawlers against their operators' published IP ranges and flags impersonators.
* **Different kinds of AI traffic get lumped together.** A coding agent reading your docs for a developer, an AI company crawling for training data, and a script mirroring your `llms.txt` are very different things. Each gets its own category.
* **Agents hide behind browser user agents.** Many AI tools send a stock Chrome user agent but still ask for markdown. The classifier looks at headers, not only the user agent.

Every result explains itself with a list of reasons, so you can see why a request landed where it did.

## Start here

> [card] [Quickstart](https://agent-traffic.mintlify.site/quickstart.md)
>
> Have your coding agent add classification to your stack.

> [card] [Install it yourself](https://agent-traffic.mintlify.site/install.md)
>
> Add the package to your code by hand.

> [card] [Categories](https://agent-traffic.mintlify.site/concepts/categories.md)
>
> What `agent`, `ai-crawler`, `crawler`, `bot` and `human` mean.

> [card] [Querying your logs](https://agent-traffic.mintlify.site/guides/querying-logs.md)
>
> Classify traffic you've already stored.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.