io.github.ahmedaminsa由 GitHub 帳號 ahmedaminsa 發布v2.5.0更新於 Oct 24, 2026
Browse, search & watch Al Jazeera 360's Arabic shows, documentaries and podcasts inside the chat.
把助理接上半島電視台 360 的阿拉伯語串流內容庫，可搜尋、瀏覽並檢視節目、紀錄片、影集與單集，並附觀看連結。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.ahmedaminsa%2Faljazeera360-mcp-server/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"al-jazeera-360": {
"type": "http",
"url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp"
}
}
}[CI] [Python 3.10+] [License: MIT] [MCP Protocol] [Smithery]
Connect any AI assistant to Al Jazeera 360's streaming catalog — search, browse, and retrieve Arabic video content with direct watch links.
An MCP (Model Context Protocol) server that gives AI tools like Claude, ChatGPT, Gemini, and Cursor real-time access to Al Jazeera 360's full content library: documentaries, investigative programs, talk shows, podcasts, and original productions.
⚠️ Unofficial community project. Not affiliated with, endorsed by, or sponsored by Al Jazeera Media Network. It uses the platform's publicly accessible API and links back to
aljazeera360.comfor all content.
A hosted instance is live on Cloudflare. Add this to your MCP client config and you're done:
First request after idle takes a few seconds (container cold start) — subsequent requests are fast.
Then ask your assistant: "What's trending on Al Jazeera 360?" — or in Arabic: "ايه أحدث حلقات الدحيح؟"
Ask your AI assistant questions like:
The AI connects to this server, fetches real data from Al Jazeera 360, and returns actual video titles, descriptions, durations, and direct watch links to aljazeera360.com.
The server ships with two tool profiles:
A small default toolset keeps AI tool selection fast and accurate. Enable the full profile only if you need the SEO/analytics tools.
AJ360_ENABLE_SEO_TOOLS=1)AJ360_ENABLE_SEO_TOOLS=1)The server supports multiple authentication methods (in priority order):
Refresh Token (Recommended) — Auto-refreshes every 10 minutes, valid for ~1 year:
Auth Token — Direct token, expires in ~10 minutes:
Guest Mode — No configuration needed. The server auto-creates a guest session.
How to get your refresh token:
localStorage.getItem('dice:refreshToken')Core tools are tested against the live API.
Add to your config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop. The Al Jazeera 360 tools will appear automatically.
This server speaks the standard MCP protocol over stdio (local) and Streamable HTTP (hosted). It works with any MCP-compatible client:
The server needs only AJ360_API_KEY to run — authentication falls back to an automatic guest session. For full content access, also provide a refresh token.
The production instance runs on Cloudflare Containers — full walkthrough in
deploy/cloudflare/README.md (wraps the Dockerfile in a
Cloudflare Container behind a tiny Worker; requires the Workers Paid plan and local
Docker for deploys). Any container platform works — alternatives below.
Connect this repo — auto-deploys from the included Dockerfile. Set environment variables in the dashboard (including AJ360_ALLOWED_HOST=<your-domain> so the DNS-rebinding protection accepts your host).
The server includes pre-built prompts for common AI scenarios:
Calling search_videos("غزة") returns:
The server includes a built-in analytics dashboard that tracks every request made by AI tools.
search_videos, get_trending_content, etc.)The dashboard starts automatically on port 9090 when you run the server:
For cloud deployments, expose port 9090 alongside the MCP port (8080).
MIT
This repo doubles as an AI-assisted SEO operations workspace for the platform. Open it in Claude Code and you get:
PRs welcome. See CONTRIBUTING.md for guidelines.
Run tests before submitting:
來源：README.md，提交 f39ccd0
Get Trending Content (المحتوى الرائج)
Get the trending and most-watched content on Al Jazeera 360 platform. Returns featured shows, most-watched videos, latest episodes, and editorial picks. الحصول على المحتوى الرائج والأكثر مشاهدة على منصة الجزيرة 360. يشمل: البرامج المميزة، الأكثر مشاهدة، أحدث الحلقات، واقتراحات المحررين.
無需輸入參數。
Browse Section (تصفح الأقسام)
Browse content in a specific section/channel on Al Jazeera 360. تصفح محتوى قسم أو قناة محددة على منصة الجزيرة 360. Available sections (الأقسام المتاحة): - AJ360-Originals: أعمال الجزيرة 360 الأصلية - AJA: قناة الجزيرة العربية - AJD: الجزيرة الوثائقية - Atheer: أثير - AJ-Plus: AJ+ عربي - Talk Show: برامج حوارية - Investigative Show: برامج تحقيقية - Podcast: بودكاست - Documentaries: برامج وثائقية - Field Show: برامج ميدانية - Policy Series: سلاسل سياسية - Social Series: سلاسل اجتماعية - Historical Series: سلاسل تاريخية - Biographical Series: سلاسل سيرة ذاتية - Culture and Arts Series: سلاسل ثقافة وفنون Args: section_id: The section identifier (e.g., "AJA", "Documentaries", "Podcast")
section_id必填Get Video Details (تفاصيل الفيديو)
Get detailed information about a specific video on Al Jazeera 360. Returns title, description, duration, quality, categories, episode info, and watch URL. الحصول على معلومات تفصيلية عن فيديو محدد على منصة الجزيرة 360. يشمل: العنوان، الوصف، المدة، الجودة، التصنيفات، ورابط المشاهدة. Args: video_id: The numeric ID of the video (e.g., 953659)
video_id必填Play Video (تشغيل الفيديو)
Play a video from Al Jazeera 360. In AI apps that support interactive views (MCP Apps), this opens the official Al Jazeera 360 player inside the chat; elsewhere it returns the watch link. Use when the user asks to watch or play something. تشغيل فيديو من الجزيرة 360. في التطبيقات التي تدعم الواجهات التفاعلية يفتح المشغّل الرسمي داخل المحادثة، وفي غيرها يعيد رابط المشاهدة. Args: video_id: The numeric ID of the video (from search_videos, browse_section, etc.)
video_id必填Playback Diagnostics (فحص التشغيل)
Check whether this AI app can play Al Jazeera 360 videos inside the chat (protected video / DRM, embedding the official player, fullscreen). Use when the user says a video does not play in the chat. Call it with no arguments; the interactive view runs the checks and shows the result. فحص قدرة تطبيق الذكاء الاصطناعي على تشغيل فيديوهات الجزيرة 360 داخل المحادثة. استخدمها عندما يقول المستخدم إن الفيديو لا يعمل داخل المحادثة. Args: report: Internal. Filled by the interactive view with its capability check; leave empty.
reportGet Series Details (تفاصيل البرامج والسلاسل)
Get detailed information about a series on Al Jazeera 360, including all seasons. الحصول على معلومات تفصيلية عن مسلسل/برنامج على منصة الجزيرة 360 مع قائمة المواسم. Args: series_id: The numeric ID of the series (e.g., 2355 for الدحيح)
series_id必填Get Season Episodes (حلقات الموسم)
Get all episodes in a specific season. Use get_series_details first to find season IDs. الحصول على جميع حلقات موسم محدد. استخدم get_series_details أولاً للحصول على أرقام المواسم. Args: season_id: The season ID (obtained from get_series_details) max_episodes: Maximum number of episodes to return (default: 20)
season_id必填max_episodesSearch Videos (البحث عن الفيديوهات)
Search for videos, documentaries, and programs on Al Jazeera 360. Supports Arabic and English search queries. Optionally filter by content type. البحث عن فيديوهات ووثائقيات وبرامج على منصة الجزيرة 360. يدعم البحث بالعربية والإنجليزية. يمكن تصفية النتائج حسب نوع المحتوى. Examples: - "فلسطين" — videos about Palestine - "غزة" — videos about Gaza - "الدحيح" — Al Daheeh science show - "وثائقي تاريخي" — historical documentaries Args: query: Search term in Arabic or English content_type: Optional filter — "VOD" for single videos, "SERIES" for series only, None for all max_results: Maximum number of results to return (default: 20)
query必填max_resultscontent_typeList Sections (قائمة الأقسام المتاحة)
List all available sections and channels on Al Jazeera 360. Returns section IDs with their Arabic names for use with browse_section. عرض جميع الأقسام والقنوات المتاحة على منصة الجزيرة 360. يرجع معرفات الأقسام مع أسمائها العربية لاستخدامها مع browse_section.
無需輸入參數。
Get Latest Episodes (أحدث الحلقات)
Get the latest episodes from a specific section on Al Jazeera 360. الحصول على أحدث الحلقات من قسم محدد على منصة الجزيرة 360. Args: section_id: Section to get latest from (default: "AJA" for Al Jazeera Arabic) count: Number of episodes to return (default: 10)
countsection_idShow on Screen (اعرض على الشاشة)
Open the interactive Al Jazeera 360 view (the site's look: rows, programme pages, episode page, player) in the conversation. Use it ONLY when the user explicitly asks to see or display something on screen or to play an episode here (e.g. «اعرضلي»، «وريني»، «شغّلها هنا», "show me", "display", "play it here"). For everything else, use the other tools, which return data only. فتح العرض التفاعلي للجزيرة 360 داخل المحادثة، فقط عندما يطلب المستخدم العرض صراحةً. Args: view: home | section | latest | search | series | season | video | play video_id: For video or play series_id: For series season_id: For season section_id: For section or latest (e.g. "AJA", "AJD") query: For search
view必填queryvideo_idseason_idseries_idsection_idWatch Video (مشاهدة الفيديو)
Look at an Al Jazeera 360 episode: returns timestamped frames (one every ~15 s is available) as images, so you can see scenes, people and read on-screen text such as guest names and titles, news tickers and quotes. Use it to describe an episode, find who appears or when something is shown, or to build chapters and metadata. For long episodes, look at the whole range first, then zoom into a range. Afterwards, save_video_analysis stores what you found so it becomes searchable. مشاهدة حلقة من الجزيرة 360: صور من الحلقة بتوقيتها لقراءة النصوص على الشاشة ومعرفة الضيوف والمشاهد. Args: video_id: Video ID (from search_videos, get_season_episodes, ...) start_minute: Start of the range, in minutes (default 0) end_minute: End of the range, in minutes (default: end of the episode) max_frames: Frames to return, 4-36 (default 24; 12 per image)
video_id必填end_minutemax_framesstart_minuteSearch Video Index (البحث داخل الحلقات)
Search inside analysed episodes: who appeared, when a topic came up, what was said or shown on screen. Returns episodes with the timestamps of each match; for speech the exact second the phrase is spoken (exact_sec, from word timings). Covers episodes saved with save_video_analysis or transcribed with listen_to_video / transcribe_audio. البحث داخل الحلقات المحللة: مين ظهر، وإمتى اتكلموا عن موضوع، وإيه اللي اتقال أو اتكتب. Args: query: Name, topic or phrase (Arabic or English) kind: all | people (guests + mentions) | guest | mention | chapter | topic | keyword | onscreen | transcript | transcript_en (English translation) limit: Max matches (default 40)
kindlimitquery必填Get Video Analysis (تحليل الحلقة المحفوظ)
Read the saved analysis of an episode (summary, chapters, guests, topics, ad breaks, name fixes, on-screen text) or list all analysed episodes when no video_id is given. The transcript lines are left out unless include_transcript is true: use get_transcript for the text, or the download links. عرض التحليل المحفوظ لحلقة (الملخص والفصول والضيوف…)، أو قائمة كل الحلقات المحللة. Args: video_id: Video ID (omit to list analysed episodes) include_transcript: Also return every transcript/translation line (large; default false)
video_idinclude_transcriptGet Transcript (نص الحلقة والترجمة)
Get the full text of an episode: the platform's own subtitle file (WebVTT/SRT) when the episode has one, otherwise a transcript already saved in the video index. Returns the text with timestamps, plain text, or a ready SRT/VTT file. If neither exists, says so and lists the subtitle languages that are available. On the team endpoint, saved transcripts also come with download links (text, SRT, VTT) to the full file. نص الحلقة الكامل: ملف الترجمة الخاص بالمنصة إن وجد، أو التفريغ المحفوظ في الفهرس. Args: video_id: Video ID language: Subtitle language code (default "ar"; falls back to another language if absent) format: text (timestamped lines) | plain | srt | vtt start_minute: Start of the range, in minutes (default 0) end_minute: End of the range (default: end of the episode)
formatlanguagevideo_id必填end_minutestart_minute已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
{ "mcpServers": { "aljazeera360": { "type": "http", "url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp" } }}git clone https://github.com/ahmedaminsa/aljazeera360-mcp-server.gitcd aljazeera360-mcp-serverpip install -r requirements.txtexport AJ360_REFRESH_TOKEN="eyJ..."export AJ360_AUTH_TOKEN="eyJ..."python test_server.pypython server.py{ "mcpServers": { "aljazeera360": { "command": "python", "args": ["/full/path/to/aljazeera360-mcp-server/server.py"], "env": { "AJ360_REFRESH_TOKEN": "your-refresh-token-here" } } }}docker build -t aljazeera360-mcp .docker run -p 8080:8080 -e MCP_TRANSPORT=streamable-http -e AJ360_REFRESH_TOKEN=your-token aljazeera360-mcpgcloud builds submit --tag gcr.io/YOUR_PROJECT/aljazeera360-mcpgcloud 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"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) │└──────────────────────────┘{ "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" } ]}http://localhost:9090{ "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} ]}export AJ360_API_KEY=…python scripts/seo_snapshot.py # → reports/seo/<date>.md (local only)python test_server.py