Al Jazeera 360

Al Jazeera 360 MCP 服务

将任何 AI 助手连接到 Al Jazeera 360 的流媒体目录——搜索、浏览并获取带有直接观看链接的阿拉伯语视频内容。

一个 MCP（Model Context Protocol）服务，为 Claude、ChatGPT、Gemini 和 Cursor 等 AI 工具提供对 Al Jazeera 360 完整内容库的实时访问：纪录片、调查节目、脱口秀、播客和原创作品。

⚠️ 非官方社区项目。 与 Al Jazeera Media Network 无关联，未获其认可或赞助。此项目使用该平台公开访问的 API，所有内容均链接回 aljazeera360.com。

---

⚡ 快速连接——无需安装

Cloudflare 上已部署一个托管实例。将以下内容添加到 MCP 客户端配置中即可：

{
  "mcpServers": {
    "aljazeera360": {
      "type": "http",
      "url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp"
    }
  }
}

空闲后发出的首次请求需要等待几秒钟（容器冷启动）——后续请求会很快。

然后向助手提问：“Al Jazeera 360 上有哪些热门内容？”——或者用阿拉伯语问：“ايه أحدث حلقات الدحيح؟”

---

功能介绍

你可以向 AI 助手提问，例如：

• “Al Jazeera 360 上有哪些热门内容？”
• “查找有关巴勒斯坦的纪录片”
• “显示 Al Daheeh 的最新剧集”
• “搜索有关加沙的视频”

AI 会连接到此服务，从 Al Jazeera 360 获取真实数据，并返回实际的视频标题、描述、时长以及指向 aljazeera360.com 的直接观看链接。

---

可用工具

此服务提供两种工具配置：

配置	工具	适用对象	使用方式
Core（默认）	8 个内容发现工具	向 AI 助手询问内容的终端用户	开箱即用
Full	全部 24 个工具（+ SEO 和分析）	内容团队、SEO 分析师	设置 AJ360_ENABLE_SEO_TOOLS=1

较小的默认工具集有助于 AI 快速、准确地选择工具。只有在需要 SEO/分析工具时，才启用完整配置。

核心内容发现工具（始终启用）

工具	功能
list_sections	列出平台上全部 15 个版块/频道
get_trending_content	返回首页推荐和观看人数最多的内容
browse_section	浏览特定版块中的所有内容（例如纪录片、播客）
get_video_details	返回视频的完整元数据：标题、描述、时长、画质（最高 4K）和观看 URL
get_series_details	返回剧集信息和所有可用的季
get_season_episodes	列出特定季中的所有剧集
search_videos	对所有内容进行全文搜索（阿拉伯语和英语），并可选择按内容类型筛选
get_latest_episodes	返回任意版块中最新发布的剧集

SEO 与元数据工具（需要 AJ360_ENABLE_SEO_TOOLS=1）

工具	功能
generate_seo_content	为视频生成优化后的阿拉伯语标题、描述和关键词
generate_sitemap	生成适用于 Google Search Console 的视频 XML 站点地图（分页）
audit_metadata_quality	检查目录健康状况，包括缺失的描述、缩略图和类别（分页）
get_trending_topics	提取目录中热门程度最高的关键词和主题
compare_sections	比较所有分区的内容新鲜度和活跃度
get_series_seo_map	为某个系列生成完整的 SEO 地图，包含所有剧集

高级 AI 与分析工具（需要 AJ360_ENABLE_SEO_TOOLS=1）

工具	功能
build_knowledge_graph	根据目录元数据构建实体知识图谱
generate_faq_schema	为视频生成 FAQ Schema JSON-LD
get_ai_discoverability_score	评估 AI 助手发现内容的难易程度
build_topic_clusters	将内容归入 SEO 主题集群，包含支柱页面和支持页面
find_evergreen_content	找出能够长期保持相关性的内容
get_host_profile	为节目主持人生成 Person Schema 和个人资料
get_genre_report	报告类型分布和 SEO 机会
get_searchable_tags_map	汇总目录中搜索次数最多的关键词（分页）
get_country_content_map	按国家汇总内容，用于地理定位 SEO（分页）
generate_series_schema	为某个系列生成 TVSeries + TVEpisode JSON-LD Schema

---

分区

ID	频道
AJ360-Originals	Al Jazeera 360 原创内容
AJA	Al Jazeera 阿拉伯语
AJD	Al Jazeera 纪录片
Atheer	Atheer
AJ-Plus	AJ+ 阿拉伯语
Talk Show	脱口秀节目
Investigative Show	调查类节目
Podcast	播客
Documentaries	纪录片
Field Show	现场报道
Policy Series	政治系列节目
Social Series	社会议题系列节目
Historical Series	历史系列节目
Biographical Series	人物传记系列节目
Culture and Arts Series	文化与艺术

---

快速开始

安装

git clone https://github.com/ahmedaminsa/aljazeera360-mcp-server.git
cd aljazeera360-mcp-server
pip install -r requirements.txt

