Skip to main content
Glama

🎬 BookMyShow MCP Webscraper

Python Version FastAPI MCP Server License Tests

Python-скрапер и API-обёртка для BookMyShow, которая извлекает списки фильмов, расписания сеансов в кинотеатрах, цены на билеты и данные о местоположении площадок (включая GPS-координаты широты и долготы).

Всё упаковано в FastAPI REST-сервер, MCP-инструменты (для ИИ-ассистентов, таких как Claude или Cursor), CLI-инструмент и встроенную веб-панель.


✨ Возможности

  • Списки фильмов и событий: Получение активных и предстоящих списков фильмов по городам Индии (Мумбаи, Дели-NCR, Бангалор, Ченнаи и др.) с фильтрами по языку и жанру.

  • Расписание сеансов и цены: Получение расписания сеансов в кинотеатрах, форматов экрана (2D, 3D, IMAX, 4DX), диапазонов цен на билеты (в ₹) и наличия мест.

  • Местоположение площадок и координаты: Получение почтовых адресов кинотеатров, точных координат широты и долготы, а также удобств площадки (парковка, фуд-корт, M-ticket вход).

  • Синопсис и трейлеры фильмов: Получение кратких описаний сюжета, информации об актёрах и съёмочной группе, рейтингов, постеров и ссылок на трейлеры на YouTube.

  • Работа в качестве MCP-сервера: Работает из коробки с ИИ-инструментами (Claude Desktop, Cursor, Antigravity) через bms-mcp (или mcp_server.py локально).

  • FastAPI REST-сервер: Интерактивная документация Swagger API (/docs).

  • Терминальный CLI: Терминальный интерфейс для поиска, списков и экспорта.

  • Экспорт в файлы: Экспорт собранных данных в JSON, CSV или Excel (.xlsx).

  • Веб-панель: Простая панель в светлой теме для просмотра фильмов и тестирования конечных точек.


Related MCP server: Movie Booking Assistant

🚀 Быстрый старт и установка

git clone https://github.com/m0han-r/bookmyshow-mcp-webscraper.git
cd bookmyshow-mcp-webscraper
pip install -r requirements.txt

🔌 API и MCP-инструменты

REST-конечная точка

Имя MCP-инструмента

Параметры

Описание

GET /api/v1/cities

bms_get_cities

popular_only

Поддерживаемые регионы Индии и популярные города

GET /api/v1/movies

bms_get_movies

city, language, genre

Активные списки фильмов с фильтрами по языку и жанру

GET /api/v1/events

bms_get_events

city, category

Живые события, комедийные шоу, музыкальные концерты и спорт

GET /api/v1/movies/{code}

bms_get_movie_details

movie_code, city

Синопсис, актёры, съёмочная группа, рейтинги, постер и ссылки на трейлер

GET /api/v1/showtimes

bms_get_showtimes

movie_code, city, date, language, format

Расписание сеансов, форматы экрана (IMAX/3D/4DX), цены, места и фильтр по языку

GET /api/v1/venues/{code}

bms_get_venue_details

venue_code, city

Почтовый адрес кинотеатра, точные широта, долгота и удобства

GET /api/v1/search

bms_search

query, city

Перекрёстный поиск фильмов и живых событий

Пример ответа для площадки (GET /api/v1/venues/PCAN?city=chennai):

{
  "success": true,
  "count": 1,
  "data": {
    "venue_code": "PCAN",
    "venue_name": "PVR: VR Chennai, Anna Nagar",
    "address": "3rd Floor, VR Mall, Metro Zone, Jawaharlal Nehru Road, Anna Nagar, Chennai, Tamil Nadu 600040",
    "latitude": 13.082561,
    "longitude": 80.194803,
    "facilities": ["Ticket Cancellation", "F&B", "MTicket", "Parking Facility", "Food Court"]
  }
}

🌐 Запуск REST API-сервера

Запустите сервер:

python main.py

🤖 Настройка MCP-сервера

Подключите свой ИИ-ассистент (Claude Desktop, Cursor, Antigravity) с помощью uvx. uvx автоматически загружает пакет из GitHub и выполняет точку входа скрипта bms-mcp, зарегистрированную в pyproject.toml.

Конфигурация Claude Desktop / Cursor / Antigravity

Добавьте в ваш %APPDATA%\Claude\claude_desktop_config.json (или .cursor/mcp.json):

{
  "mcpServers": {
    "bookmyshow": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
        "bms-mcp"
      ]
    }
  }
}

Прямое выполнение в терминале

Запустите нативно в PowerShell или Command Prompt (uv генерирует и запускает обёртки bms-mcp.exe на Windows):

uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcp

Конфигурация Claude Desktop / Cursor / Antigravity

Добавьте в ваш ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bookmyshow": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
        "bms-mcp"
      ]
    }
  }
}

Прямое выполнение в терминале

Запустите прямо в терминале Linux:

uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcp

Конфигурация Claude Desktop / Cursor / Antigravity

Добавьте в ваш ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bookmyshow": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
        "bms-mcp"
      ]
    }
  }
}

Прямое выполнение в терминале

Запустите прямо в терминале macOS / zsh:

uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcp

Если вы клонировали репозиторий локально:

python mcp_server.py

🐍 Использование Python

from bms_scraper import BookMyShowScraper

scraper = BookMyShowScraper()

# Get active movies
movies = scraper.get_movies(city="mumbai", language="Hindi")

# Get venue coordinates
venue = scraper.get_venue_details(venue_code_or_url="PCAN", city="chennai")
print(f"📍 {venue.venue_name} - Lat: {venue.latitude}, Lon: {venue.longitude}")

# Get showtimes (supports language filters e.g. "tamil", "hindi", "all" and format filters e.g. "IMAX", "2D")
showtimes = scraper.get_showtimes(movie_code_or_url="ET00378770", city="chennai", date="20260827", language="tamil", format="2D")

💻 Использование CLI

Выполняйте CLI напрямую через uvx без установки зависимостей или локально через Python:

# List popular cities via uvx
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli cities --popular

# Scrape movies in Bengaluru and export to Excel
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli movies --city bengaluru --language Hindi --export xlsx

# Scrape showtimes in Chennai for Tamil language with date and export to JSON
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --export json
# List popular cities via uvx
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli cities --popular

# Scrape movies in Bengaluru and export to Excel
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli movies --city bengaluru --language Hindi --export xlsx

# Scrape showtimes in Chennai for Tamil language with date and export to JSON
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --export json
# List popular cities
python -m bms_scraper.cli cities --popular

# Scrape movies in Bengaluru and export to Excel
python -m bms_scraper.cli movies --city bengaluru --language Hindi --export xlsx

# Scrape showtimes with language filter
python -m bms_scraper.cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --format 2D

📊 Экспорт данных

from bms_scraper import BookMyShowScraper, DataExporter

scraper = BookMyShowScraper()
movies = scraper.get_movies(city="mumbai")

DataExporter.to_csv(movies, "movies.csv")
DataExporter.to_excel(movies, "movies.xlsx")
DataExporter.to_json(movies, "movies.json")

🧪 Запуск тестов

python -m pytest

⚖️ Лицензия

Распространяется под лицензией MIT.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Provides a comprehensive movie booking experience for AMC Theatres, enabling users to discover movies, find showtimes, select seats, and process payments through conversational AI. Supports multi-location theater search with real-time seat availability and booking management.
    6
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Live Google Maps business search, review, and photo data for AI agents over MCP.

  • AI marketplace — flights, tours, activities, transport & more via MCP. No auth required.

  • Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/m0han-r/bookmyshow-mcp-webscraper'

If you have feedback or need assistance with the MCP directory API, please join our Discord server