Skip to main content
Glama
README.md
# 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

B3.2/5.0

Scored across 7 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues