api ورزش۳ رایگان است؟

سرور ورزش۳ بازارچه (MIT) بدون کلید کار میکند و پلن رایگان بازارچه ماهانه ۵۰ اجرای موفق میدهد. این سرور غیررسمی است و از خود سایت ورزش۳ میخواند، پس شرایط استفادهٔ ورزش۳ را خودتان رعایت کنید.

api دیجیکالا رسمی است؟

نه. سرور دیجیکالا در بازارچه با API غیررسمی کار میکند و سازندهاش خود دیجیکالا نیست. اگر ساختار سایت عوض شود، ممکن است یک قابلیت موقتاً خطا بدهد.

برای صدا زدن این API چه چیزی لازم است؟

یک حساب بازارچه و یک کلید API از تب «دسترسی» داشبورد. کلید را در هدر Authorization با پیشوند Bearer میفرستید. توکن MCP هم همین کار را میکند.

اگر سهمیه یا سقف دقیقهای تمام شود چه میشود؟

پاسخ با کد ۴۲۹ برمیگردد و فیلد retryAfter میگوید چند ثانیه بعد دوباره بفرستید. فقط اجراهای موفق از سهمیهٔ طرح کم میشوند؛ جستجوی ابزار و اجراهای ناموفق شمرده نمیشوند.

میشود چند درخواست را با هم فرستاد؟

بله. بهجای server و tool، آرایهٔ calls را بدهید، حداکثر ۱۰ اجرا در یک درخواست. هر اجرا جدا از سهمیه کم میشود.

api نشان یا ترب را هم همینطور میشود صدا زد؟

ترب (نسخهٔ کامل) از روتر اجرا میشود و همینطور صدا زده میشود. نشان رسمی به کلید API خود نشان نیاز دارد که آن را در داشبورد برای سرور میگذارید. نشان بدون کلید فعلاً فقط روی کامپیوتر خودتان نصب میشود و از این مسیر در دسترس نیست.

API سایت‌های ایرانی: دیجی‌کالا، دیوار و ورزش۳ با یک کلید

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

API سایت‌های ایرانی چطور کار می‌کند؟

روتر MCP بازارچه سرورهای ابزار را اجرا می‌کند و دو آدرس REST دارد. GET /api/v1/tools ابزارها را جستجو می‌کند و JSON برمی‌گرداند. POST /api/v1/call یک ابزار را اجرا می‌کند. هر دو کلید API شما را در هدر Authorization: Bearer می‌خواهند. کلید را در داشبورد، تب «دسترسی» می‌سازید و فقط با کلیک خودتان ساخته می‌شود.

اول جستجو می‌کنید و server و tool را از جواب برمی‌دارید:

curl "https://mcpfarsi.ir/api/v1/tools?q=ورزش&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

بعد همان‌ها را اجرا می‌کنید. پاسخ شکل { "isError": false, "content": [...] } دارد و خطای سرویس مقصد هم با isError: true می‌آید، نه با کد HTTP عجیب:

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "iran-toolkit", "tool": "convert_date", "arguments": {"date": "1403/01/01", "from": "jalali"}}'

برای چند اجرای هم‌زمان به‌جای این سه فیلد، آرایهٔ {"calls": [...]} بفرستید، تا ۱۰ مورد.

کدام سرویس‌ها را می‌شود صدا زد؟

جدول زیر چند سرویس پرجستجو را نشان می‌دهد. ستون «سرور» همان مقدار server در درخواست است و صفحهٔ هر ابزار بخشی با نمونهٔ درخواست دارد. فهرست کامل را در همهٔ ابزارها ببینید.

سرویس	server	نمونه قابلیت (tool)
ورزش۳	`varzesh3`	`v3_scores`، `v3_standings`
دیجی‌کالا	`digikala`	`dk_search`، `dk_price_history`
دیوار	`divar`	`search_posts`، `get_post`
ترب	`torob-mcp`	`tb_cheapest`، `tb_price_chart`
تقویم تایم	`time-ir`	`ti_today`، `ti_upcoming_holidays`
نقشه نشان (رسمی)	`neshan`	`direction`، `geocode`

