API فروشندگان دیجی‌کالا با هوش مصنوعی: ثبت کالا با Claude Code

دو کالای تازه رسیده و باید هر دو را در پنل فروشندگان دیجی‌کالا ثبت کنید. برای هر کدام همان کارهای همیشگی تکرار می‌شود: دستهٔ درست را پیدا کنید، ویژگی‌های اجباری آن دسته را پر کنید، عکس‌ها را بارگذاری کنید، عنوان بنویسید و کالا را به فروشگاه خودتان وصل کنید. اگر خودتان یا برنامه‌نویس فروشگاه با API فروشندگان دیجی‌کالا کار کرده باشید، می‌دانید هر کدام از این قدم‌ها چند درخواست جداست.

مهارت (Skill) digikala از مجموعهٔ «مهارت‌های کسب‌وکار ایرانی» به یک دستیار برنامه‌نویسی مثل Claude Code، Codex یا Cursor یاد می‌دهد همین مسیر را با API رسمی فروشندگان طی کند. جستجو و بررسی را دستیار خودش انجام می‌دهد و پیش از ذخیرهٔ کالا، افزودنش به موجودی و درخواست ثبت برند تأیید می‌خواهد. ذخیرهٔ عنوان و بارگذاری عکس پرسش y/N ندارند، پس پیش از آن‌ها داده را خودتان ببینید.

اتصال هوش مصنوعی به پنل فروشندگان دیجی‌کالا چطور کار می‌کند؟

مهارت سرور نیست. پوشه‌ای است با یک فایل دستورالعمل (SKILL.md) و چند اسکریپت bash که دستیار در ترمینال خودتان اجرا می‌کند. اسکریپت‌ها با curl به seller.digikala.com/open-api/v1/ درخواست می‌فرستند. اگر فرق مهارت با سرور MCP برایتان روشن نیست، مقایسهٔ Skill و MCP را ببینید.

توکن دسترسی فقط از دو جا خوانده می‌شود: متغیر محیطی DIGIKALA_ACCESS_TOKEN، یا فایلی که مسیرش را خودتان در DIGIKALA_TOKEN_FILE می‌نویسید. مهارت جای دیگری دنبال رمز نمی‌گردد و توکن را چاپ نمی‌کند. برای گرفتن توکن، دیجی‌کالا باید یک کلاینت API برای فروشگاهتان ثبت کرده باشد. مهارت برای این کار فقط نشانی Marketplace-API@digikala.com را معرفی می‌کند و بیشتر از این توضیحی نمی‌دهد.

مستندات همراه مهارت ۲۷۴ عملیات API را شرح می‌دهد، ولی اسکریپت‌ها فقط سه گروه را صدا می‌زنند: دسته‌بندی، ساخت کالا و تصویر. پس عدد ۲۷۴ اندازهٔ مرجع است، نه کارهایی که مهارت انجام می‌دهد.

ثبت کالا در دیجی‌کالا با Claude Code، قدم‌به‌قدم

لازم نیست نام اسکریپت‌ها را بدانید. کار را همان‌طور که به یک همکار می‌گویید بنویسید، مثلاً «برای این هدفون بی‌سیم دستهٔ مناسب را پیدا کن و بگو کدام ویژگی‌هایش اجباری است.» دستیار این مسیر را می‌رود:

1. جستجو می‌کند که کالا از قبل در دیجی‌کالا هست یا نه.
2. نتیجهٔ جستجو برای هر کالا نشان می‌دهد اجازهٔ فروشش را دارید یا نه و کمیسیونش چقدر است (be-seller هم همین را برای یک کالا می‌پرسد). کمیسیون به دسته بستگی دارد، پس همین‌جا ببینیدش.
3. دسته و ویژگی‌های اجباری‌اش را بررسی می‌کند. درخت دسته‌ها و جستجوی کلیدواژه در دسته‌ها هم در دسترس است.
4. پیش‌نویس کالا را می‌سازد.
5. عکس‌ها را در فضای موقت دیجی‌کالا بارگذاری می‌کند و بررسی هوشمند تصویر دیجی‌کالا را روی آن‌ها اجرا می‌کند. عکس‌های موقت بعد از مدتی منقضی می‌شوند، پس این قدم را نزدیک به ذخیرهٔ کالا انجام دهید.
6. عنوان را ذخیره می‌کند. قاعدهٔ خود دیجی‌کالاست که عنوان فارسی (title_fa) واقعاً فارسی باشد.
7. کالا را ذخیره می‌کند و به موجودی فروشگاهتان اضافه می‌کند. این دو کار فقط با تأیید شما انجام می‌شوند.

اسکریپت ساخت کالا درخواست ثبت برند تازه را هم دارد، که آن هم تأیید می‌خواهد.

