amo-crm-api

Установка

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл учит агента выполнять операции в amoCRM через REST API v4. Все запросы идут через небольшой клиент на стандартной библиотеке Python, который подставляет токен и поддомен аккаунта. Справочные файлы по разделам API агент подгружает по мере надобности: соглашения и фильтры, сделки, контакты и компании, задачи и примечания, справочники воронок, пользователей и полей. В SKILL.md разобраны типовые сценарии: создать сделку с новым контактом, найти сделки клиента, перевести сделку в другой статус, поставить и закрыть задачу. Также скилл управляет подписками на вебхуки, но принимать события не умеет.

Для кого. Для отделов продаж и разработчиков, которые хотят поручать агенту рутину в amoCRM обычными словами.

Пример запроса к агенту

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

Ограничения

Для создания интеграции и долгоживущего токена нужны права администратора аккаунта amoCRM. Токен живет от дня до пяти лет, обновления нет, после истечения его генерируют заново. Скилл работает с аккаунтами на amocrm.ru, OAuth-поток не реализован. Нужен Python.

Как отключить. Удалите папку ~/.claude/skills/amo-crm-api и отзовите токен в настройках интеграции amoCRM.

Проверка безопасности

• Создает и изменяет сделки, контакты и задачи в рабочем аккаунте amoCRM, в том числе массово
• Хранит долгоживущий токен с доступом к данным клиентов
• Может перенаправить события аккаунта на внешний адрес через вебхуки

Коротко о README

README описывает состав скилла: SKILL.md, справочники по разделам API и Python-клиент. Установка сводится к клонированию в папку скиллов Claude Code. Пошагово объяснено, как создать интеграцию в amoCRM и получить долгоживущий токен, какие переменные окружения задать и как проверить подключение. Отдельно оговорено, что вебхуки скилл только настраивает. Лицензия MIT.

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.

Похожие