نام آرگومان‌های هر قابلیت را از خروجی /api/v1/tools بگیرید. مثال‌های زیر فقط آرگومان‌هایی را دارند که مطمئنیم.

API ورزش۳ برای نتایج زنده

اگر دنبال «api ورزش ۳» هستید، قابلیت v3_scores نتیجه و برنامهٔ بازی‌های یک روز را در همهٔ لیگ‌ها می‌دهد (از دو روز قبل تا دو روز بعد) و می‌شود آن را به لیگ، تیم یا فقط بازی‌های زنده محدود کرد. v3_standings جدول لیگ و v3_top_players گلزنان را می‌دهد. سرور ورزش۳ کلید نمی‌خواهد.

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "varzesh3", "tool": "v3_scores"}'

API دیجی‌کالا برای قیمت و تاریخچهٔ قیمت

سرور دیجی‌کالا ۲۳ قابلیت دارد، از جستجوی کالا (dk_search) تا تاریخچهٔ قیمت حدود ۳۰ روز گذشته (dk_price_history) و مقایسهٔ ۲ تا ۴ کالا (dk_compare). برای ارزان‌ترین کالای واقعاً مطابق جستجو dk_find_cheapest را صدا بزنید. ترب هم همین‌طور است و tb_cheapest ارزان‌ترین پیشنهاد قابل اعتماد را برمی‌گرداند.

curl "https://mcpfarsi.ir/api/v1/tools?q=دیجی‌کالا قیمت&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

API دیوار برای جستجوی آگهی

search_posts یک عبارت و یک شهر می‌گیرد و آگهی‌ها را برمی‌گرداند. بدون شهر، تهران جستجو می‌شود. با get_post و شناسهٔ آگهی، توضیحات و ویژگی‌هایش را هم می‌خوانید.

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @divar.json

{"server": "divar", "tool": "search_posts", "arguments": {"query": "پژو ۲۰۶", "city": "tehran"}}

متن فارسی را از فایل UTF-8 بفرستید. در Git Bash ویندوز فارسی در آرگومان خط فرمان خراب می‌شود.

API نشان و time.ir

نشان رسمی مسیریابی، جستجوی نشانی و ماتریس فاصله دارد (direction، geocode، distance_matrix) و به کلید API خود نشان نیاز دارد. راهنمای کلید نشان را ببینید. در مقابل، تقویم تایم کلید نمی‌خواهد: ti_today تاریخ امروز را به شمسی، میلادی و قمری می‌دهد و ti_upcoming_holidays تعطیلات رسمی پیش رو را.

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "time-ir", "tool": "ti_upcoming_holidays"}'

این APIها رسمی‌اند؟ سقف و شرایط استفاده

بیشتر این سرورها غیررسمی‌اند (در کاتالوگ با برچسب «اتصال با API غیررسمی» می‌بینید): از همان صفحه‌ها و رابط‌هایی می‌خوانند که خود سایت استفاده می‌کند. نشان تنها مورد رسمی جدول است. پس ساختار پاسخ ممکن است عوض شود و بازارچه زمان‌کار ۱۰۰ درصدی قول نمی‌دهد. شرایط استفادهٔ هر سایت و فشاری که به آن می‌آورید با خودتان است.

سهمیه به طرح شما بستگی دارد. فقط اجراهای موفق شمرده می‌شوند. هر طرح سقف اجرا در دورهٔ خودش و سقف در دقیقه دارد؛ اعداد را در صفحهٔ تعرفه‌ها ببینید. پلن رایگان ۵۰ اجرای موفق در ماه دارد و با رسیدن به سقف، پاسخ ۴۲۹ با retryAfter می‌گیرید.

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