# htmlkin.ru — полная документация для LLM

> Сервис публикации HTML-страниц и статических сайтов: загрузи файл или вставь код — получи публичную ссылку вида https://mypage.htmlkin.ru за 10 секунд. Без регистрации и без хостинга. AI-ассистенты (Claude, Cursor и другие MCP-клиенты) публикуют сайты сами — через MCP-сервер https://htmlkin.ru/mcp или REST API.

Короткая карта сайта: https://htmlkin.ru/llms.txt

Ключевые факты:

- Анонимно, без регистрации: 1 сайт до 20 МБ, ссылка действует 24 часа.
- После бесплатной регистрации сайт живёт, пока на него заходят: 30 дней без визитов — архив, ещё 30 дней можно вернуть из кабинета.
- Форматы: одиночный HTML, статический сайт (папка или ZIP; входная страница — index.html в корне, иначе первый HTML-файл в корне).
- Каждый сайт живёт на своём субдомене {имя}.htmlkin.ru с HTTPS; на любом тарифе, включая бесплатный, можно подключить свой домен — одна DNS-запись, SSL выпускается автоматически.
- REST API и MCP-сервер доступны на любом тарифе, включая бесплатный: нужна только регистрация.

## Как это работает

1. Загрузи HTML-файл, папку сайта или ZIP на главной странице (https://htmlkin.ru/) — либо опубликуй через REST API или MCP.
2. Сайт получает уникальный адрес вида https://mypage.htmlkin.ru (свой субдомен можно выбрать).
3. Анонимная ссылка действует 24 часа; после регистрации на бесплатном тарифе сайт живёт, пока на него заходят.

## Тарифы и лимиты

- Без регистрации — 1 сайт на 24 часа, только ручная загрузка через форму на сайте.
- «Бесплатный» (бесплатно): 1 сайт, хранилище 20 МБ, свои домены доступны.
- «Про» (350 ₽/мес при помесячной оплате; при годовой — 3 500 ₽ списанием раз в год, 2 месяца бесплатно): 10 сайтов, хранилище 1 ГБ, свои домены доступны, PIN-защита доступна, генерация QR-кода доступна, 10 форм для сбора заявок без лимита заявок.
- «Бизнес» (990 ₽/мес при помесячной оплате; при годовой — 9 900 ₽ списанием раз в год, 2 месяца бесплатно): Сайты без ограничений, хранилище 5 ГБ, свои домены доступны, PIN-защита доступна, генерация QR-кода доступна, формы для сбора заявок без ограничений.

Подробное сравнение: https://htmlkin.ru/pricing

## REST API

Публикация и обновление статических сайтов и HTML-страниц из кода и AI-пайплайнов. Доступен на любом тарифе, включая бесплатный, по API-ключу.

- Базовый URL: https://htmlkin.ru/api/v1
- OpenAPI 3.1: https://htmlkin.ru/api/v1/openapi.json
- Документация для людей: https://htmlkin.ru/docs/api

Аутентификация: Все запросы требуют API-ключа в заголовке Authorization. Ключ создаётся в личном кабинете на странице «API-ключи» и показывается один раз. Запрос без валидного ключа отклоняется с 401 invalid_api_key. Формат заголовка: `Authorization: Bearer <api_key>`.

Лимиты частоты запросов (на аккаунт, общие для всех его ключей):

- «Бесплатный» — 10 запросов в минуту, до 60 загрузок сайта в час вместе с личным кабинетом, обновление сайта — раз в минуту
- «Про» — 60 запросов в минуту
- «Бизнес» — 120 запросов в минуту

### POST /api/v1/pages — Опубликовать страницу

Загружает HTML-файл или ZIP статического сайта и публикует его на собственном субдомене. Передаётся ровно одно из полей html_file и site_archive. По умолчанию присваивается случайный субдомен; можно задать свой в поле subdomain.

Поля multipart/form-data:
- `html_file` (файл) — Один HTML-файл; сохраняется как index.html. Ровно один источник контента.
- `site_archive` (файл) — ZIP статического сайта: входной страницей станет корневой index.html либо первый HTML-файл в корне архива. Распакованный сайт — до 200 МБ и в пределах свободного места в хранилище.
- `subdomain` (строка) — Желаемый субдомен ({subdomain}.htmlkin.ru), 3–63 символа a-z, 0-9, «-» (не по краям). Если занят — 409.
- `pin` (строка) — 4-значный PIN (0000–9999) для защиты просмотра. На платных тарифах.
- `visibility` (строка) — Кому открыт сайт: public — всем, сайт индексируют поисковики; link — всем, у кого есть ссылка, без индексации; team — участникам команды аккаунта после входа, на тарифе «Бизнес»; private — только владельцу аккаунта после входа. По умолчанию — public.

Примечание: Ровно один источник: html_file или site_archive.

Успешный ответ — HTTP 201:

```json
{
  "id": "abc123",
  "url": "https://mypage.htmlkin.ru",
  "expires_at": null,
  "created_at": "2026-06-14T07:00:00Z",
  "updated_at": "2026-06-14T07:00:00Z",
  "file_count": 1,
  "entry_path": "index.html",
  "visibility": "public"
}
```

Пример запроса:

```bash
curl -X POST https://htmlkin.ru/api/v1/pages \
  -H "Authorization: Bearer $HTMLKIN_API_KEY" \
  -F "html_file=@index.html" \
  -F "subdomain=mypage"
```

Возможные ошибки: `invalid_file`, `invalid_site`, `invalid_archive`, `invalid_path`, `missing_entry_file`, `too_many_files`, `banner_removal`, `invalid_pin`, `invalid_visibility`, `invalid_subdomain`, `invalid_api_key`, `account_banned`, `team_visibility_requires_plan`, `content_blocked`, `dangerous_link`, `page_limit_exceeded`, `subdomain_taken`, `file_too_large`, `storage_limit_exceeded`, `rate_limit_exceeded` — см. таблицу ниже.

### PUT /api/v1/pages/{id} — Обновить страницу

Полностью заменяет сайт новым HTML или ZIP по тому же адресу и/или меняет PIN и видимость. URL страницы не меняется. Источник — не более одного из полей html_file и site_archive; можно передать только pin и/или visibility, если нужно лишь изменить защиту или видимость.

Поля multipart/form-data:
- `html_file` (файл) — Новый HTML-файл (опционально; не вместе с site_archive).
- `site_archive` (файл) — Новый полный ZIP сайта; все прежние файлы будут заменены.
- `pin` (строка) — 4 цифры — установить/сменить PIN; пустая строка — снять PIN.
- `visibility` (строка) — Кому открыт сайт: public — всем, сайт индексируют поисковики; link — всем, у кого есть ссылка, без индексации; team — участникам команды аккаунта после входа, на тарифе «Бизнес»; private — только владельцу аккаунта после входа.

Примечание: Один источник полностью заменяет текущий сайт; metadata-only вариант содержит только pin и/или visibility.

Успешный ответ — HTTP 200:

```json
{
  "id": "abc123",
  "url": "https://mypage.htmlkin.ru",
  "expires_at": null,
  "created_at": "2026-06-14T07:00:00Z",
  "updated_at": "2026-06-14T07:10:00Z",
  "size_bytes": 12345,
  "file_count": 8,
  "entry_path": "index.html",
  "pin_protected": false,
  "visibility": "public"
}
```

Пример запроса:

```bash
curl -X PUT https://htmlkin.ru/api/v1/pages/abc123 \
  -H "Authorization: Bearer $HTMLKIN_API_KEY" \
  -F "html_file=@index.html"
```

Возможные ошибки: `invalid_file`, `invalid_site`, `invalid_archive`, `invalid_path`, `missing_entry_file`, `too_many_files`, `banner_removal`, `invalid_pin`, `invalid_visibility`, `invalid_api_key`, `account_banned`, `team_visibility_requires_plan`, `content_blocked`, `dangerous_link`, `not_found`, `file_too_large`, `storage_limit_exceeded`, `rate_limit_exceeded` — см. таблицу ниже.

### GET /api/v1/pages/{id} — Получить информацию о странице

Возвращает метаданные страницы: адрес, размер сайта, число файлов, entrypoint, срок жизни, PIN-защиту и видимость.

Path-параметры:
- `id` — Идентификатор страницы.

Успешный ответ — HTTP 200:

```json
{
  "id": "abc123",
  "url": "https://mypage.htmlkin.ru",
  "expires_at": null,
  "created_at": "2026-06-14T07:00:00Z",
  "updated_at": "2026-06-14T07:10:00Z",
  "size_bytes": 12345,
  "file_count": 8,
  "entry_path": "index.html",
  "pin_protected": false,
  "visibility": "public"
}
```

Пример запроса:

```bash
curl -X GET https://htmlkin.ru/api/v1/pages/abc123 \
  -H "Authorization: Bearer $HTMLKIN_API_KEY"
```

Возможные ошибки: `invalid_api_key`, `account_banned`, `not_found`, `rate_limit_exceeded` — см. таблицу ниже.

### DELETE /api/v1/pages/{id} — Удалить страницу

Безвозвратно удаляет страницу. Если к странице был привязан кастомный домен, домен остаётся в аккаунте — снимается только его связь с этой страницей.

Path-параметры:
- `id` — Идентификатор страницы.

Успешный ответ — HTTP 200:

```json
{
  "id": "abc123",
  "deleted": true
}
```

Пример запроса:

```bash
curl -X DELETE https://htmlkin.ru/api/v1/pages/abc123 \
  -H "Authorization: Bearer $HTMLKIN_API_KEY"
```

Возможные ошибки: `invalid_api_key`, `account_banned`, `not_found`, `rate_limit_exceeded` — см. таблицу ниже.

### Коды ошибок

Тело ошибки: `{ "error": "<код>", "message": "<описание>" }`.

| HTTP | Код | Описание |
|---|---|---|
| 400 | `invalid_file` | Одиночный файл не похож на HTML. |
| 400 | `invalid_site` | Неверная комбинация источников или невалидный набор файлов сайта. |
| 400 | `invalid_archive` | ZIP повреждён, зашифрован или использует неподдерживаемый формат. |
| 400 | `invalid_path` | Недопустимый, небезопасный или дублирующийся путь файла. |
| 400 | `missing_entry_file` | В корне сайта нет HTML-файла. |
| 400 | `too_many_files` | В сайте больше 500 полезных файлов. |
| 400 | `banner_removal` | В файле сайта есть код, убирающий промо-бар htmlkin; бар снимается переходом на платный тариф. |
| 400 | `invalid_pin` | PIN не из 4 цифр. |
| 400 | `invalid_visibility` | visibility не из public, link, team, private. |
| 400 | `invalid_subdomain` | Субдомен с недопустимыми символами (разрешены a-z, 0-9, «-»). |
| 401 | `invalid_api_key` | Невалидный или отсутствующий API-ключ. |
| 403 | `account_banned` | Аккаунт заблокирован за нарушение правил сервиса. |
| 403 | `team_visibility_requires_plan` | Режим team доступен на тарифе «Бизнес». |
| 403 | `content_blocked` | Входная страница (index.html) побайтово совпадает со страницей сайта, заблокированного за нарушение правил сервиса. |
| 403 | `dangerous_link` | На странице есть ссылка, которую Google Web Risk относит к фишингу или вредоносному ПО. |
| 403 | `page_limit_exceeded` | Превышен лимит активных сайтов по тарифу. |
| 404 | `not_found` | Страница не найдена или принадлежит другому владельцу. |
| 409 | `subdomain_taken` | Запрошенный субдомен уже занят. |
| 413 | `file_too_large` | Распакованный сайт больше 200 МБ — предела одной загрузки. |
| 413 | `storage_limit_exceeded` | Сайт не помещается в хранилище: вместе с остальными активными сайтами аккаунта он превысил бы объём хранилища тарифа. При обновлении место текущей версии сайта учитывается как свободное. |
| 429 | `rate_limit_exceeded` | Превышена частота запросов; в ответе заголовок Retry-After. |

## MCP-сервер

Удалённый MCP-сервер уже развёрнут по адресу https://htmlkin.ru/mcp — устанавливать и запускать ничего не нужно. Авторизация — OAuth: при подключении клиент откроет браузер, пользователь войдёт в аккаунт и подтвердит доступ, ключ копировать не нужно. Клиент без OAuth передаёт API-ключ (создаётся в личном кабинете, https://htmlkin.ru/dashboard/api-keys; доступен на любом тарифе) в заголовке `Authorization: Bearer htk_твой_ключ` или параметром в адресе: `https://htmlkin.ru/mcp?key=htk_твой_ключ`.

Подключение в Claude Code:

```bash
claude mcp add --transport http htmlkin https://htmlkin.ru/mcp
```

Claude (claude.ai и Claude Desktop): Settings → Connectors → Add custom connector, в поле URL — `https://htmlkin.ru/mcp`, затем Connect: откроется вход в аккаунт.

Конфиг для других MCP-клиентов (Cursor, VS Code и т.п.):

```json
{
  "mcpServers": {
    "htmlkin": {
      "type": "http",
      "url": "https://htmlkin.ru/mcp"
    }
  }
}
```

Инструменты:

- `htmlkin_publish` — опубликовать сайт: `html_content` (полный HTML-документ, до 30 МБ) или `files` (набор текстовых файлов сайта); опционально `subdomain` и `pin`. Возвращает id и адрес сайта.
- `htmlkin_update` — полностью заменить сайт (`html_content` или `files`) и/или изменить PIN по `page_id`. URL сайта не меняется.
- `htmlkin_get` — получить адрес, размер, число файлов, entrypoint, срок жизни и PIN-защиту сайта по `page_id`.
- `htmlkin_delete` — удалить сайт; привязанный свой домен остаётся в аккаунте.

Многофайловый сайт через MCP: параметр `files` — массив объектов `{ path, content }`; до 20 текстовых файлов и до 2 МБ UTF-8 суммарно, в корне обязателен index.html. Поддерживаются текстовые форматы: HTML, CSS, JS, JSON, SVG, XML, Markdown и другие. Обновление всегда полностью заменяет текущий сайт. Бинарные файлы и большие сайты через arguments не передавай — загрузи ZIP через REST API (поле `site_archive`) или через браузер.

## Блог

- [Блог htmlkin](https://htmlkin.ru/articles): инструкции, сценарии с нейросетями, сравнения и настройка API — все статьи по рубрикам.
- [Рубрика «Инструкции»](https://htmlkin.ru/articles/category/guides): Пошаговые инструкции: публикация HTML-страниц и сайтов, выбор хостинга для статики.
- [Рубрика «Нейросети»](https://htmlkin.ru/articles/category/ai): Презентации, лендинги и отчёты из Claude и ChatGPT: как сделать и выложить по ссылке.
- [Рубрика «Сравнение»](https://htmlkin.ru/articles/category/vs): Сравнения htmlkin.ru с альтернативами и подходами.
- [Рубрика «Как пользоваться»](https://htmlkin.ru/articles/category/how-to-use): Пошаговая настройка возможностей htmlkin.ru: подключение своего домена, REST API, автопубликация из GitHub.
- [Артефакт Claude: как опубликовать и поделиться ссылкой](https://htmlkin.ru/articles/kak-opublikovat-artefakt-claude): Как опубликовать артефакт Claude из чата и из Claude Code, и как перенести артефакт на свой домен.
- [Вайбкодинг сайта: чем собрать из России и как выложить по ссылке](https://htmlkin.ru/articles/vaybkoding-sajta): Вайб кодинг сайта из России: какие нейросети работают без VPN, что получается на выходе и как выложить сайт по ссылке с доменом и формой заявок.
- [Презентация в формате HTML: как создать и показать](https://htmlkin.ru/articles/prezentaciya-v-formate-html): Что такое презентация в формате HTML и как её создать: нейросеть, reveal.js, Marp или готовый шаблон. Как показать слайды, сохранить в PDF и отправить ссылкой.
- [Презентация в ChatGPT: как сделать и поделиться ссылкой](https://htmlkin.ru/articles/prezentaciya-v-chatgpt): Четыре способа сделать презентацию в ChatGPT: HTML-слайды в чате, Work, надстройка PowerPoint и Canva. Что доступно бесплатно и как отправить слайды ссылкой.
- [Как организовать Git-Flow для htmlkin.ru](https://htmlkin.ru/articles/kak-organizovat-git-flow-dlya-htmlkin): Сайт в GitHub-репозитории публикуется на htmlkin.ru при каждом merge в main: API-ключ, ID сайта из личного кабинета, workflow GitHub Actions, работа через PR и откат.
- [Бесплатный хостинг для сайта: 10 площадок, где HTML откроется по ссылке](https://htmlkin.ru/articles/top-besplatnyh-hostingov-dlya-html): Где разместить сайт бесплатно в интернете: htmlkin, Netlify, posty5, SpaceWeb, Beget, Hostiman, SourceCraft Sites, GitVerse и GitHub Pages, Object Storage. Лимиты и порог входа по официальным условиям.
- [Что такое статический сайт и чем он отличается от динамического](https://htmlkin.ru/articles/chto-takoe-staticheskij-sajt): Статический сайт — это готовые файлы, которые сервер отдаёт как есть. Чем он отличается от динамического, что на нём сложнее и когда его хватает. 91% уязвимостей WordPress — в плагинах.
- [HTML-презентация из Claude: как сделать и поделиться ссылкой](https://htmlkin.ru/articles/html-prezentaciya-iz-claude): Claude собирает презентацию в Slides, Claude Design или файлом .pptx. Ссылку из Claude открывают только с аккаунтом — четыре способа выложить слайды по ссылке.
- [Аналоги Netlify и Vercel в России, которые работают без VPN](https://htmlkin.ru/articles/analogi-netlify-vercel-v-rossii): Аналоги Netlify и Vercel в России: S3-хранилища, PaaS с git push, GitVerse Pages и публикаторы. Сравнение по цене и порогу входа. 40% россиян пользуются VPN.
- [Доступны ли Netlify, Vercel и GitHub Pages из России: наш замер](https://htmlkin.ru/articles/netlify-vercel-github-pages-dostup-iz-rossii): Замерили доступность Netlify, Vercel и GitHub Pages из России: 63 из 63 проверок с российских нод прошли. Разбираем, почему жалобы на блокировки всё равно реальны.
- [GitHub Pages, Netlify, Vercel или htmlkin: что выбрать для статики](https://htmlkin.ru/articles/github-pages-netlify-vercel-htmlkin): Сравнение GitHub Pages, Netlify, Vercel и htmlkin для статики: порог входа, доступность из РФ без VPN, свой домен и цена. Что выбрать под свою задачу в 2026.
- [Как опубликовать HTML-сайт без git](https://htmlkin.ru/articles/kak-opublikovat-sajt-bez-git): Как опубликовать HTML-сайт без git: почему хостинги просят репозиторий, четыре способа залить файл перетаскиванием и как обновлять сайт без коммитов.
- [Как подключить домен к htmlkin.ru](https://htmlkin.ru/articles/kak-podklyuchit-domen-k-htmlkin): Пошагово: как добавить A-запись DNS и направить свой домен на страницу htmlkin. Панели reg.ru и nic.ru, CNAME для поддомена, проверка и разбор ошибок.
- [Как опубликовать HTML-страницу в интернете бесплатно](https://htmlkin.ru/articles/kak-besplatno-razmestit-html-onlajn): Как бесплатно разместить HTML-страницу онлайн: что подготовить, куда залить файл и как проверить ссылку. Chrome предупреждает посетителя перед открытием публичного сайта без HTTPS.
- [Хостинг статических сайтов: полный гайд 2026](https://htmlkin.ru/articles/hosting-staticheskih-saitov-2026): Хостинг статических сайтов в 2026: чем статика быстрее и безопаснее, сколько стоит и где размещать в России без VPN. 53% мобильных уходят при загрузке >3 сек.

## Контакты

- Сайт: https://htmlkin.ru/
- Email: info@htmlkin.ru