Установите двенадцать навыков агентов Didit с открытым исходным кодом в Cursor, Claude Code, Codex или OpenCode одной командой `npx`. Задайте вопрос агенту на простом английском. Он напишет код и вызовет реальный API.
Robinhood Ventures
Нам доверяют более 2000 организаций по всему миру.
Почему навыки, а не документация
Дайте Cursor вкладку с документацией, и он будет придумывать эндпоинты и писать статусы перечислений в нижнем регистре. Дайте ему навык Didit, и каждая строка будет указывать на реальный API, заблокированный эндпоинт, заблокированные заголовки, готовый обработчик подписанных вебхуков. Одна команда `npx`.
Запустите `npx skills add didit-protocol/skills` в вашем проекте. CLI обнаружит Cursor, Claude Code, Codex или OpenCode и поместит каждый навык в нужную папку. Установите только один с помощью `--skill didit-face-match`.
Либо получите его за 60 секунд на [business.didit.me](https://business.didit.me) и `export DIDIT_API_KEY=…`, либо позвольте агенту зарегистрироваться программно, `POST /programmatic/register/`, затем `verify-email/`, и ключ вернется в ответе. Браузер не нужен.
*«Добавь Didit KYC в мой процесс регистрации».* *«Проверь этого пользователя по спискам AML».* Агент читает соответствующий навык, пишет код и подключает обработчик подписанных вебхуков. Правильно с первой попытки, без переключения вкладок документации.
Didit размещает камеру, захват документов, селфи, мобильную передачу. Менее 30 секунд для пользователя. Вердикт на ваш вебхук менее чем за 2 секунды, подписанный `X-Signature-V2`, чтобы вы могли ему доверять.
Didit · Каталог
Didit · npx install
Didit · Хосты
Didit · Какие навыки блокируются
Didit · Настройка
Didit · github.com/didit-protocol/skills
В каждом навыке
Три способа установки
$ npx skills add didit-protocol/skills
✓ 12 навыков установлено
# or just one
$ npx skills add didit-protocol/skills \
--skill didit-face-match
# set the api key
$ export DIDIT_API_KEY="sk_live_..."Cursor, Claude Code, Codex, OpenCode обнаружены автоматически.$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "$DIDIT_WORKFLOW_ID",
"vendor_data": "user-42",
"callback_url": "https://app/cb"
}'{ "url": "verify.didit.me/..." }You are installing the Didit Agent Skills into this project and wiring the first verification session against the live https://verification.didit.me/v3/ API. After this prompt, the project should pass identity verification — Know Your Customer (KYC), Anti-Money Laundering (AML) screening, document Optical Character Recognition (OCR) — through Didit.
Didit ships twelve open-source Agent Skills at https://github.com/didit-protocol/skills and follows the open standard at https://agentskills.io. The CLI auto-detects whether you are running inside Cursor, Claude Code, Codex, or OpenCode and drops the skills into the right folder.
PRE-REQUISITES
- A Didit API key (DIDIT_API_KEY). Either issued from https://business.didit.me, or self-registered by the agent via POST /programmatic/register/ + POST /programmatic/verify-email/ (no browser needed).
- A workflow_id from the Workflow Builder that bundles ID Verification + Passive Liveness + Face Match + IP Analysis + AML — or just use the didit-kyc-onboarding skill below to create one programmatically.
- A webhook endpoint that verifies the X-Signature-V2 header with HMAC-SHA256 on the raw body bytes (do NOT re-serialise the parsed JSON; the signature will not match).
STEP 1 — Install the skills
Recommended:
npx skills add didit-protocol/skills
This installs all twelve skills. To install only one:
npx skills add didit-protocol/skills --skill didit-face-match
Or git clone the repo and copy what you need:
git clone https://github.com/didit-protocol/skills.git
cp -r skills/didit-kyc-onboarding .claude/skills/
cp -r skills/didit-id-document-verification .claude/skills/
The twelve skills:
- didit-verification-management : the hub. Account, sessions, workflows, billing, blocklist, webhook config. 45+ endpoints
- didit-kyc-onboarding : full KYC recipe (ID + selfie + face match) in one call
- didit-id-document-verification : passports, ID cards, driver's licences. OCR, MRZ, NFC. 4,000+ documents, 220+ countries
- didit-liveness-detection : 99.9%-accurate liveness from a single selfie
- didit-face-match : compare two faces, get a 0–100 score
- didit-face-search : 1:N face search for deduplication and blocklists
- didit-biometric-age-estimation : estimate age from a selfie
- didit-email-verification : email OTP, detects breached / disposable / undeliverable
- didit-phone-verification : phone OTP via SMS, WhatsApp, or Telegram. Catches VoIP
- didit-aml-screening : 1,300+ sanctions, PEP, adverse-media lists. Dual-score risk
- didit-proof-of-address : utility bills, bank statements. OCR + geocoding
- didit-database-validation : government databases across 18 countries
STEP 2 — Set the environment
Every skill reads DIDIT_API_KEY. Session-based skills also expect DIDIT_WORKFLOW_ID. Signed-webhook handlers expect DIDIT_WEBHOOK_SECRET.
export DIDIT_API_KEY="<your api key>"
export DIDIT_WORKFLOW_ID="<your workflow id>" # optional
export DIDIT_WEBHOOK_SECRET="<your secret>" # optional
Programmatic alternative (no browser):
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "password": "MyStr0ng!Pass"}'
# check the email, get the 6-char code, then:
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "code": "<code>"}'
# response includes api_key — export it as DIDIT_API_KEY.
STEP 3 — Create a verification session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: $DIDIT_API_KEY
Content-Type: application/json
Body:
{
"workflow_id": "$DIDIT_WORKFLOW_ID",
"vendor_data": "<your user id, max 256 chars>",
"callback_url": "https://<your-app>/kyc/callback",
"metadata": { "source": "agent-skill" }
}
Response: 201 Created. The hosted session URL is on the `url` field. Redirect the user, or send them the link by email / SMS / WhatsApp. Sub-2-second p99 verdict on completion.
STEP 4 — Read the signed webhook
Didit POSTs to your callback. KYC session statuses are Title Case With Spaces.
Body (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your user id>",
"status": "Approved",
"id_verification": { "status": "Approved" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"aml": { "status": "Approved", "hits": [] }
}
Full enum:
Approved | Declined | In Review | In Progress | Not Started | Abandoned | Expired | Resubmitted | Awaiting User | Not Finished
Verify X-Signature-V2 BEFORE parsing the body — HMAC-SHA256 of the raw bytes with your webhook secret. Re-serialising the parsed body changes whitespace and key order and the signature will not match.
STEP 5 — Read the decision on demand
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: $DIDIT_API_KEY
Returns the full decision payload — id_verification, liveness, face, ip_analysis, aml. Use this whenever the agent needs to confirm the user's status before allowing an action. Never trust client-supplied "I'm verified" flags.
STEP 6 — Branch on status
Approved → continue
Declined → block, surface decision_reason_code, allow resubmit of the failed step
In Review → wait for the analyst webhook; don't block forever
Resubmitted → user re-took a failed step; new verdict is coming
Awaiting User → user hasn't completed the flow; nudge with a reminder
Expired → create a new session
Abandoned and Declined sessions are NOT billed.
STEP 7 — Optional: ongoing AML monitoring
If AML monitoring is enabled on the workflow ($0.07 per user per year), Didit fires status.updated whenever the user lands on a new sanctions / PEP / adverse-media list. No extra endpoint to call.
WEBHOOK EVENT NAMES
- status.updated : KYC or KYB session status changed
- data.updated : session data corrected after creation
- user.status.updated : User entity changed status (Active, Flagged, Blocked)
- user.data.updated : User entity counters, metadata, or aggregate fields changed
- activity.created : timeline activity recorded
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox is separate from production.
CONSTRAINTS
- KYC session statuses use Title Case With Spaces (Approved, In Review). Do NOT transform them to UPPER_SNAKE_CASE — that casing is for Know Your Business (KYB) sessions and Transaction Monitoring, not KYC.
- HMAC verification runs against the RAW request body bytes. Never re-serialise the parsed JSON.
- Bundle price is $0.30 (ID + Liveness + Face Match + IP Analysis). AML adds $0.20. 500 verifications free every month, forever.
- Default record retention is unlimited unless you configure it shorter (30 days to 10 years per application).
Read the docs:
- https://docs.didit.me/getting-started/agent-skills
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/integration/webhooks
Skills repo:
- https://github.com/didit-protocol/skills
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.$0 / месяц. Кредитная карта не требуется.
Платите только за то, что используете. Более 25 модулей. Публичные цены за модуль, без минимальной ежемесячной платы.
Индивидуальные MSA и SLA. Для больших объемов и регулируемых программ.
Начните бесплатно → платите только за выполненные проверки → переходите на Enterprise для индивидуального контракта, SLA или размещения данных.
Didit, это инфраструктура для идентификации и борьбы с мошенничеством, платформа, которую мы сами хотели бы иметь, когда создавали продукты: открытая, гибкая и удобная для разработчиков, чтобы она работала как реальная часть вашего стека, а не как черный ящик, который вы обходите.
Один API охватывает верификацию людей (KYC, знай своего клиента), верификацию компаний (KYB, знай свой бизнес), проверку криптокошельков (KYT, знай свою транзакцию) и мониторинг транзакций в реальном времени, на стеке, созданном для того, чтобы быть:
В основе: более 14 000 типов документов на более чем 48 языках, более 1000 источников данных и более 200 сигналов мошенничества для каждой сессии. Инфраструктура Didit динамически обучается на каждой сессии и становится лучше с каждым днем.
Небольшой файл Markdown, который учит вашего ИИ-агента вызывать один из API Didit, конечную точку, заголовки, структуру тела запроса, обработку ошибок, с рабочим кодом на TypeScript, Python и cURL.
Установите его один раз. В следующий раз, когда вы спросите Cursor или Claude Code «добавь KYC в мой процесс регистрации», агент прочитает skill и напишет правильный код с первой попытки. Без переключения на документацию. Без выдуманных конечных точек. Без неправильного регистра статусов.
Это открытый стандарт Agent Skills. Didit поставляет двенадцать таких навыков, бесплатных и с открытым исходным кодом на github.com/didit-protocol/skills.
Один навык на каждую возможность Didit, всего двенадцать, 51 конечная точка протестирована от начала до конца:
Установите все сразу одной командой: npx skills add didit-protocol/skills. Установите только один: npx skills add didit-protocol/skills --skill didit-face-match.
Полный процесс обычно занимает менее 30 секунд от начала до конца, взять ID, сфотографировать документ, сделать селфи, готово. Это самый быстрый показатель на рынке. Устаревшие KYC-провайдеры обычно тратят более 90 секунд на тот же процесс.
На бэкенде Didit возвращает результат менее чем за две секунды при p99, от момента завершения селфи пользователем до момента срабатывания вашего вебхука. Мобильный захват оптимизирован для медленных телефонов и медленных сетей: прогрессивное сжатие изображений, отложенная загрузка SDK и передача в одно касание с десктопа на телефон через QR-код, если пользователь начинает на вебе.
Cursor, Claude Code, Codex и OpenCode, плюс все, что соответствует открытому стандарту agentskills.io.
CLI npx определяет вашего агента и помещает навык в нужное место, .claude/skills/, .cursor/skills/ и так далее. Один и тот же файл Markdown везде, без SDK, специфичного для хоста.
Под капотом каждый навык указывает на один и тот же API https://verification.didit.me/v3/* с одним и тем же заголовком x-api-key и одним и тем же подписанным вебхуком. Навык, это просто способ, которым агент его читает.
Каждая сессия получает один из семи четких статусов, поэтому ваш код всегда знает, что делать:
Approved, все проверки пройдены. Переведите пользователя дальше.Declined, одна или несколько проверок не пройдены. Вы можете разрешить пользователю повторно отправить конкретный неудачный шаг (например, повторно сделать селфи), не перезапуская весь процесс.In Review, помечено для проверки комплаенсом. Откройте кейс в консоли, просмотрите все сигналы, примите решение об одобрении или отклонении.In Progress, пользователь находится в процессе.Not Started, ссылка отправлена, пользователь еще не открыл ее. Отправьте напоминание, если она долго не открывается.Abandoned, пользователь открыл ссылку, но не завершил вовремя. Повторно вовлеките или аннулируйте.Expired, срок действия ссылки на сессию истек. Создайте новую сессию.Подписанный вебхук срабатывает при каждом изменении статуса, поэтому ваша база данных всегда остается синхронизированной. Отмененные и отклоненные сессии бесплатны.
По умолчанию производственные данные обрабатываются и хранятся в Европейском Союзе на Amazon Web Services. Для корпоративных контрактов можно запросить альтернативные регионы, если это требуется регуляторами юрисдикции.
Шифрование повсюду. AES-256 для данных в состоянии покоя во всех базах данных, объектных хранилищах и резервных копиях. Transport Layer Security 1.3 для данных в движении при каждом вызове API, вебхуке и сессии Business Console. Биометрические данные шифруются отдельным ключом Customer Master Key.
Вы контролируете срок хранения. По умолчанию срок хранения бессрочный (неограниченный), если вы не настроите более короткий, от 30 дней до 10 лет для каждого приложения. Вы можете удалить любую отдельную сессию в любое время из дашборда или через API.
Сертификаты: SOC 2 Type 1 (аудит Type 2 в процессе), ISO/IEC 27001:2022, iBeta Level 1 PAD, а также публичное подтверждение от Tesoro / SEPBLAC / CNMV Испании о том, что удаленная верификация личности Didit безопаснее, чем личная верификация. Полный отчет доступен по ссылке /security-compliance.
Didit по умолчанию соответствует требованиям регуляторов, важных для инфраструктуры идентификации:
Подробное описание, все сертификаты, все письма регуляторов: /security-compliance.
Три пути интеграции, выберите тот, который подходит вашему стеку:
Один и тот же дашборд, одна и та же система биллинга, одна и та же цена за успешную верификацию для всех трех вариантов. Пошаговое руководство на docs.didit.me/integration/integration-prompt.
Одна команда:
``bash
npx skills add didit-protocol/skills
``
CLI определяет, находитесь ли вы в Cursor, Claude Code, Codex или OpenCode, и помещает каждый навык в нужную папку. Установите только один с помощью --skill didit-face-match.
Предпочитаете Git? git clone https://github.com/didit-protocol/skills и скопируйте то, что вам нужно. Предпочитаете без инструментов? Откройте репозиторий и скопируйте один SKILL.md в каталог навыков вашего агента, каждый навык самодостаточен.
Единственная переменная окружения, которая нужна каждому навыку, это DIDIT_API_KEY. Получите ее за 60 секунд на business.didit.me или позвольте агенту зарегистрироваться программно через POST /programmatic/register/.
Простой язык, без жаргона и лишних слов:
Агент считывает соответствующий навык и пишет готовый к продакшену код на TypeScript, Python или Bash. Никаких догадок, навык выдает точный эндпоинт, заголовки, тело запроса и перечисление статусов.
Документация пишется для людей. Агенты постоянно спотыкаются об одни и те же вещи:
POST /v3/wallet-screening/, когда реальный путь находится внутри /v3/transactions/Approved, KYB это APPROVED, агенты их путаютНавыки все это фиксируют. Версионируются вместе с API: когда Didit выпускает новый эндпоинт, навык выходит в тот же день. 51 эндпоинт тестируется при каждом релизе.
Единый API для KYC, KYB, мониторинга транзакций и проверки кошельков. Интеграция за 5 минут.