Metadata-Version: 2.5
Name: ai-bot-log-analyzer
Version: 0.1.0
Summary: Privacy-safe analysis of AI bot and automated traffic in web access logs.
Requires-Python: >=3.12
Requires-Dist: pydantic<3,>=2.12
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: typer<1,>=0.16
Description-Content-Type: text/markdown

# agentlog

Analyze nginx, Caddy, and mapped JSONL access logs locally. `agentlog` separates
AI crawlers, AI-user fetches, search crawlers, likely scripts, scanners, and
browser-like traffic without uploading logs or using an LLM.

```bash
agentlog analyze access.log
agentlog analyze access.jsonl --format caddy
agentlog analyze custom.jsonl --format jsonl --mapping mapping.yaml
```

Raw IP addresses, per-run salts, raw log lines, and synthetic session keys are
never written to reports.

By default, the command prints a terminal summary and writes `report.json`,
`report.md`, and `routes.csv` under `agentlog-report/`. Use `--json`,
`--markdown`, or `--csv` to select individual file outputs.

Supported in v0.1:

- nginx common and combined logs
- Caddy JSON access logs
- generic JSONL with a dot-path field mapping

The analyzer uses streaming parsing and bounded session/route state. It does
not inspect request bodies, make network calls, or claim that behavioral
traffic represents verified people or autonomous agents.
