نیا · v1.0 · اوپن سورس

AI ایجنٹس کے لیے بنایا گیا ڈومین CLI اور MCP سرور

dna، Domain Name API کا آفیشل کمانڈ لائن ٹول اور MCP سرور ہے۔ کوئی تیار پرامپٹ کاپی کر کے Claude یا ChatGPT میں پیسٹ کریں، اور آپ کا اسسٹنٹ اسے انسٹال کرے گا، جوڑے گا اور آپ کے ڈومینز، DNS، SSL اور ہوسٹنگ پر کام شروع کر دے گا۔ جس کام پر پیسے لگیں، وہ آپ کی ہاں کا انتظار کرتا ہے۔

Claude Code میں dna سیٹ اپ کریں

میرے لیے dna CLI سیٹ اپ کرو (https://github.com/domainreseller/cli)۔
1. اسے میرے آپریٹنگ سسٹم کے آفیشل انسٹال اسکرپٹ سے انسٹال کرو، پھر ‎`dna version`‎ اور ‎`dna doctor`‎ چلاؤ۔
2. ‎`dna agent skill --install`‎ سے Claude Code اسکل انسٹال کرو اور ‎`claude mcp add dna -- dna mcp serve --env ote`‎ سے MCP سرور شامل کرو۔
3. مجھ سے یہ مت کہنا کہ میں اپنی API کلید اس چیٹ میں پیسٹ کروں۔ مجھ سے کہو کہ میں ‎`dna auth login --env ote`‎ خود چلاؤں، پھر ‎`dna --ote account get`‎ سے کنکشن چیک کرو۔
صرف OTE ٹیسٹ ماحول میں کام کرو اور میری منظوری کے بغیر کبھی ‎`--yes`‎ استعمال نہ کرنا۔

کوئی پرامپٹ کاپی کریں، اسے اپنے AI اسسٹنٹ میں پیسٹ کریں اور باقی کام اس پر چھوڑ دیں۔ ہر پرامپٹ OTE ٹیسٹ ماحول میں شروع ہوتا ہے اور کسی بھی قابلِ ادائیگی کام سے پہلے آپ کی منظوری کے لیے رک جاتا ہے۔

  • 64API آپریشنز
  • 65MCP ٹولز
  • 4سیفٹی کلاسز
  • 6پلیٹ فارمز، ایک بائنری
  • Apache-2.0اوپن سورس لائسنس
سیدھے الفاظ میں

Claude اور ChatGPT کے لیے تیار پرامپٹس

ڈومین نام بدلیں، پرامپٹ اپنے اسسٹنٹ میں پیسٹ کریں اور اسے کام کرتے دیکھیں۔ ہر پرامپٹ بتاتا ہے کہ کہاں رکنا ہے، اس لیے آپ کے بغیر کوئی قابلِ ادائیگی کام نہیں ہوتا۔

ڈومین تلاش اور رجسٹر کریں

dna سے چیک کرو کہ brandname.com، brandname.net اور brandname.io دستیاب ہیں یا نہیں۔ نتائج قیمتوں کے ساتھ ایک ٹیبل میں دکھاؤ، پھر سب سے سستے دستیاب ڈومین کی رجسٹریشن کا ‎`--dry-run`‎ سے پری ویو کرو۔ جب تک میں ہاں نہ کہوں، کچھ بھی رجسٹر نہ کرنا۔
domain bulk-search · domain registerbillable

آنے والی تجدیدات

dna سے میرے وہ ڈومینز لسٹ کرو جو اگلے 60 دنوں میں ختم ہو رہے ہیں، ساتھ میں ان کی تجدید کی قیمتیں دکھاؤ اور انہیں ختم ہونے کی تاریخ کے حساب سے ترتیب دو۔ کسی چیز کی تجدید نہ کرنا۔
domain list · domain renew-checkread

ڈومین کو سرور پر پوائنٹ کریں

dna سے example.com کو 203.0.113.10 پر پوائنٹ کرو: ‎`@`‎ اور ‎`www`‎ کے لیے A ریکارڈز شامل کرو، پھر مجھے آخری DNS زون دکھاؤ۔ کسی موجودہ ریکارڈ کو بدلنے یا حذف کرنے سے پہلے مجھ سے پوچھنا۔
dns add · dns listwrite

ڈومین اپنے اکاؤنٹ میں ٹرانسفر کریں

dna سے چیک کرو کہ کیا example.org میرے اکاؤنٹ میں ٹرانسفر ہو سکتا ہے، مجھے بتاؤ کہ ابھی مجھے کیا چاہیے (auth کوڈ، ان لاک کرنا) اور ‎`--dry-run`‎ سے ٹرانسفر کا پری ویو کرو۔
domain transfer-check · domain transferbillable

SSL سرٹیفکیٹ آرڈر کریں

dna سے example.com کے لیے سب سے سستا DV SSL سرٹیفکیٹ تلاش کرو، ایک CSR بناؤ اور آرڈر کا پری ویو کرو۔ خریدنے سے پہلے میری منظوری کا انتظار کرنا۔
product ssls · ssl generate-csr · ssl initializebillable

بتائیں آپ کو کیا چاہیے۔ صحیح کمانڈ آپ کا ایجنٹ ڈھونڈ لے گا۔

ہر API آپریشن ایک ٹول ہے جس کی واضح تفصیل اور JSON اسکیما موجود ہے، اس لیے اسسٹنٹ پہلی ہی بار صحیح کال چنتا ہے اور اسے درست بھرتا ہے۔ آپ بات کریں، اصل کام dna ٹھیک ٹھیک کر دیتا ہے۔

سیفٹی گیٹ

آپ کا ایجنٹ آپ کے بغیر ایک پیسہ بھی خرچ نہیں کر سکتا

ہر کمانڈ کی ایک سیفٹی کلاس ہوتی ہے، اور یہی کلاس طے کرتی ہے کہ کیا ہوگا۔ صرف دیکھنے والے کام اور مفت، قابلِ واپسی تبدیلیاں فوراً چلتی ہیں۔ جو کام آپ کے بیلنس سے رقم کاٹے یا واپس نہ ہو سکے، وہ رک کر پہلے آپ سے پوچھتا ہے۔

  • read

    پڑھنا

    سرچ، لسٹنگ، ڈومین کی معلومات، قیمتیں اور TLD کے قواعد۔

    فوراً چلتا ہے
  • write

    لکھنا

    DNS ریکارڈز، ٹرانسفر لاک، WHOIS پرائیویسی اور رابطے۔ مفت اور قابلِ واپسی۔

    فوراً چلتا ہے
  • destructive

    تباہ کن

    ریکارڈ حذف کرنا، SSL منسوخ کرنا، DNSSEC بند کرنا۔

    آپ کی ہاں کا انتظار کرتا ہے
  • billable

    قابلِ ادائیگی

    رجسٹریشن، تجدید، ٹرانسفر، بحالی، SSL اور ہوسٹنگ کے آرڈرز۔

    آپ کی ہاں کا انتظار کرتا ہے

ہاں کیسے کام کرتی ہے

گیٹڈ ٹولز ایک اضافی confirm فیلڈ لیتے ہیں۔ زیادہ تر MCP کلائنٹس بھی ہر ٹول کال سے پہلے آپ سے پوچھتے ہیں؛ سیفٹی اینوٹیشنز انہیں خطرناک کالز نمایاں کرنے میں مدد دیتی ہیں۔

  1. ایجنٹ پہلے پوچھتا ہے

    وہ ٹول کو confirm کے بغیر کال کرتا ہے۔ کچھ نہیں بھیجا جاتا۔ اسے بالکل اسی ریکوئسٹ کا پری ویو واپس ملتا ہے۔

  2. فیصلہ آپ کا

    ایجنٹ آپ کو ڈومین، مدت اور آپریشن دکھاتا ہے۔ آپ ہاں یا نہ کہتے ہیں۔

  3. یہ ایک ہی بار چلتا ہے

    آپ کی ہاں کے بعد ہی وہ کال کو confirm=true کے ساتھ دہراتا ہے۔ نیٹ ورک کی خرابی کے بعد کوئی قابلِ ادائیگی کال کبھی دوبارہ نہیں بھیجی جاتی۔

طے کریں کہ اس کی پہنچ کہاں تک ہو

--env ote
ٹیسٹ ماحول: اصلی API، اصلی پیسہ نہیں
--read-only
دیکھیں، چھوئیں نہیں۔ ہر تبدیلی بلاک ہے۔
--no-billable
خریداری کے سوا سب کچھ
--groups domain,dns
صرف وہ کمانڈ گروپس جو آپ بتائیں
--dry-run
API کلید چھپا کر بالکل وہی HTTP ریکوئسٹ پرنٹ کرتا ہے
آغاز

پرامپٹ سے پہلے ڈومین تک چار مراحل، سب کچھ ٹیسٹ ماحول میں

OTE ہمارا ٹیسٹ ماحول ہے: وہی API، اپنی الگ API کلید اور اپنے الگ بیلنس کے ساتھ۔ وہاں مشق کریں، پھر ایک فلیگ سے پروڈکشن پر چلے جائیں۔

  1. ایک پرامپٹ کاپی کریں

    اس صفحے کے اوپر Claude Code، ChatGPT Codex یا سادہ چیٹ منتخب کریں اور پرامپٹ کاپی کریں۔

  2. اسے اپنے اسسٹنٹ میں پیسٹ کریں

    وہ dna انسٹال کرتا ہے، MCP سرور شامل کرتا ہے اور سیٹ اپ چیک کرنے کے لیے dna doctor چلاتا ہے۔

    dna doctor
  3. OTE میں خود لاگ اِن کریں

    لاگ اِن کمانڈ اپنے ٹرمینل میں چلائیں اور اپنا Reseller ID اور OTE API کلید وہیں درج کریں، چیٹ میں کبھی نہیں۔

    dna auth login --env ote
  4. سیدھے الفاظ میں کہیں

    سرچ کریں، --dry-run سے پری ویو کریں، رجسٹر کریں۔ جو کام ٹیسٹ بیلنس سے رقم کاٹے، وہ آپ کی ہاں کا انتظار کرتا ہے۔

    --dry-run
مینوئل سیٹ اپ

ٹرمینل پسند ہے؟ دو کمانڈز اور آپ جڑ گئے

بائنری انسٹال کریں، پھر dna mcp serve کو اپنے MCP کلائنٹ میں شامل کریں۔ ہر API آپریشن Claude Code، Claude Desktop، Cursor، VS Code، Windsurf، Codex CLI یا Gemini CLI کے لیے ایک ٹول بن جاتا ہے۔

$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | sh

ایک ہی بائنری، بغیر کسی ڈیپنڈنسی کے۔ ہر ریلیز SHA-256 چیک سمز کے ساتھ آتی ہے۔

  • ہر API آپریشن کے لیے ایک ٹول، اور ہر ایک کا JSON اسکیما API اسپیک سے بنا ہوا
  • کسی بھی چیز کو چھونے سے پہلے dna_context ماڈل کو بتاتا ہے کہ وہ پروڈکشن پر ہے یا ٹیسٹ ماحول میں
  • صرف ضرورت کی چیزیں --groups یا --read-only کے ذریعے کھولیں۔ چھوٹی ٹول لسٹ سے کانٹیکسٹ ٹوکنز کی بھی بچت ہوتی ہے۔
  • جن ایجنٹس کے پاس صرف شیل ہے، انہیں ایک ہی کال میں Claude Code اسکل اور استعمال کی گائیڈ مل جاتی ہے
# پہلے ٹیسٹ ماحول سے جڑیں
$ claude mcp add dna -- dna mcp serve --env ote

# صرف پڑھنے کے لیے، .mcp.json کے ذریعے آپ کی ٹیم کے ساتھ شیئر
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

ہر کلائنٹ کا تیار اسنیپٹ پرنٹ کرنے کے لیے dna mcp config چلائیں۔

کوریج

تمام 64 API آپریشنز، اسی طرح گروپ کیے گئے جیسے آپ سوچتے ہیں

جو کچھ ریسلر API کر سکتی ہے، وہ dna بھی کر سکتا ہے۔ ہر کمانڈ کا --help اس کی سیفٹی کلاس، API روٹ اور مثالیں دکھاتا ہے۔

  • dna domain

    سنگل اور بلک سرچ، رجسٹریشن، تجدید، ٹرانسفر اور بحالی۔ ٹرانسفر لاک، WHOIS پرائیویسی، auth کوڈ، نیم سرورز، چائلڈ ہوسٹس اور فارورڈنگ۔

  • dna dns · dna dnssec

    پلیٹ فارم کے نیم سرورز پر زون ریکارڈز، اور رجسٹری میں DS ریکارڈز۔

  • dna ssl

    CSR بنانا، خریدنا، کنفیگر کرنا، اسٹیٹس چیک کرنا، ڈاؤن لوڈ کرنا، دوبارہ جاری کرنا اور سرٹیفکیٹس منسوخ کرنا۔

  • dna hosting

    ہوسٹنگ پلانز اور پیکجز، نئے آرڈرز اور ان کا اسٹیٹس۔

  • dna contact

    دوبارہ استعمال ہونے والے رابطے اور ان کی ای میل اور فون کی تصدیق۔

  • dna account · product · order

    بیلنس اور ٹرانزیکشنز، قیمتوں کے ساتھ TLD کیٹلاگ، اور آرڈر اسٹیٹس۔

  • dna api

    کسی بھی اینڈ پوائنٹ پر توثیق شدہ خام ریکوئسٹ، انہی سیفٹی اصولوں کے ساتھ۔

  • dna schema · enums · agent

    ہر آپریشن، ان پٹ اور کوڈڈ ویلیو کی مشین سے پڑھی جانے والی تفصیل، ایجنٹس اور ٹول بنانے والوں کے لیے۔

مکمل کمانڈ ریفرنس دیکھیں

اسکرپٹس اور CI

پائپس، کرون جابز اور پائپ لائنز کے لیے تیار

ٹرمینل میں آپ کو پڑھنے میں آسان ٹیبلز ملتے ہیں، پائپ میں JSON۔ ایررز بھی JSON میں آتے ہیں، ایسے ایگزٹ کوڈز کے ساتھ جن کا مطلب کبھی نہیں بدلتا، اس لیے اسکرپٹ کو ہمیشہ پتا ہوتا ہے کہ کیا غلط ہوا۔

  • پائپ میں JSON، اسٹریمز کے لیے JSON Lines اور آؤٹ پٹ مختصر رکھنے کے لیے بلٹ اِن --jq
  • CI میں API معلومات DNA_RESELLER_ID اور DNA_API_KEY سے، اپنی مشین پر ایک پروفائل سے
  • ٹرمینل سے باہر کوئی چھپا ہوا سوال نہیں: گیٹڈ کمانڈ کوڈ 9 کے ساتھ ایگزٹ کرتی ہے اور کچھ نہیں بھیجتی
  • کچھ بھی بھیجنے سے پہلے ان پٹس چیک کیے جاتے ہیں، اور ریٹ لمٹ پر رکی ہوئی ریکوئسٹس خود بخود دوبارہ بھیجی جاتی ہیں
# اگلے 30 دنوں میں ختم ہونے والے ڈومینز، CSV میں
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# ایک ساتھ کئی ناموں کی جانچ
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# اسکرپٹ میں --yes کے بغیر خریداری یہیں رک جاتی ہے
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
ایگزٹ کوڈز
0کامیاب6ریٹ لمٹ
2غلط ان پٹ، کچھ نہیں بھیجا گیا7سرور ایرر
3توثیق8نیٹ ورک
4نہیں ملا9تصدیق درکار ہے
5API نے مسترد کر دیا10صرف پڑھنے کا موڈ
ٹول کا انتخاب

CLI، SDK، REST API یا تیار ماڈیول؟

یہ سب ایک ہی ریسلر API سے انہی API معلومات کے ساتھ بات کرتے ہیں۔ وہ چنیں جو اس جگہ کے مطابق ہو جہاں کام ہوتا ہے۔

عمومی سوالات

ایجنٹ جوڑنے سے پہلے لوگ کیا پوچھتے ہیں

مختصر اور سیدھے جوابات۔ GitHub پر موجود README میں ہر تفصیل موجود ہے۔

مکمل دستاویزات پڑھیں
Domain Name API CLI کیا ہے؟

dna، Domain Name API ریسلر پلیٹ فارم کا آفیشل کمانڈ لائن کلائنٹ اور MCP سرور ہے۔ یہ ریسلر REST API کے تمام 64 آپریشنز کا احاطہ کرتا ہے، ڈومین سرچ، رجسٹریشن، تجدید اور ٹرانسفر سے لے کر DNS، DNSSEC، رابطوں، SSL اور ہوسٹنگ تک، اور یہ سب macOS، Linux اور Windows کے لیے Apache-2.0 لائسنس کے تحت ایک ہی اوپن سورس بائنری میں۔

کیا AI ایجنٹ سے ڈومین رجسٹر کروانا محفوظ ہے؟

جی ہاں، کیونکہ ایجنٹ خود سے کچھ نہیں خرید سکتا۔ قابلِ ادائیگی اور تباہ کن آپریشنز چلنے کے بجائے پری ویو واپس کرتے ہیں۔ یہ صرف آپ کی منظوری کے بعد چلتے ہیں جب کال میں confirm=true ہو، یا CLI میں --yes۔ ایجنٹس کو OTE ٹیسٹ ماحول پر شروع کریں اور --read-only یا --no-billable سے ان کا دائرہ مزید محدود کریں۔

کیا میں پیسے خرچ کیے بغیر اسے آزما سکتا ہوں؟

جی ہاں۔ --env ote کے ساتھ dna ہمارے ٹیسٹ ماحول OTE سے بات کرتا ہے۔ اس کی اپنی API کلید اور اپنا بیلنس ہے، اور وہاں آپ جو کچھ بھی کریں وہ لائیو ڈومینز یا آپ کے اصل اکاؤنٹ کو نہیں چھوتا۔

کون سے AI اسسٹنٹس dna کے ساتھ کام کرتے ہیں؟

کوئی بھی MCP کلائنٹ: Claude Code، Claude Desktop، Cursor، VS Code، Windsurf، OpenAI Codex CLI، Gemini CLI اور دیگر۔ جن ایجنٹس کے پاس صرف شیل ہے وہ CLI کو براہِ راست کال کر سکتے ہیں؛ dna agent guide اور Claude Code اسکل انہیں اس کا طریقہ سکھاتے ہیں۔

کیا مجھے Domain Name API اکاؤنٹ کی ضرورت ہے؟

جی ہاں۔ dna ایک ریسلر اکاؤنٹ اور اس کی API معلومات کے ساتھ کام کرتا ہے: آپ کا Reseller ID اور ایک API کلید، دونوں ریسلر پینل میں API سیٹنگز کے تحت۔ پروڈکشن اور OTE کی کلیدیں الگ ہیں، اور آپ کے پینل کا ای میل اور پاس ورڈ یہاں کام نہیں کرے گا۔

کیا dna مفت ہے؟

جی ہاں۔ یہ ٹول مفت ہے اور Apache-2.0 لائسنس کے تحت اوپن سورس ہے۔ آپ صرف اس کے ذریعے خریدی گئی چیزوں، جیسے ڈومینز، تجدید، SSL اور ہوسٹنگ، کی ادائیگی اپنی ریسلر قیمتوں پر اور اپنے اکاؤنٹ بیلنس سے کرتے ہیں۔

میری API معلومات کہاں محفوظ ہوتی ہیں؟

dna auth login انہیں آپ کے یوزر کنفیگ فولڈر میں ایک پروفائل فائل میں محفوظ کرتا ہے، جسے Linux اور macOS پر صرف آپ پڑھ سکتے ہیں؛ dna config path بتاتا ہے کہ وہ کہاں ہے۔ انوائرنمنٹ ویری ایبلز کو ہمیشہ ترجیح ملتی ہے، اور API کلید ہر آؤٹ پٹ میں چھپی رہتی ہے، --dry-run سمیت۔

کیا میں dna کو اسکرپٹس اور CI میں استعمال کر سکتا ہوں؟

جی ہاں۔ پائپ میں آؤٹ پٹ JSON ہوتا ہے، ایررز مستقل ایگزٹ کوڈز کے ساتھ JSON میں آتے ہیں، اور انٹرایکٹو ٹرمینل کے باہر کوئی سوال نہیں پوچھا جاتا۔ API معلومات DNA_RESELLER_ID اور DNA_API_KEY کے طور پر دیں۔ --yes کے بغیر کوئی قابلِ ادائیگی کمانڈ کوڈ 9 کے ساتھ ایگزٹ کرتی ہے اور کچھ نہیں بھیجتی۔

مجھے CLI استعمال کرنا چاہیے یا SDK؟

جب کام کوئی شخص، اسکرپٹ یا AI ایجنٹ کرے تو dna استعمال کریں۔ جب آپ ڈومین فیچرز اپنی ایپلیکیشن میں شامل کریں تو PHP، Node.js، Python، Ruby یا Go کا SDK، یا براہِ راست REST API استعمال کریں۔ یہ سب ایک ہی API اور ایک ہی API معلومات استعمال کرتے ہیں۔

کیا مجھے ٹرمینل استعمال کرنا ہی ہوگا؟

جی نہیں۔ کوئی تیار پرامپٹ Claude Code میں، جو Claude ڈیسک ٹاپ ایپ میں بھی چلتا ہے، یا ChatGPT Codex میں پیسٹ کریں، اور اسسٹنٹ آپ کے لیے dna انسٹال کر کے جوڑ دے گا۔ صرف ایک کمانڈ آپ خود ٹائپ کرتے ہیں، dna auth login، اس لیے آپ کی API کلید کبھی چیٹ میں نہیں جاتی۔ اگر آپ کے پاس ٹرمینل بالکل نہیں ہے تو چیٹ والا پرامپٹ آپ کو ہر قدم سمجھاتا ہے۔