amo-crm-api — скилл
Скилл для работы агента с amoCRM API v4: поиск, создание и изменение сделок, контактов, компаний, задач и примечаний
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Создает и изменяет сделки, контакты и задачи в рабочем аккаунте amoCRM, в том числе массово
- Хранит долгоживущий токен с доступом к данным клиентов
- Может перенаправить события аккаунта на внешний адрес через вебхуки
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/MissiaL/amo-crm-api ~/.claude/skills/amo-crm-apiЗатем задайте AMOCRM_SUBDOMAIN и AMOCRM_TOKEN или заполните .env по образцу .env.example.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает и изменяет сделки, контакты и задачи в рабочем аккаунте amoCRM, в том числе массово
- Хранит долгоживущий токен с доступом к данным клиентов
- Может перенаправить события аккаунта на внешний адрес через вебхуки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл учит агента выполнять операции в amoCRM через REST API v4. Все запросы идут через небольшой клиент на стандартной библиотеке Python, который подставляет токен и поддомен аккаунта. Справочные файлы по разделам API агент подгружает по мере надобности: соглашения и фильтры, сделки, контакты и компании, задачи и примечания, справочники воронок, пользователей и полей. В SKILL.md разобраны типовые сценарии: создать сделку с новым контактом, найти сделки клиента, перевести сделку в другой статус, поставить и закрыть задачу. Также скилл управляет подписками на вебхуки, но принимать события не умеет.
Для кого. Для отделов продаж и разработчиков, которые хотят поручать агенту рутину в amoCRM обычными словами.
Подходит, если
- Нужно найти открытые сделки по воронке или ответственному и поставить по ним задачи
- Нужно завести сделку сразу с контактом и компанией
- Нужно массово перевести сделки в другой статус
Не подходит, если
- Нужно принимать вебхуки от amoCRM: для этого нужен отдельный HTTPS-сервис
- Нужны общие советы по CRM, а не операции в конкретном аккаунте
Пример запроса к агенту
Найди все открытые сделки в основной воронке, где ответственный Иван, и поставь по ним задачу позвонить завтраОграничения
Для создания интеграции и долгоживущего токена нужны права администратора аккаунта amoCRM. Токен живет от дня до пяти лет, обновления нет, после истечения его генерируют заново. Скилл работает с аккаунтами на amocrm.ru, OAuth-поток не реализован. Нужен Python.
Как отключить. Удалите папку ~/.claude/skills/amo-crm-api и отзовите токен в настройках интеграции amoCRM.
Частые вопросы
Где взять токен?
В amoCRM: амоМаркет, раздел интеграций, создать интеграцию, затем на вкладке ключей и доступов сгенерировать токен.
Что означает ответ 401 при проверке?
Токен неверный, истек, отозван или интеграция отключена.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
amoCRM — все инструментыMCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика
Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен
amoCRM MCP с защитой от опасной записи
Я Мебель — amoCRM MCP
Коннектор к amoCRM API v4 с двухуровневой защитой записи: правки за флагом WRITE_ENABLED, удаление требует отдельного флага и confirm=true
Скилл квалификации лидов в Telegram с amoCRM
Universal AI Sales Agent
Три скилла и эталонная реализация Telegram-агента для квалификации лидов: диалог без кнопок, скоринг 0-100, RAG по базе клиента и запись в amoCRM
MCP-сервер для AmoCRM на FastMCP (21 инструмент)
AmoCRM MCP Server
Компактный MCP-сервер на FastMCP с 21 инструментом для AmoCRM: контакты, сделки, задачи, примечания, теги, воронки одним файлом server.py
MCP для руководителя отдела продаж в amoCRM
amoCRM ROP MCP Server
MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров
Коротко о README
README описывает состав скилла: SKILL.md, справочники по разделам API и Python-клиент. Установка сводится к клонированию в папку скиллов Claude Code. Пошагово объяснено, как создать интеграцию в amoCRM и получить долгоживущий токен, какие переменные окружения задать и как проверить подключение. Отдельно оговорено, что вебхуки скилл только настраивает. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
---
name: amo-crm-api
description: "Work with amoCRM (amo CRM, амоСРМ) REST API v4: сделки, контакты, компании, задачи, примечания, справочники и webhook-подписки. Use for amoCRM API requests and account data operations on *.amocrm.ru; not for generic CRM advice."
metadata: {"author":"MissiaL","version":"0.2.0","keywords":["amocrm","crm","sales","leads","contacts","tasks"]}
---
# amo-crm-api
Full CRUD over amoCRM REST API v4 — leads, contacts, companies, tasks, notes,
plus dictionary lookups (pipelines, users, custom fields, tags) and webhook
subscription management.
## Setup
Two environment variables are required:
| Var | Example | Where to get it |
|---|---|---|
| `AMOCRM_SUBDOMAIN` | `mycompany` | The part before `.amocrm.ru` in your account URL |
| `AMOCRM_TOKEN` | `eyJ0eXAi...` | Long-lived token from amoMarket → Integrations → integration keys |
Sanity-check the setup:
```bash
python scripts/api_call.py --method GET --url "/api/v4/account"
```
A 200 with the account JSON means you're set. A 401 means the token is invalid,
expired, revoked, or the integration was disabled. Long-lived tokens have a
user-selected expiry of 1 day to 5 years and no refresh token.
## HTTP client
All requests go through `scripts/api_call.py`. The script signs every request
with `Authorization: Bearer ${AMOCRM_TOKEN}`, prefixes relative URLs with
`https://${AMOCRM_SUBDOMAIN}.amocrm.ru`, and sends bodies as JSON.