Varzesh3 Sports

---

面向 AI Agent

• 简介： 面向 varzesh3.com 的非官方 MCP（模型上下文协议）服务：跨联赛查询某日的比分、单场比赛详情（事件、阵容、裁判、体育场、集锦视频）、联赛积分榜（也包括分组和杯赛对阵表）、逐轮赛程和赛果、最佳射手及其他球员排名、球队页面（状态、阵容、转会）、球队赛果和下一场比赛、新闻（最新、阅读量最高、按球队或联赛筛选）、新闻正文、视频和搜索。
• 安装： uvx varzesh3-mcp 或 claude mcp add varzesh3 -- uvx varzesh3-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需身份验证、API 密钥或账号。可选设置 VARZESH3_MCP_PROXY（HTTP 代理 URL，或以逗号分隔的列表）；系统代理设置不会生效。
• 访问权限： 只读。它无法登录、评论、投票或关注，因此调用任何工具前都无需确认。
• 工具： 共 18 种，名称均以 v3_ 为前缀。常见调用顺序：v3_search（搜索名称）-> v3_team / v3_team_matches / v3_news；v3_scores -> v3_match；v3_league -> v3_standings / v3_top_players；v3_head_to_head；v3_team_players -> v3_player；v3_transfers。
• 适用场景： 用户询问今天或昨天的比分、某支球队最近的赛果或下一场比赛、伊朗职业联赛（或其他大型联赛）的积分榜、最佳射手、某支球队的球员、转会名单或最新的波斯语体育新闻时使用。
• 不适用场景： 用户需要单场比赛的控球率或射门统计（Varzesh3 不提供；球队赛季平均数据可通过 v3_league_stats 获取）、博彩赔率或球员职业生涯统计时不要使用。
• 输出： 精简 JSON。日期使用网站显示的波斯历（Jalali）日期，时间为德黑兰时间，比分格式为“主队-客队”。名称和新闻为波斯语。
• 机器可读信息： server.json。

功能

• 每日比分（昨天、今天、明天，以及前后各两天），涵盖所有联赛、足球、室内足球和 NBA，可按联赛、球队筛选，也可仅查看正在进行的比赛
• 比赛详情：进球及进球者和助攻者、牌、换人、按阵型线排列的首发阵容、替补席、教练、裁判、球场和集锦视频
• 联赛积分榜，含近期战绩、分组积分榜（世界杯、亚洲杯）和淘汰赛对阵表（Hazfi 杯），支持当前或往届赛季
• 赛程和赛果，可按轮次查看；还可查看球队的近期赛果或即将进行的比赛
• 球员排名：射手榜、助攻榜、零封榜、黄牌和红牌、出场时间、帽子戏法、平均评分
• 球队页面：近期战绩、按位置排列的阵容及号码和年龄、转入和转出球员
• 新闻、报道和视频：最新内容、最受阅读内容、按球队或联赛查看、报道全文、进球和集锦视频
• 搜索波斯语名称，获取其他工具所需的球队 ID
• 默认只读：无需登录，无法发布内容

示例提示词：

• “Perspolis 今天的比分是多少？”
• “显示波斯湾职业联赛的积分榜。”
• “英超射手榜前 5 名。”
• “Esteghlal 上一场比赛有哪些球员出场？谁进了球？”
• جدول لیگ برتر ایران چطوره؟
• آخرین اخبار استقلال را بگو.

快速开始

你需要安装 uv。无需 API 密钥或账户。

claude mcp add varzesh3 -- uvx varzesh3-mcp

Claude Desktop、Cursor、Windsurf 和 Gemini CLI 在 MCP 配置中使用同一代码块：

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

VS Code（.vscode/mcp.json）：{"servers": {"varzesh3": {"type": "stdio", "command": "uvx", "args": ["varzesh3-mcp"]}}}。 Codex CLI：codex mcp add varzesh3 -- uvx varzesh3-mcp。其他情况：运行 pip install varzesh3-mcp 并启动 varzesh3-mcp。

工具

团队 ID 来自 v3_search（或任何表格），联赛 ID 来自 v3_league，比赛 ID 来自 v3_scores、v3_league_matches 和 v3_team_matches。

工具	功能
v3_scores	获取一天内各联赛的实时比分、赛果和赛程，内容与 Varzesh3 实时比分页面所列一致
v3_match	获取一场比赛的信息：比分、状态、进球、红黄牌、点球、换人、阵容、裁判、体育场、比赛集锦视频和后续比赛
v3_league	列出足球联赛及其 ID，或获取一个联赛当前赛季的 ID 和往届赛季及冠军
v3_standings	获取足球联赛积分榜（排名、已赛、胜、平、负、进球、积分、近期状态）、分组积分榜或杯赛对阵表
v3_league_matches	按轮次获取足球联赛的比赛：已结束轮次的比分和即将进行比赛的日期
v3_top_players	按一项统计数据获取足球联赛的最佳球员，例如最佳射手或助攻最多的球员
v3_team	获取一支足球队的页面信息：名称、关注者、近期状态、按位置分类的阵容，以及可选的转会信息
v3_team_matches	获取一支足球队在所有赛事中的最新赛果或即将进行的比赛
v3_news	获取 Varzesh3 新闻标题及简短摘要：最新新闻、最多阅读、最多评论，或关于某支球队、联赛、球员、比赛或体育项目的新闻
v3_article	阅读一篇新闻：标题、发布时间、全文、标签及其涉及的比赛
v3_videos	获取 Varzesh3 视频（进球、比赛集锦、采访）：最新视频，或关于某支球队、联赛、比赛或球员的视频
v3_league_stats	获取足球联赛的赛季统计数据：场均进球、场均红黄牌、进球时间、连胜等记录和球队排名
v3_team_players	获取一支足球队球员的赛季统计数据：进球、助攻、出场次数、上场时间、红黄牌
v3_player	获取一名球员的个人资料（球队、位置、球衣号码、年龄、国家），以及其最新新闻和视频
v3_head_to_head	获取两支足球队过往交锋记录，并汇总胜、平、负情况
v3_transfers	按俱乐部获取一个转会窗口的足球转会名单：签入和离队球员
v3_tv_schedule	获取未来几天体育比赛的直播节目表，包含开始时间和流媒体链接
v3_search	按名称搜索 Varzesh3 中的球队、人物、联赛、新闻和视频；可将名称转换为 ID

全部 18 个工具均标注为 readOnlyHint: true。

工作原理

  AI agent  ──MCP over stdio──▶  varzesh3-mcp (your machine)  ──HTTPS──▶  web-api.varzesh3.com, search-api.varzesh3.com

服务会调用 varzesh3.com 页面使用的相同公开 JSON 端点。请求通过 curl_cffi 呈现 Chrome TLS 和标头配置，最多同时运行 4 个请求，并缓存 30 秒。系统代理设置会被有意忽略；如果网络需要代理，请设置 VARZESH3_MCP_PROXY。

常见问题

需要账号或密钥吗？ 不需要。

为什么会收到 HTTP 5xx？ Varzesh3 的 CDN 有时会拒绝网络请求；设置 VARZESH3_MCP_PROXY=http://host:port，通过另一个出口转发请求。

有比赛统计数据（控球率、射门次数）吗？ 没有，该网站不发布这些数据。

这是官方服务吗？ 不是。它与 Varzesh3 没有隶属关系，只读取公开网站显示的内容，供个人和研究用途使用。请遵守该网站的条款。

波斯语

---

由 Sepehr Radmard (سپهر رادمرد) 制作：github.com/sepehr071 · linkedin.com/in/sepehr-radmard。MIT 许可证。