配置身份验证

服务支持多种身份验证方式（按优先级排序）：

1. 刷新令牌（推荐） — 每 10 分钟自动刷新一次，有效期约 1 年：

   export AJ360_REFRESH_TOKEN="eyJ..."
   

2. 身份验证令牌 — 直接使用令牌，有效期约 10 分钟：

   export AJ360_AUTH_TOKEN="eyJ..."
   

3. 访客模式 — 无需配置。服务会自动创建访客会话。

如何获取刷新令牌：

1. 在浏览器中打开 https://www.aljazeera360.com
2. 登录你的账户
3. 打开 DevTools → Console → 运行：localStorage.getItem('dice:refreshToken')
4. 复制令牌值

测试

python test_server.py

核心工具已通过实时 API 测试。

运行

python server.py

---

与 Claude Desktop 搭配使用

将以下内容添加到配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aljazeera360": {
      "command": "python",
      "args": ["/full/path/to/aljazeera360-mcp-server/server.py"],
      "env": {
        "AJ360_REFRESH_TOKEN": "your-refresh-token-here"
      }
    }
  }
}

重启 Claude Desktop。Al Jazeera 360 工具将自动显示。

---

与任意 MCP 客户端搭配使用

此服务通过 stdio（本地）和 Streamable HTTP（托管）使用标准 MCP 协议。它兼容任何支持 MCP 的客户端：

• Claude Desktop
• Cursor
• Continue
• Windsurf
• MCP Inspector（用于测试）
• 任意自定义 MCP 客户端

---

配置

变量	必填	默认值	描述
AJ360_REFRESH_TOKEN	否	—	长效刷新令牌（约 1 年）。最适合生产环境。
AJ360_AUTH_TOKEN	否	Guest mode	短效身份验证令牌（约 10 分钟）。适合快速测试。
AJ360_API_KEY	是	—	平台 API 密钥（公开，可从浏览器网络请求中获取）。不包含默认值，必须自行提供。
MCP_TRANSPORT	否	streamable-http	传输模式：stdio（本地）、streamable-http（云端，推荐）或 sse（旧版云端）。
MCP_PORT	否	8080	HTTP 传输使用的端口（云端部署）。
AJ360_ALLOWED_HOST	仅限云端	—	部署的公共主机名（不含协议）。使用自定义域名自托管时必填；DNS 重绑定防护会以 421 拒绝未知主机。
AJ360_ENABLE_SEO_TOOLS	否	关闭	设为 1 可注册 16 个 SEO/分析工具（完整配置）。
AJ360_ENABLE_DASHBOARD	否	true	启用或禁用分析仪表板。
AJ360_DASHBOARD_PORT	否	9090	分析仪表板的端口。
AJ360_DASHBOARD_TOKEN	否	—	分析数据端点（/api/stats、/api/recent）使用的共享密钥。设置后，调用方必须发送 Authorization: Bearer <token> 或 ?token=<token>。强烈建议在任何公共/云端部署中设置此项。
AJ360_ANALYTICS_DB	否	analytics.db	SQLite 分析数据库的路径。

服务器只需 AJ360_API_KEY 即可运行——身份验证会自动回退到访客会话。要获得完整内容访问权限，还需提供刷新令牌。

---

部署

生产实例运行于 Cloudflare Containers 上——完整部署指南见 deploy/cloudflare/README.md（在 Cloudflare Container 中运行 Dockerfile，并置于一个轻量 Worker 后；部署需要 Workers Paid 计划和本地 Docker）。任何容器平台都可使用，其他选项如下。

Docker

docker build -t aljazeera360-mcp .
docker run -p 8080:8080 -e MCP_TRANSPORT=streamable-http -e AJ360_REFRESH_TOKEN=your-token aljazeera360-mcp

Google Cloud Run

gcloud builds submit --tag gcr.io/YOUR_PROJECT/aljazeera360-mcp
gcloud run deploy aljazeera360-mcp \
  --image gcr.io/YOUR_PROJECT/aljazeera360-mcp \
  --platform managed \
  --allow-unauthenticated \
  --set-env-vars="MCP_TRANSPORT=streamable-http,AJ360_REFRESH_TOKEN=your-token"

Render / Railway / Fly.io

连接此仓库，即可根据内含的 Dockerfile 自动部署。在控制面板中设置环境变量（包括 AJ360_ALLOWED_HOST=<your-domain>，以便 DNS 重绑定防护接受你的主机）。

---

工作原理

Your AI Assistant
       │
       │  MCP Protocol (stdio / Streamable HTTP)
       ▼
┌──────────────────────────┐
│  This MCP Server         │
│  ┌────────────────────┐  │
│  │ Token Manager      │  │
│  │ (auto-refresh)     │  │
│  ├────────────────────┤  │
│  │ 24 Tools + Prompts │  │
│  │ + Retry + Cache    │  │
│  └────────────────────┘  │
└──────────┬───────────────┘
           │
           │  HTTPS (authenticated)
           ▼
