webchat
# webchat-agent
Use free web chats (GLM, Qwen, Kimi, DeepSeek, Gemini) as agents: a robot drives a real Chrome, types the
question, attaches files, waits until the answer is finished and hands it back as markdown. Works as an
**MCP server** (Claude Code, any tool-calling model, even a local one), a **CLI** and an **OpenAI-compatible API**.
Робот, который превращает бесплатные веб-чаты нейросетей в агентов. Он сам открывает чат в настоящем Chrome,
выбирает самую сильную модель и максимальный уровень размышлений, пишет вопрос, прикладывает картинки и файлы,
ловит конец ответа и возвращает его текстом. Разговор можно продолжать (ссылка на чат сохраняется) или начать
новый чат. Ключей API нет: работает через ваш вход на сайте или гостем, если сайт это позволяет.
## Что умеет
- **Модель и размышления.** Под каждый сайт есть шаги, которые выбирают лучшую доступную модель и максимальный
режим размышлений (GLM: GLM-5.3 и Effort Max, Qwen: Qwen4-Max и «Мышление», Kimi: K3.1 Pro и «极致», DeepSeek: «Глубокое мышление»).
Модели, закрытые для вашего аккаунта, пропускаются. Можно назвать модель явно: `--model GLM-5.2`.
- **Файлы и картинки** уходят через загрузку на сайте. Сообщение длиннее 30 000 символов отправляется файлом `message.md`.
- **Конец ответа.** Пропала кнопка «стоп», и текст не менялся 3 секунды.
- **Ответ в markdown.** Его берёт кнопка «копировать» самого сайта, а если её нет, HTML конвертируется в markdown.
- **Ветки.** `thread` хранит ссылку на чат, следующий вопрос уходит в тот же разговор. `new_chat` начинает заново.
- **Совет.** Один вопрос нескольким чатам параллельно, каждый в своей вкладке.
- **Честные остановки.** Если сайт просит войти или показывает окно возраста, робот сразу возвращает ошибку
`login` со скриншотом. На капче робот выводит вкладку вперёд и ждёт до 4 минут (`captcha_wait` в config.json),
пока её решит человек в окне робота; не решили — ошибка `captcha` со скриншотом. Капчи робот **никогда** не решает сам.
## Состояние сайтов
| Сайт | Без входа | Проверено |
|---|---|---|
| GLM, chat.z.ai | только текст и модель Flash; файлы просят войти; после нескольких вопросов бывает капча | 2026-11-13 |
| Qwen, chat.qwen.ai | один раз спросит год рождения (ответьте сами); дальше текст гостем с Qwen4-Max и «Мышлением»; всплывающее «войдите» робот закрывает; файлы только после входа. У гостя адрес чата общий (`/c/guest`), поэтому ветка живёт, пока открыта вкладка робота | 2026-11-13 |
| Kimi, kimi.com | отправка требует входа | меню проверено; ответ ещё нет |
| DeepSeek | только со входом; дальше «Глубокое мышление», файлы, ветки | 2026-11-13 |
| Gemini | только со входом; через некоторые прокси Google показывает проверку | селекторы по известной вёрстке, не проверены |
Вёрстка сайтов меняется. Все селекторы лежат в [`webchat/sites.json`](webchat/sites.json), и чинится всё
правкой JSON, без кода. Локальная правка без форка: блок `sites` в `config.json` (см. ниже).
## Установка
Нужны Python 3.11+ и установленный Google Chrome (Playwright скачивать браузер не будет, используется ваш Chrome).
```bash
git clone https://github.com/zhoratolk/webchat-agent && cd webchat-agent
python -m venv .venv && .venv/bin/pip install -e . # Windows: .venv\Scripts\pip install -e .
```
`config.json` в корне (необязательно):
```json
{
"profile": "C:/webchat/chrome-profile",
"cdp_port": 9341,
"proxy": "socks5://127.0.0.1:10808",
"headless": false,
"sites": {"glm": {"stop": "button[aria-label='Stop']"}}
}
```
Робот запускает **отдельный** Chrome со своим профилем (ваш обычный браузер не трогается) и оставляет окно
открытым. Один раз войдите в нужные сайты в этом окне: `webchat open deepseek`. Вход запоминается в профиле.
## Использование
```bash
webchat ask glm "Разбери таблицу" --file data.csv --thread review
webchat ask glm "А теперь по неделям" --thread review # тот же разговор
webchat ask glm "Новая тема" --thread review --new # новый чат
webchat council "Вопрос" --sites glm,qwen,kimi
webchat ask deepseek,qwen,glm "Вопрос" # первый ответивший; сайт на лимите или капче пропускается
webchat status kimi # готов ли сайт + скриншот
webchat usage --days 7 # расход по сайтам
webchat threads | webchat history review
```
MCP (Claude Code и любые агенты с инструментами):
```bash
claude mcp add --scope user webchat -- /path/to/.venv/bin/webchat-mcp
```
Инструменты: `ask`, `council`, `usage`, `site_status`, `list_sites`, `list_threads`, `thread_history`.
У `ask` и `council` есть `message_file` (текст вопроса из файла) и `max_chars` (длинный ответ целиком сохраняется
в `answers/`, агенту приходит начало и путь к файлу).
OpenAI-совместимый API (только на 127.0.0.1, без авторизации, наружу не открывать):
```bash
webchat-api --port 8765
curl http://127.0.0.1:8765/v1/chat/completions -d '{"model":"glm","messages":[{"role":"user","content":"привет"}]}'
```
Без `thread` вся история складывается в один запрос в новом чате. С `"thread": "имя"` (или полем `user`)
отправляется только последнее сообщение в живой разговор.
## Расход и экономия
**Лимиты сайтов.** Бесплатные квоты сайты не публикуют и меняют. Робот пишет каждый запрос в `usage.jsonl`
(сайт, размер вопроса и ответа, секунды, «ок» или вид ошибки), а `webchat usage` (или инструмент `usage`) показывает
по каждому сайту, сколько запросов он принял до первой капчи или лимита. Это и есть его практическая квота у вас.
Что замечено: GLM гостем даёт капчу после ~3 вопросов подряд; DeepSeek и Qwen за десятки вопросов в день не упирались.
**Как тратить меньше лимитов сайтов:**
- Список сайтов вместо одного (`deepseek,qwen,glm`): нагрузка уходит на следующий, когда первый упёрся.
- `council` стоит по запросу на каждый сайт: только для решений, где нужно несколько мнений.
- Одна ветка на тему вместо нового чата на каждый вопрос: контекст уже в чате, его не надо пересылать.
- Вход в аккаунт поднимает квоты почти везде (у гостя они самые маленькие).
**Как тратить меньше токенов вызывающего агента** (всё, что вернул инструмент, оседает в его контексте и
перечитывается каждый ход):
- Длинный контекст класть в файл и передавать `files` или `message_file`, а не писать в `message`:
текст, который агент пишет сам, стоит ему как выход модели, самый дорогой вид токенов.
- `max_chars` (по умолчанию 6000 у `ask`, 3000 у `council`): длинный ответ целиком лежит в файле, агент читает
только нужный кусок.
- Просить у чата формат ответа («таблица», «только код», «до 10 строк»): ответ короче, контекст меньше.
- Размышления сайта в ответ не попадают, их робот вырезает.
## Добавить сайт
Новая запись в `sites.json`:
- `home`: адрес нового чата;
- `input`: поле ввода;
- `send`: CSS-селектор кнопки или `enter`;
- `stop`: кнопка остановки, видна во время ответа;
- `message`: сообщение ассистента;
- `answer`: текст ответа внутри сообщения;
- `thinking`: блок размышлений, он вырезается;
- `copy`: кнопка «копировать»;
- `file_input`: поле загрузки файлов;
- `login_wall`: признаки стены входа;
- `dismiss`: крестики всплывающих окон-напоминаний, которые робот может закрыть (только закрыть: не входить,
не принимать условия, не отвечать на вопросы);
- `model_steps`: шаги выбора модели и уровня размышлений.
Шаги `model_steps`:
- `{"click": css}`: нажать;
- `{"pick": [css, …]}`: нажать первый доступный вариант;
- `{"key": "End", "on": css}`: клавиша на элементе (например, ползунок усилия);
- `{"wait": s}`: пауза.
Любой шаг может быть `"optional": true`.
## Тесты
```bash
pip install -e ".[dev]" && pytest
```
Тесты гоняют движок в headless Chrome на фейковой странице чата (`tests/fake_chat.html`). Сеть не нужна.
## Ограничения и честность
- Автоматизация веб-интерфейса может нарушать правила сайтов. Используйте свои аккаунты на свой риск;
лучше отдельные аккаунты, а не основные.
- У гостей и бесплатных аккаунтов есть лимиты. Робот их **не обходит**: не чистит куки, не меняет личности,
не решает капчи. Упёрлись в лимит, значит берите другой сайт (`council`) или подождите.
- Ответ быстрее не станет: 10 секунд – несколько минут на вопрос, как в самом чате.
## License
MIT
TDQS
Scored across 7 tools
The three groups are clear: querying (ask, council), conversation management (list_threads, thread_history), and introspection (usage, site_status, list_sites). The only real pair that could be confused is ask vs council, but the descriptions explicitly distinguish single-site/race vs parallel multi-site semantics, and site_status vs usage are cleanly separated as live check vs historical stats.
Readable but mixed: list_sites and list_threads use verb_noun, while ask, council, usage and site_status are bare verbs or nouns, and thread_history is noun_noun where list_threads would be the parallel form. No chaos, but no single predictable pattern an agent can pattern-match on.
Seven tools is well-scoped for a webchat orchestration server: two execution tools, three observability tools, and two conversation tools. Each earns its place and nothing is obviously padding.
Core lifecycle is covered: send prompts (ask, council), continue/list/inspect threads, check quota and site health, discover sites. Minor gaps: no tool to delete or rename a saved thread, and no way to enumerate the per-site model menus that ask and council reference, forcing the agent to guess model names.