skills.rest
ehsanghaffar
ehsanghaffarCOMMUNITY
Explore all skills by this author →
Website𝕏@ehsanghaffarGitHub

digikala

Automate seller operations on the Digikala Marketplace Open API via bash scripts.

7|Updated Sep 19, 2026
Search Tags:#bash#e-commerce#product creation#iran#seller automation#marketplace api#digikala
One-click install
npx skills add https://github.com/ehsanghaffar/skills --skill digikala-ehsanghaffar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: digikala
Source: https://github.com/ehsanghaffar/skills/tree/main/skills/digikala
Command: npx skills add https://github.com/ehsanghaffar/skills --skill digikala-ehsanghaffar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve? Manually managing products, categories, and images on Digikala's seller panel is slow and error-prone, especially when creating products through the multi-step pipeline of search, validation, image upload, and assignment. This Skill wraps the Digikala Marketplace Open API (274 endpoints) into ready-to-run bash scripts so sellers and developers can automate these workflows directly. ## Core Features & Use Cases - Product Creation Pipeline: Search existing products, validate categories and attributes, create drafts, generate AI titles, save products, and assign them to your seller account. - Category Navigation: Browse the category tree, search categories by keyword, and validate categories for product creation. - Image Management: Upload product, request, and brand logo images to Digikala temp storage and run AI quality checks on uploads. - Safety Controls: Operations are classified as read-only, write, or state-changing, with interactive y/N confirmation prompts before any live marketplace change. - Use Case: A seller wants to list a new smartwatch. They search for the product, validate the category, upload photos, run the AI image check, save the Persian title, and confirm the live product creation — all from the command line. ## Quick Start Set your DIGIKALA_ACCESS_TOKEN environment variable, then ask the agent to search Digikala products for a keyword like "iPhone 15" using the product-create script.

Frequently Asked Questions about digikala

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a product on Digikala using the API?▼

Product creation on Digikala follows a pipeline: search existing products, validate the category and details, upload images, save the title, then run save-product with the JSON payload. The save-product and assign steps prompt for y/N confirmation because they modify the live marketplace.

How do I authenticate with the Digikala Marketplace Open API?▼

Authentication uses a bearer token provided via the DIGIKALA_ACCESS_TOKEN environment variable or a ~/.digikala/token file with chmod 600 permissions. You must register an active client with Digikala by contacting [email protected] to obtain tokens.

Can I test the Digikala API without live credentials?▼

Yes, Digikala provides a sandbox environment at github.com/salimousavi/seller_service_sandbox with mock data for all endpoints. It requires no client registration and is recommended before running operations against the live marketplace.

Why am I getting 401 or 403 errors from the Digikala seller API?▼

A 401 error means your access token is invalid or expired, so update DIGIKALA_ACCESS_TOKEN or the token file. A 403 error means your application lacks the required scope; check available scopes via the /auth/scopes/{client_code} endpoint.

Which Digikala API operations are safe to run without confirmation?▼

Read-only operations such as search, suggest, be-seller, validate-category, get-attributes, tree, and ai-check are safe to run anytime. State-changing operations like save-product, assign, and brand-request prompt for confirmation because they affect the live marketplace and seller account.

Related Skills

Explore More Software Engineering Skills→
team-telnyxteam-telnyx
3

telnyx-oauth-ruby

Implement OAuth 2.0 authentication flows with the Telnyx API in Ruby.

Official
Intermediate
hmzainjamilhmzainjamil
1

Amazon Seller

Automate Amazon seller operations for listings, inventory, pricing, orders, advertising, and reporting.

Community
Advanced
w9uk5ie8vw9uk5ie8v
17

linkfox-ebay-search

Search eBay product listings across regional marketplaces via the LinkFox tool gateway API.

Community
Intermediate
ToniIAPro73ToniIAPro73

gravity-claw-whale-workbench

Generate and persist reusable multi-channel artifacts in a seller-centric operational workbench.

Community
Advanced