┌──────────────────────────┐
│  Al Jazeera 360 API      │
│  (Vesper/Dice Platform)  │
└──────────┬───────────────┘
           │
           ▼
┌──────────────────────────┐
│  aljazeera360.com        │
│  (Direct watch links)    │
└──────────────────────────┘

---

内置提示词

服务器包含适用于常见 AI 场景的预置提示词：

提示词	描述
recommend_documentary	查找并推荐有关特定主题的纪录片
summarize_latest	总结某个栏目中的最新剧集
explore_series	浏览系列内容——查找所有季和剧集

---

输出示例

调用 search_videos("غزة") 会返回：

{
  "query": "غزة",
  "total_results": 20,
  "results": [
    {
      "title": "المسعفون أهداف إسرائيل المتنقلة!",
      "type": "VOD",
      "duration": "24:53",
      "id": "965741",
      "watch_url": "https://www.aljazeera360.com/video/965741"
    },
    {
      "title": "قيادة السنوار لجهاز حماس الأمني",
      "type": "VOD",
      "duration": "54:57",
      "id": "953659",
      "watch_url": "https://www.aljazeera360.com/video/953659"
    }
  ]
}

---

分析仪表板

服务器内置了分析仪表板，用于跟踪 AI 工具发出的每个请求。

跟踪内容

• 发出请求的 AI 工具（Claude、ChatGPT、Cursor 等）
• 调用的 MCP 工具（search_videos、get_trending_content 等）
• 每个请求的发生时间（时间戳）
• 每个请求耗时（响应时间，单位为毫秒）
• 请求是否成功
• 热门搜索词（用户咨询的内容）
• 每日/每小时的活动模式

访问仪表板

运行服务器时，仪表板会自动在端口 9090 上启动：

http://localhost:9090

对于云端部署，请在 MCP 端口（8080）之外同时公开端口 9090。

API 端点

端点	返回内容
GET /	交互式 HTML 仪表板（每 10 秒自动刷新）
GET /api/stats	JSON 摘要：请求总数、工具使用情况、热门搜索和每日明细
GET /api/recent	包含完整详情的最近 50 条请求的 JSON 列表
GET /api/health	健康检查，包含版本、传输方式以及指向 /privacy 和 /docs 的链接
GET /privacy	隐私政策页面
GET /docs	服务文档页面

配置

变量	默认值	说明
AJ360_ENABLE_DASHBOARD	true	设置为 false 以禁用仪表板
AJ360_DASHBOARD_PORT	9090	分析 HTTP 服务器的端口
AJ360_DASHBOARD_TOKEN	—	读取 /api/stats 和 /api/recent 所需的共享密钥。在任何公开部署中都应设置此项。
AJ360_ANALYTICS_DB	analytics.db	SQLite 数据库文件路径

统计数据输出示例

{
  "total_requests": 1247,
  "success_rate": "99.2%",
  "tools_usage": [
    {"tool": "search_videos", "calls": 523, "avg_response_ms": 340},
    {"tool": "get_trending_content", "calls": 312, "avg_response_ms": 180}
  ],
  "clients": [
    {"client": "claude-desktop", "requests": 890},
    {"client": "cursor", "requests": 357}
  ],
  "top_searches": [
    {"term": "\u063a\u0632\u0629", "count": 89},
    {"term": "\u0641\u0644\u0633\u0637\u064a\u0646", "count": 67}
  ]
}

---

技术栈

组件	技术
语言	Python 3.10+
MCP SDK	mcp（Anthropic 官方）
HTTP	httpx（异步）
重试	tenacity（指数退避）
认证	Firebase JWT（自动管理并刷新）
分析	SQLite + 内置 HTTP 仪表板
视频质量	最高可达 4K（2160p）
传输方式	stdio（本地）/ Streamable HTTP（云端，推荐）/ SSE（旧版）

---

许可证

MIT

---

SEO 运营与 Vesper 知识库（AI 辅助）

此仓库同时也是该平台的 AI 辅助 SEO 运营工作区。 在 Claude Code 中打开，即可使用：

内容	功能
.claude/agents/onvesper-expert.md	关于 aljazeera360.com 所用 Vesper/Deltatre 平台的专家 Agent — 可向其咨询 Back Office、DVE、许可、广告等任何问题。
onvesper-kb/	官方 Vesper 文档的完整离线镜像（317 页，可随时通过 bash onvesper-kb/refresh.sh 重新构建）
/seo-report 技能	按需进行深度 SEO 分析：运行 SEO 工具、读取趋势，并将分析结果转化为可直接执行的 Back Office 修复步骤
scripts/seo_snapshot.py	此技能背后的指标收集器（可发现性评分、元数据审查、标签映射）。报告按需在本地生成，不会提交。

export AJ360_API_KEY=…
python scripts/seo_snapshot.py   # → reports/seo/<date>.md (local only)

贡献

欢迎提交 PR。请参阅 CONTRIBUTING.md 了解指南。

提交前请运行测试：

python test_server.py