Faradars Courses

AI エージェント向け

• 概要： faradars.org 向けの非公式 MCP サーバー（model context protocol）です。フィルター付きの講座・動画検索、講座詳細（価格、現在のセール、所要時間、評価、受講者数、講師、学習目標、シラバス）、受講者レビュー、カテゴリツリー、講師プロフィール、学習パス、関連講座と比較、割引キャンペーンとサブスクリプションプラン、ヘルプ回答、Faradars Magazine の記事検索と全文に対応します。
• インストール： uvx faradars-mcp または claude mcp add faradars -- uvx faradars-mcp を実行します。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。FARADARS_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りリスト）は任意で設定できます。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、購入、登録、コメントはできないため、ツールを呼び出す前の確認は不要です。
• ツール： 16 個あり、すべて fr_ がプレフィックスです。一般的な呼び出し順：fr_search_courses -> fr_course -> fr_course_reviews；fr_course -> fr_related_courses -> fr_compare_courses；fr_instructors -> fr_instructor；fr_learning_paths -> fr_learning_path；fr_articles -> fr_article。
• 使用する場合： ユーザーが、あるトピックに関する Faradars の講座、講座の料金、割引や修了証の有無、シラバス、講師、無料講座について尋ねる場合、または Faradars Magazine のチュートリアルを求める場合に使用します。
• 使用しない場合： ユーザーがレッスンの視聴、購入、または自身のアカウントの閲覧を希望する場合（対応していません）。
• 出力： コンパクトな JSON です。価格の単位はトマン、所要時間の単位は時間で、テキストはサイト上のペルシャ語です。
• 機械可読： server.json。

できること

• 講座や動画を検索： テキスト、カテゴリ、無料または有料、長さ、修了証、講師で絞り込み、売上、閲覧数、関連度、日付で並べ替え
• 講座を確認： 価格、実施中のセールと終了時刻、時間数、レッスン数、評価、受講者数、学習目標、前提条件、説明、シラバス全文
• 受講者レビューを読む： 一度に 10 件
• 閲覧： カテゴリツリー、講師、学習パス（مسیر یادگیری）
• マガジンを検索： チュートリアルや比較記事を blog.faradars.org から検索

プロンプトの例：

• 「Faradars で最も売れている Python 講座を探して、最初の講座のシラバスを見せてください。」
• 「Faradars にはどのような無料の Excel 講座がありますか？」
• 「この講師はほかにどの講座を教えていますか？」
• بهترین دوره‌های آموزش پایتون در فرادرس کدام‌اند و قیمتشان چند است؟
• دوره‌های رایگان اکسل با گواهینامه را پیدا کن.

クイックスタート

uv が必要です。API キーやアカウントは不要です。

claude mcp add faradars -- uvx faradars-mcp

{
  "mcpServers": {
    "faradars": { "command": "uvx", "args": ["faradars-mcp"] }
  }
}

{
  "servers": {
    "faradars": { "type": "stdio", "command": "uvx", "args": ["faradars-mcp"] }
  }
}

ツール

16個すべてのツールに readOnlyHint: true が注釈されています。

仕組み

  AI agent  ──MCP over stdio──▶  faradars-mcp  ──HTTPS──▶  faradars.org/api/client      courses, categories, instructors
                                                  └──────▶  blog.faradars.org/wp-json    magazine

リクエストは Faradars のウェブアプリと同様に送信されます（Chrome の TLS フィンガープリントとヘッダー）。同時に処理するリクエストは最大2件で、キャッシュ期間は5分です。プロキシ経由でルーティングするには、FARADARS_MCP_PROXY=http://host:port を設定します。

注意事項

• 非公式です。Faradars との提携や同社の承認を受けていません。ウェブサイトで誰でも閲覧できるものと同じ公開データを読み取ります。
• コースのコンテンツ（動画）は公開されず、カタログデータのみを取得します。
• Faradars のセールにより価格は変わります（sale_price は期間限定です）。

開発

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline
uv run python -m pytest -m live -q  # real faradars.org

فارسی

faradars-mcp は Faradars 向けの非公式な読み取り専用 MCP サーバーです。AI アシスタントを使って、コースの検索、価格や割引、シラバスの閲覧、受講者レビューの確認、講師や学習パスの検索、Faradars Magazine の閲覧ができます。API キーやアカウントは不要です。

インストール：claude mcp add faradars -- uvx faradars-mcp

ライセンス

MIT。Sepehr Radmard（سپهر رادمرد）が作成しました。