کدام کارها بدون تأیید شما انجام نمی‌شود؟

مهارت کارها را سه دسته کرده است:

برای کارهای ردیف آخر، اسکریپت در ترمینال «y/N» می‌پرسد. وقتی ترمینالی در کار نباشد، مثلاً اسکریپت را دستیار یا یک برنامهٔ خودکار اجرا کند، کار را رد می‌کند، مگر اینکه متغیر DIGIKALA_CONFIRM=1 تنظیم شده باشد. خود مهارت می‌گوید این متغیر را فقط بعد از دیدن تغییر دقیق، همراه کاربر، تنظیم کنید. پس اگر دستیار خواست آن را بگذارد، اول بخواهید داده‌ای را که می‌خواهد بفرستد نشانتان بدهد.

چند مرز دیگر هم در خود مهارت هست:

• سفارش، ارسال، امور مالی، پشتیبانی مشتری و اطلاعات هویتی فروشنده عمداً پوشش داده نشده‌اند.
• آدرس دیگری غیر از seller.digikala.com پذیرفته نمی‌شود، مگر یک نسخهٔ آزمایشی روی کامپیوتر خودتان.
• اگر به سقف درخواست‌ها برسید، دیجی‌کالا خطای ۴۲۹ و زمان بازشدن دوباره (reset_time) را برمی‌گرداند.
• اگر توکنی لو رفت، باطلش کنید. مرجع مهارت راهش را هم آورده است.

اول روی محیط آزمایشی امتحان کنید

برای کار برنامه‌نویسی، مهارت یک محیط آزمایشی با داده‌های ساختگی معرفی می‌کند. آن را روی کامپیوتر خودتان اجرا کنید و دو متغیر بگذارید: DIGIKALA_BASE_URL=http://localhost:<port> و DIGIKALA_ALLOW_CUSTOM_HOST=1. توکن هم یک توکن دورریختنی باشد، هرگز توکن واقعی فروشگاه. وقتی مسیر کامل را یک بار آنجا دیدید، سراغ حساب واقعی بروید.

گزارش روزانهٔ قیمت دلار و طلا، بدون عدد حدسی

مهارت دوم مجموعه، iran-finance-markets-monitor، یک گزارش فارسی از بازار می‌سازد: دلار، یورو و درهم بازار آزاد، طلای ۱۸ عیار، سکهٔ امامی، تتر به تومان، بیت‌کوین و اتریوم و چند رمزارز دیگر، شاخص ترس و طمع، ارزش کل بازار رمزارز و تا سه پیوند خبری.

قیمت‌های داخلی از جدول‌های صفحهٔ اصلی TGJU خوانده می‌شوند. نرخ نوبیتکس، والکس و بیت‌پین هم از جدول صرافی‌های همان سایت می‌آید، نه از API خود صرافی‌ها. رمزارزها از CoinGecko و شاخص ترس و طمع از alternative.me می‌آیند. کلید API لازم نیست.

نکتهٔ اصلی این مهارت قاعده‌هایی است که به دستیار یاد می‌دهد:

• هیچ عددی ساخته نمی‌شود. اگر مقداری پیدا نشود، null می‌ماند، در گزارش فارسی با خط تیره نمایش داده می‌شود و علتش در فهرست خطاها می‌آید.
• ریال فقط یک بار و با تقسیم بر ۱۰ به تومان تبدیل می‌شود، تا قیمت ده برابر یا یک‌دهم نشود.
• رقم‌های فارسی و عربی پیش از محاسبه یکدست می‌شوند و ساعت‌ها به وقت تهران است.
• داده‌ای که بیش از دو روز کهنه باشد پذیرفته نمی‌شود. فاصلهٔ خرید و فروش تتر و اختلاف قیمتش بین صرافی‌ها هم هر کدام نباید از ۰٫۵ درصد بیشتر باشد.
• هر منبع جدا خطا می‌دهد. اگر یکی جواب ندهد، بقیهٔ گزارش می‌آید و وضعیت آن partial است. فقط وقتی هیچ خطایی نباشد وضعیت ok است.

خروجی یک فایل JSON با تاریخ شمسی و میلادی و یک متن فارسی آماده است. اسکریپتش پایتون است و چهار بسته می‌خواهد: jdatetime، requests، beautifulsoup4 و feedparser. خروجی گزارش است، نه توصیهٔ خرید و فروش.

اگر فقط قیمت روز را می‌خواهید و حوصلهٔ نصب پایتون ندارید، سرور MCP «قیمت طلا و ارز (TGJU)» بدون نصب از طریق روتر بازارچه کار می‌کند. راهنمای قیمت دلار و طلا با هوش مصنوعی طرز پرسیدنش را نشان می‌دهد.

ساخت رزومهٔ فارسی با هوش مصنوعی، بدون به‌هم‌ریختن متن

