ثبّت مهارات وكيل Didit الاثني عشر مفتوحة المصدر في Cursor أو Claude Code أو Codex أو OpenCode بأمر `npx` واحد. اسأل الوكيل باللغة الإنجليزية العادية. سيكتب الكود ويستدعي الـ API المباشر.
Robinhood Ventures
موثوق به من قبل أكثر من 2,000 مؤسسة حول العالم.
لماذا المهارات وليس الوثائق؟
إذا أعطيت Cursor علامة تبويب وثائق، فإنه يخترع نقاط نهاية ويحول تعدادات الحالة إلى أحرف صغيرة. أما إذا أعطيته مهارة Didit، فإن كل سطر يشير إلى الـ API الحقيقي, نقطة نهاية مؤمنة، رؤوس مؤمنة، ومعالج webhook موقّع جاهز. كل ذلك بأمر `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 إلى تدفق التسجيل الخاص بي."* *"افحص هذا المستخدم مقابل قوائم مكافحة غسيل الأموال."* يقرأ الوكيل المهارة ذات الصلة، ويكتب الكود، ويوصل معالج الـ webhook الموقّع. صحيح من المحاولة الأولى, لا حاجة للتبديل بين علامات تبويب الوثائق.
تستضيف Didit الكاميرا، التقاط الوثائق، الصورة الذاتية، وتسليم الهاتف المحمول. أقل من 30 ثانية للمستخدم. حكم في أقل من ثانيتين على الـ webhook الخاص بك، موقّع بـ `X-Signature-V2` لتتمكن من الوثوق به.
Didit · الكتالوج
Didit · تثبيت npx
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 لغة، أكثر من 1,000 مصدر بيانات، و أكثر من 200 إشارة احتيال في كل جلسة. تتعلم بنية Didit التحتية ديناميكيًا من كل جلسة وتتحسن يومًا بعد يوم.
ملف Markdown صغير يعلم وكيل الذكاء الاصطناعي الخاص بك كيفية استدعاء إحدى واجهات برمجة تطبيقات Didit, نقطة النهاية، الرؤوس، شكل الجسم، حالات الأخطاء, مع كود عملي بلغات TypeScript و Python و cURL.
ثبّته مرة واحدة. في المرة التالية التي تسأل فيها Cursor أو Claude Code "أضف KYC إلى سير عمل التسجيل الخاص بي"، يقرأ الوكيل المهارة ويكتب الكود الصحيح من المحاولة الأولى. لا يوجد تبديل بين علامات التبويب للوثائق. لا توجد نقاط نهاية مخترعة. لا توجد حالة خاطئة.
إنه المعيار المفتوح لمهارات الوكيل (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 ثانية من البداية إلى النهاية, التقط الهوية، التقط صورة المستند، التقط صورة شخصية، انتهى. هذا هو الأسرع في السوق. عادةً ما يستغرق مزودو KYC التقليديون أكثر من 90 ثانية لنفس السير.
في الواجهة الخلفية، يعيد Didit النتيجة في أقل من ثانيتين عند p99، محسوبة من لحظة انتهاء المستخدم من الصورة الشخصية إلى لحظة إطلاق الـ webhook الخاص بك. تم ضبط التقاط الهاتف المحمول للهواتف البطيئة والشبكات البطيئة: ضغط تدريجي للصور، تحميل بطيء لـ SDK، وتسليم بنقرة واحدة من سطح المكتب إلى الهاتف عبر رمز QR إذا بدأ المستخدم على الويب.
Cursor، Claude Code، Codex، و OpenCode, بالإضافة إلى أي شيء يتبع المعيار المفتوح agentskills.io.
يكتشف CLI الخاص بـ npx وكيلك ويضع المهارة في المكان الصحيح, .claude/skills/، .cursor/skills/، وهكذا. نفس ملف Markdown في كل مكان، لا يوجد SDK خاص بالمضيف.
تحت الغطاء، تشير كل مهارة إلى نفس واجهة https://verification.didit.me/v3/* API بنفس رأس x-api-key ونفس الـ webhook الموقّع. المهارة هي مجرد كيفية قراءة الوكيل لها.
تصل كل جلسة إلى إحدى سبع حالات واضحة، لذا يعرف الكود الخاص بك دائمًا ما يجب فعله:
Approved, تم اجتياز جميع الفحوصات. انقل المستخدم إلى الأمام.Declined, فشل فحص واحد أو أكثر. يمكنك السماح للمستخدم بإعادة إرسال الخطوة الفاشلة المحددة (على سبيل المثال، إعادة التقاط الصورة الشخصية) دون إعادة تشغيل السير بالكامل.In Review, تم وضع علامة للمراجعة من قبل الامتثال. افتح الحالة في وحدة التحكم، واطلع على كل إشارة، وقرر الموافقة أو الرفض.In Progress, المستخدم في منتصف السير.Not Started, تم إرسال الرابط، ولم يفتحه المستخدم بعد. أرسل تذكيرًا إذا بقي طويلاً.Abandoned, فتح المستخدم الرابط ولكنه لم ينهِ في الوقت المحدد. أعد التفاعل أو انتهت صلاحيته.Expired, انتهت صلاحية رابط الجلسة. أنشئ جلسة جديدة.يتم إطلاق webhook موقّع عند كل تغيير في الحالة، لذا تظل قاعدة بياناتك متزامنة دائمًا. الجلسات المهجورة والمرفوضة مجانية.
تتم معالجة بيانات الإنتاج وتخزينها في الاتحاد الأوروبي بشكل افتراضي، على Amazon Web Services. يمكن للعقود المؤسسية طلب مناطق بديلة للولايات القضائية التي تتطلبها جهاتها التنظيمية.
تشفير شامل. تشفير AES-256 للبيانات الثابتة عبر كل قاعدة بيانات، ومخزن كائنات، ونسخة احتياطية. أمان طبقة النقل 1.3 للبيانات المتنقلة في كل استدعاء API، وwebhook، وجلسة Business Console. يتم تشفير البيانات البيومترية بمفتاح رئيسي منفصل للعميل.
الاحتفاظ بالبيانات تحت سيطرتك. الاحتفاظ الافتراضي هو غير محدود (إلى أجل غير مسمى) ما لم تقم بتكوين مدة أقصر, تتراوح بين 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. لا مجال للتخمين, المهارة توفر نقطة النهاية (endpoint) ورأس الطلب (header) وجسم الطلب (body) وتعداد الحالة (status enum) بالضبط.
الوثائق مكتوبة للبشر. الوكلاء يقعون في نفس الأخطاء مرارًا وتكرارًا:
POST /v3/wallet-screening/ بينما المسار الحقيقي موجود داخل /v3/transactions/Approved، وKYB هي APPROVED، والوكلاء يخلطون بينهاالمهارات تحل كل هذه المشاكل. يتم إصدارها جنبًا إلى جنب مع الـ API: عندما تطلق Didit نقطة نهاية جديدة، يتم إطلاق المهارة في نفس اليوم. تم اختبار 51 نقطة نهاية في كل إصدار.
واجهة برمجية واحدة لـ KYC و KYB ومراقبة المعاملات وفحص المحافظ. ادمجها في 5 دقائق.