diff --git a/plugins/222a-seo-audit/README.md b/plugins/222a-seo-audit/README.md
new file mode 100644
index 0000000..d9986d9
--- /dev/null
+++ b/plugins/222a-seo-audit/README.md
@@ -0,0 +1,71 @@
+# 222A SEO Audit — плагин для Claude Code
+
+Доступ к SEO-аудитам, анализу технических проблем и client reports от 222A.ru прямо из Claude Code.
+
+## Установка
+
+```bash
+/plugin marketplace add https://git.222a.ru/222a/claude-marketplace.git
+/plugin install 222a-seo-audit@222a
+```
+
+## Получение токена
+
+1. Откройте [https://222a.ru/lk/ai-tokens](https://222a.ru/lk/ai-tokens)
+2. Войдите или зарегистрируйтесь
+3. Создайте токен с правами **`mcp.read`** и **`mcp.write`**
+4. Скопируйте токен
+
+## Настройка переменной окружения
+
+**macOS / Linux (zsh):**
+```bash
+echo 'export MCP_222A_TOKEN="вставьте-сюда-токен"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+**Linux (bash):**
+```bash
+echo 'export MCP_222A_TOKEN="вставьте-сюда-токен"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**Windows PowerShell:**
+```powershell
+[Environment]::SetEnvironmentVariable("MCP_222A_TOKEN", "вставьте-сюда-токен", "User")
+```
+
+После настройки **перезапустите Claude Code**.
+
+## Команды
+
+| Команда | Описание |
+|---|---|
+| `/222a-audit <url\|project_id>` | Запустить аудит сайта и получить executive summary |
+| `/222a-status [audit_run_id]` | Статус текущего или указанного аудита |
+| `/222a-issue <issue_code> [audit_run_id]` | Разбор одной проблемы: затронутые URL + рекомендации |
+| `/222a-report [audit_run_id]` | Собрать client report из готовых артефактов |
+| `/222a-progress [audit_run_id]` | Сравнение с предыдущим аудитом |
+
+Помимо команд, можно просто описать задачу естественным языком — Claude использует подключённый MCP-сервер и встроенные workflow.
+
+## Обновление
+
+```bash
+/plugin marketplace update
+/plugin update 222a-seo-audit
+```
+
+## Безопасность
+
+- **Не коммитьте токен** в репозитории и не отправляйте в чаты
+- Если токен утёк — отзовите его на [https://222a.ru/lk/ai-tokens](https://222a.ru/lk/ai-tokens) и создайте новый
+- Токен хранится только в переменной окружения, не пишется в файлы плагина
+
+## Поддержка
+
+Issues и обратная связь: [https://git.222a.ru/222a/claude-marketplace/issues](https://git.222a.ru/222a/claude-marketplace/issues)
+
+## Лицензия
+
+Плагин распространяется свободно. Использование 222A.ru API — по условиям сервиса.