Filimo and Namava

---

AI エージェント向け

• 概要： filimo.com と namava.ir 向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。イランの大手ビデオ・オン・デマンドサービス 2 社に対応し、作品検索、「この作品を配信しているサービス」の確認、作品の詳細、シリーズのシーズンやエピソード、俳優や監督の出演作、類似作品、厳選リスト、新作、トップページのおすすめ、ジャンルの閲覧、Namava のプランを利用できます。
• インストール： uvx iran-vod-mcp または claude mcp add iran-vod -- uvx iran-vod-mcp。トランスポート：stdio。uv（Python 3.10 以上）が必要です。
• 認証： 不要です。IRAN_VOD_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意で設定できます。システムのプロキシ設定は無視されます。
• アクセス： カタログデータは読み取り専用です。ログイン、動画の再生、ストリームリンクの提供、データの変更はできないため、ツールの呼び出し前に確認は必要ありません。
• ツール： すべて vod_ で始まる 13 個です。一般的な呼び出し順序：vod_search -> vod_title -> vod_episodes / vod_related / vod_person；1 作品を調べる場合は vod_where；vod_browse -> vod_title；vod_collections -> vod_collection。
• 用途： ユーザーが、映画やシリーズが Filimo または Namava で視聴できるか、内容、出演者、評価、年齢レーティング、シーズン数やエピソード数、新作や人気作品、ジャンル別のおすすめ作品について尋ねた場合に使用します。
• 使用しない場合： ユーザーが視聴、ダウンロード、ストリームリンクの取得を希望する場合、または Filimo の料金を知りたい場合（公開 JSON で確認できるのは Namava のプランのみ）。
• 出力： コンパクトな JSON です。年はサイトの表示どおりペルシャ暦です（海外作品はグレゴリオ暦の年が表示されます）。評価の形式はサービスによって異なり、Filimo は 5 点満点の星評価と投票数、IMDb の評価を表示し、Namava は「いいね」と「よくないね」の数を表示します。テキストはサイト上のペルシャ語コンテンツです。
• 機械可読形式： server.json。

クイックスタート

claude mcp add iran-vod -- uvx iran-vod-mcp

または、任意の MCP クライアントの設定に追加します：

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

両サイトはイランから直接アクセスできます。海外作品（ライセンス取得済み作品）は、イランの IP アドレスにのみ表示されます。国外からアクセスすると、 イラン作品のカタログのみが表示されます。プロキシが必要な場合は、IRAN_VOD_MCP_PROXY=http://host:port を設定してください。

ツール

ツール	機能
vod_search	タイトルでFilimo、Namava、または両方を検索します。映画とシリーズがそれぞれ ref 付きで表示されます
vod_where	2つのサービスのうち、どちらでタイトルを視聴できるかを調べます（各サービスでの完全一致および類似タイトル）
vod_title	1つのタイトルのあらすじ、ジャンル、公開年、評価、年齢制限、制作国、キャスト、監督を表示します
vod_episodes	シリーズのシーズンと、1シーズン分のエピソードを表示します（あらすじ、長さ、日付）
vod_new	各サービスの最新タイトルを、映画またはシリーズ別に表示します
vod_featured	各サービスのトップページで紹介されている内容を表示します。Filimoでは一覧（人気、興行収入、ジャンル）、Namavaではヒーロースライダーとトップリストを表示します
vod_browse	1つのジャンルのタイトルを表示します。Filimoでは並べ替え（評価、IMDb、公開年、追加日）と制作国による絞り込みもできます
vod_genres	ジャンル名、別名、並べ替え、制作国の値を表示します
vod_person	俳優または監督のプロフィールと、FilimoおよびNamavaで出演しているタイトルを表示します
vod_related	1つのタイトルに似たタイトルを表示します。Filimoでは、注目の俳優と脚本家も表示します
vod_collections	開ける厳選リストを表示します。IMDbトップ250、映画祭受賞作、キッズ、オスカー、実話、近日公開などがあります
vod_collection	1つの厳選リストのタイトルを表示します（Filimoでは並べ替えと制作国による絞り込みができ、約200タイトルまでページ表示できます）
vod_plans	Namavaのサブスクリプションプランと料金を表示します（Filimoの料金はJSON APIに含まれていません）

プロンプトの例：

• 「Iranian Dinner（شام ایرانی）はFilimoとNamavaのどちらで視聴できますか？シーズンはいくつありますか？」
• 「Filimoで評価が最も高いイランのコメディシリーズ。」
• 「今週、Namavaで新作は何ですか？」
• 「Parsa PirouzfarはFilimoでどの作品に出演していますか？」／「Namavaで近日公開の作品は何ですか？」
• فیلم بینوایان در نماوا هست؟ کارگردانش کیست؟
• سریال‌های ایرانی با بیشترین امتیاز در فیلیمو کدامند؟

よくある質問

動画を再生したりダウンロードしたりできますか？ いいえ。タイトルの一覧表示と説明のみで、ストリーミングURLやダウンロードURLは取得しません。

海外のタイトルが少なく表示されるのはなぜですか？ どちらのサービスも、イラン国外のIPアドレスからはライセンスを取得した海外作品を非表示にしています。

Filimoのシリーズで表示される俳優が数人だけなのはなぜですか？ Filimoにはキャスト一覧がありません。映画では作品の説明文から名前を取得し、シリーズではFilimoがシリーズページで紹介している俳優（通常は2、3人）を表示します。

FilimoまたはNamavaと提携していますか？ いいえ。ウェブサイトで使用されているものと同じ公開JSONを、短いキャッシュを使い、負荷に配慮した頻度で読み取ります。

فارسی

ライセンス

MIT。作者：Sepehr Radmard（سپهر رادمرد）、github.com/sepehr071、linkedin.com/in/sepehr-radmard。