# Настройка telegram-channel-parser

## Быстрый старт

Скилл работает **без настройки** — парсит любой публичный канал через `--channel`.

Для дайджестов скопируйте `.env.example`:
```bash
cp config/.env.example config/.env
```

Готово — дайджест AI-каналов работает из коробки.

Перед запуском скриптов из установленного скилла сначала создайте рабочую копию:

```bash
bash scripts/prepare_runtime.sh
cd /home/claude/telegram-channel-parser
```

Подготовка также чинит `config/.env` в рабочей копии через `sed -i`: значения с пробелами или кириллицей должны быть в кавычках.

## Категории дайджестов

`.env` содержит **реестр категорий** — агент читает его и знает какие дайджесты доступны.

### Структура

```bash
# Реестр (агент читает этот список)
TG_CATEGORIES=ai,crypto,news
TG_DEFAULT_CATEGORY=ai

# Категория: AI
TG_CHANNELS_AI_LABEL="AI и технологии"
TG_CHANNELS_AI=countwithsasha,evilfreelancer,...

# Категория: Crypto
TG_CHANNELS_CRYPTO_LABEL="Криптовалюты"
TG_CHANNELS_CRYPTO=channel1,channel2
```

### Конвенция именования

Для каждой категории `<ID>`:
- `TG_CHANNELS_<ID>` — список каналов (через запятую, без @)
- `TG_CHANNELS_<ID>_LABEL` — человекочитаемое название категории

### Приоритет каналов

1. `--channels "a,b,c"` — явный параметр (высший приоритет)
2. Категория из `.env` — агент подбирает по контексту
3. Без `.env` — агент спросит какие каналы парсить

## Ограничения

- Только публичные каналы (с включённым t.me/s/ превью)
- Rate limit: 1.5с между запросами
- Пагинация: ~20 постов на страницу