هر کس رزومهٔ فارسی را در Word نوشته باشد این صحنه را دیده است: نام یک فناوری انگلیسی وسط جمله جابه‌جا می‌شود، نشانی ایمیل برعکس نمایش داده می‌شود و تاریخ‌ها نصفه شمسی و نصفه میلادی‌اند. مهارت سوم، persian-resume، رزومهٔ راست‌به‌چپ را به شکل PDF یا Word می‌سازد و همین‌ها را رعایت می‌کند:

• اصطلاح‌های فنی انگلیسی با املای خودشان می‌مانند و به فارسی نوشته نمی‌شوند. نشانی وب و ایمیل چپ‌به‌راست می‌مانند.
• هر رزومه یک تقویم دارد: شمسی برای کارفرمای ایرانی و میلادی برای موقعیت‌های بین‌المللی.
• هر بند سابقهٔ کاری روی دستاورد است: کار، نتیجه، و عدد اگر واقعاً دارید. مهارت صریحاً می‌گوید عدد، شرکت یا تاریخ ساختگی ننویسید.
• دو قالب دارد: classic تک‌ستونی و modern دوستونی با ستون کناری. فونت‌ها وزیرمتن، ساحل، شبنم یا صمیم‌اند.
• یک فهرست بررسی هم دارد تا رزومه در سامانه‌های غربالگری خودکار (ATS) درست خوانده شود.

اسکریپت‌هایش به python-docx و weasyprint نیاز دارند، ولی فایل فهرست وابستگی ندارد و باید خودتان نصبشان کنید. اینکه weasyprint روی ویندوز بی‌دردسر نصب شود را ما آزمایش نکرده‌ایم. برای گزارش، نامه و سندهای دیگر، مهارت جداگانهٔ persian-documents در همین مخزن هست که در دستور نصب پیش‌فرض نیامده است.

نصب مهارت دیجی‌کالا و دو مهارت دیگر

دستور نصب، همان‌طور که در صفحهٔ مهارت‌های کسب‌وکار ایرانی آمده:

npx skills add ehsanghaffar/skills --skill digikala
npx skills add ehsanghaffar/skills --skill iran-finance-markets-monitor
npx skills add ehsanghaffar/skills --skill persian-resume

هر مهارت جدا نصب می‌شود، پس فقط همانی را بزنید که لازم دارید. چند نکته:

• ابزار npx skills نسخهٔ ۲۲٫۲۰ یا بالاتر Node.js را می‌خواهد.
• بدون گزینهٔ اضافه، مهارت فقط برای پروژهٔ فعلی نصب می‌شود. با -g در انتهای دستور برای همهٔ پروژه‌ها نصب می‌شود، همان‌طور که در راهنمای مهارت rtl-design هم آمده. با -a claude-code دستیار را خودتان انتخاب می‌کنید.
• برای مهارت دیگری از این مخزن، نامش را بعد از --skill بنویسید، مثلاً persian-documents. راه دیگر کپی‌کردن پوشهٔ skills/<نام مهارت> مخزن در ~/.claude/skills/ است.
• بعد از نصب، دستیار را ببندید و دوباره باز کنید. مهارت‌ها هنگام شروع نشست پیدا می‌شوند.

پیش از نصب بخوانید

این مجموعه را عضوی از جامعه به نام ehsanghaffar ساخته، نه ما. مجوزش MIT است و آخرین بررسی ما ۲۴ مهر ۱۴۰۵ بوده. پیش از نصب، SKILL.md و اسکریپت‌های هر مهارت را بخوانید؛ این مهارت‌ها در ترمینال شما فرمان اجرا می‌کنند.

مهارت دیجی‌کالا روی حساب واقعی فروشنده کار می‌کند و ساخت کالا، تغییر عنوان و افزودن به موجودی فروشگاه شما را عوض می‌کند. مهارت بازار جدول‌های TGJU را از روی جای ستون‌ها و برچسب‌ها می‌خواند و اگر سایت عوض شود، به جای حدس زدن خطا ثبت می‌کند. اینکه CoinGecko و alternative.me از اینترنت ایران در دسترس باشند را هم بررسی نکرده‌ایم. جای مطمئن اجرای این مهارت‌ها دستیاری با ترمینال است؛ کار کردنشان در claude.ai آزموده نشده است.

این مهارت برای فروشنده‌هاست. اگر به‌عنوان خریدار دنبال قیمت و مقایسهٔ کالا هستید، سرور MCP دیجی‌کالا به کارتان می‌آید و راهنمای پیدا کردن ارزان‌ترین کالا در دیجی‌کالا طرز کار با آن را نشان می‌دهد. برای فروشنده‌ها، دریافت مهارت را بزنید و کار را از محیط آزمایشی شروع کنید.