amo-crm-api

Агентский навык для amoCRM REST API v4. Даёт любому LLM-агенту (Claude Code, Claude.ai, своему Telegram-боту и т. п.) полный CRUD над сделками, контактами, компаниями, задачами и заметками — плюс справочники и управление подписками на webhook-события.

В составе навыка:

• SKILL.md — точка входа для агента: workflow и правила
• references/*.md — подробная документация по разделам API, агент подгружает по мере надобности
• scripts/api_call.py — тонкий HTTP-клиент на стандартной библиотеке Python, подписывает каждый запрос Bearer-токеном

Установка

git clone https://github.com/MissiaL/amo-crm-api ~/.claude/skills/amo-crm-api

Или, после публикации, через clawhub:

clawhub install missial/amo-crm-api

Как получить долгоживущий токен amoCRM

Нужны права администратора аккаунта.

1. Откройте амоМаркет → Интеграции в аккаунте amoCRM.
2. Нажмите Создать интеграцию и выберите подходящий тип интеграции.
3. Заполните название (например, «Агентский помощник»), ссылку для перенаправления можно оставить заглушкой (https://example.com), разрешите доступ к нужным разделам (минимум: сделки, контакты, компании, задачи, каталоги).
4. Сохраните интеграцию.
5. Откройте созданную интеграцию заново → вкладка «Ключи и доступы».
6. На вкладке ключей нажмите «Сгенерировать токен», выберите срок и скопируйте значение целиком (длинная строка вида eyJ0eXAi...). Такой токен действует от 1 дня до 5 лет, не имеет refresh token и после истечения либо отзыва должен быть сгенерирован заново.
7. Запомните поддомен аккаунта — часть в URL до .amocrm.ru. Например, для https://mycompany.amocrm.ru поддомен — mycompany.

Настройка окружения

Установите две переменные окружения:

export AMOCRM_SUBDOMAIN=mycompany
export AMOCRM_TOKEN=eyJ0eXAi...

Или скопируйте .env.example в .env и заполните.

Проверочный запрос:

python scripts/api_call.py --method GET --url "/api/v4/account"

Ответ 200 с JSON-описанием аккаунта означает, что навык подключён правильно. 401 — токен неверный или истёк.

Использование с агентом

Когда папка навыка лежит в каталоге, который агент сканирует (например, ~/.claude/skills/), агенту можно дать обычную человеческую задачу:

«Найди все открытые сделки в основной воронке, ответственный — Иван, и поставь по ним задачу позвонить завтра».

Агент сам прочитает SKILL.md, решит, какие references/*.md подгрузить, и сделает нужные вызовы через scripts/api_call.py.

Webhooks

Навык умеет управлять подписками на webhook-события amoCRM через REST — зарегистрировать URL, посмотреть активные подписки, отписаться. Принимать события навык не умеет: для этого нужен отдельный публичный HTTPS-сервис. Подробности — в references/webhooks.md.

Лицензия

MIT

Автор

MissiaL