Repository avatar
Search & Data Extraction
v0.1.1
active

namasha-mcp

io.github.sepehr071/namasha-mcp

Read-only Namasha (namasha.com) Iranian video platform: search, videos, channels, categories.

Documentation

namasha-mcp: unofficial Namasha (نماشا) MCP server that searches Iranian videos, reads channels and comments and browses categories for Claude, Cursor and Copilot

namasha-mcp: Namasha (نماشا) Iranian video platform MCP server for AI agents

namasha-mcp is an unofficial, read-only MCP server that lets an AI agent search videos, read video details, comments and related videos, and browse channels and categories on Namasha (نماشا, namasha.com), an Iranian video-sharing platform.
Its 9 tools search videos, show a video (views, likes, comment count, duration, upload date, tags, channel), its comments and related videos, show a channel and its videos, list the home page's featured rows, and list the categories and their newest videos.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: PolyForm Noncommercial

For AI agents · Quick start · Tools · Limits · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for namasha.com: video search, video details, comments, related videos, channel pages, featured rows and categories.
  • Install: uvx namasha-mcp or claude mcp add namasha -- uvx namasha-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional NAMASHA_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, upload, comment, like or follow. Video files are not exposed, only page URLs.
  • Tools: 9, all prefixed nm_. Typical sequences: nm_search -> nm_video / nm_channel; nm_channel -> nm_channel_videos; nm_categories -> nm_category_videos; nm_video -> nm_comments / nm_related.
  • Use when: the user wants to find Persian videos on Namasha, asks how many views or likes a video has, wants a channel's videos, or wants to browse a category or the home page picks.
  • Output: compact JSON. Duration is seconds. Lists carry title, duration, channel and a relative age text in Persian; only nm_video has views, likes and the exact upload date. Titles and comments are Persian.

Quick start

You need uv. No API key or account.

Claude Code:

claude mcp add namasha -- uvx namasha-mcp

Claude Desktop, Cursor, VS Code and other clients:

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

Example prompts:

  • "Search Namasha for Python tutorials."
  • "How many views does the Namasha video yt6ef2FC have?"
  • "List the newest videos in the music category on Namasha."
  • در نماشا دنبال ویدیوهای آموزش پایتون بگرد.
  • آخرین ویدیوهای کانال پویاکام را نشان بده.

Real answers (18 Nov 2026): nm_search(query="آموزش پایتون") returned 60 videos on page 1, the first lasting 116 seconds, then 127 and 838 seconds. nm_video(video="yt6ef2FC") returned 286,336 views, 44 likes and a duration of 270 seconds.

Tools

ToolWhat it returns
nm_searchVideos matching a text, 60 per page
nm_videoOne video: title, description, views, likes, comment count, duration, upload date, tags, channel
nm_relatedVideos Namasha suggests next to a video (page 1 about 12, later pages 20 each)
nm_commentsThe public comments of a video: text, author, age, likes, replies
nm_channelA channel: name, verified flag, description, creation date, links
nm_channel_videosA channel's videos, newest first, 60 per page
nm_featuredThe videos on the home page: editors' picks or the special row
nm_categoriesNamasha's video categories with the slug the category tool takes
nm_category_videosThe newest videos of a category, 60 per page

Limits

  • Namasha has no JSON API, so the server reads the HTML pages. A site redesign can break parsing until the server is updated.
  • Views come only from the video page's structured data; they are not shown on the page itself. List results have no view counts.
  • Lists show a relative age in Persian (for example "2 سال پیش"), not an exact date. Namasha has no view-based trending list and no channel follower counts.
  • Few videos have comments. Comment paging was not seen (at most 5 comments were found), so it is unverified for videos with many comments.
  • The home "featured" row rotates on every load. Home rows other than featured and special are not exposed.
  • Namasha answered both Iranian and foreign networks in testing; if yours is blocked, set NAMASHA_MCP_PROXY. The server ignores system proxy variables on purpose.

فارسی

namasha-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای نماشا (namasha.com) است. با آن یک عامل هوش مصنوعی می‌تواند ویدیوها را جست‌وجو کند، جزئیات ویدیو (بازدید، لایک، مدت، برچسب‌ها، کانال)، نظرات و ویدیوهای مرتبط را بخواند، کانال و ویدیوهایش را ببیند و دسته‌بندی‌ها و ویدیوهای منتخب صفحهٔ اصلی را فهرست کند. بدون حساب کاربری و کلید API کار می‌کند. نصب در Claude Code:

claude mcp add namasha -- uvx namasha-mcp

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline tests on recorded fixtures
uv run python -m pytest -m live -q  # live calls to namasha.com

Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI.

Disclaimer

Unofficial and not affiliated with or endorsed by Namasha. It is read-only and uses the public pages of namasha.com, which can change without notice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.

مجوز استفاده (License)

استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a license.

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0.

Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub.