Filimo and Namava

---

面向 AI Agent

• 简介： 面向 filimo.com 和 namava.ir 的非官方 MCP 服务（模型上下文协议）。这两家是伊朗主要的视频点播服务：可搜索标题、查询“哪个服务有这个标题”、查看标题详情、剧集的季和集、演员和导演的作品目录、相似标题、精选列表、新片、首页精选、浏览类型以及 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，或以逗号分隔的列表）；系统代理设置将被忽略。
• 访问权限： 只读目录数据。它无法登录、播放视频、提供流媒体链接或更改任何内容，因此调用任何工具前都无需确认。
• 工具： 共 13 个，名称均以 vod_ 开头。典型调用序列：vod_search -> vod_title -> vod_episodes / vod_related / vod_person；查询单个标题用 vod_where；vod_browse -> vod_title；vod_collections -> vod_collection。
• 适用场景： 用户询问某部电影或剧集是否在 Filimo 或 Namava 上架、内容简介、演员、评分或年龄分级、季数或集数、新片或热门内容，或者某个类型有哪些可看的内容。
• 不适用场景： 用户想要观看、下载或获取流媒体链接，或需要 Filimo 的价格（只有 Namava 套餐提供公开 JSON 数据）。
• 输出： 精简的 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	查询哪个服务收录了某个标题（每个网站提供精确匹配和相似匹配）
vod_title	查询某个标题的剧情简介、类型、年份、评分、年龄分级、国家、演员和导演
vod_episodes	查询剧集的季，以及某一季的剧集（简介、时长、日期）
vod_new	查询各服务最新上线的标题，可以按电影或剧集筛选
vod_featured	查询各服务首页推荐内容：Filimo 的栏目（热门、票房、类型）以及 Namava 的主推轮播和热门榜单
vod_browse	查询某一类型的标题；Filimo 还支持排序（评分、IMDb、年份、最新添加）和按国家筛选
vod_genres	查询类型名称、别名、排序和国家值
vod_person	查询演员或导演的简介，以及他们在 Filimo 和 Namava 上参演的标题
vod_related	查询与某个标题相似的标题；Filimo 还会列出主推演员和编剧
vod_collections	查询可打开的精选列表：IMDb 250 部高分电影、电影节获奖作品、儿童、奥斯卡、真实故事、即将上线
vod_collection	查询某个精选列表中的标题（Filimo 支持排序和按国家筛选，可翻页浏览约 200 个标题）
vod_plans	查询 Namava 订阅方案和价格（Filimo 的价格不在其 JSON API 中）

示例提示词：

• “伊朗电影《伊朗晚餐》（شام ایرانی）在 Filimo 还是 Namava 上？有多少季？”
• “Filimo 上评分最高的伊朗喜剧剧集。”
• “本周 Namava 有什么新内容？”
• “Parsa Pirouzfar 在 Filimo 上参演过哪些作品？” / “Namava 有什么即将上线的内容？”
• 《悲惨世界》在 Namava 上吗？导演是谁？
• Filimo 上评分最高的伊朗剧集有哪些？

常见问题

可以播放或下载视频吗？ 不可以。它只会列出并介绍标题，不会获取流媒体或下载 URL。

为什么我看到的国外标题比较少？ 两个服务都会对非伊朗 IP 地址隐藏获得授权的外国作品。

为什么 Filimo 的剧集只显示几位演员？ Filimo 没有演员列表。电影的演员姓名来自其 剧情简介；剧集的演员则是 Filimo 在剧集页面上主推的演员（通常为两到三位）。

它与 Filimo 或 Namava 有关联吗？ 没有关联。它会以适当的频率读取网站使用的相同公开 JSON，并采用短时缓存。

فارسی

许可证

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