Skip to main content
Glama

🎬 BookMyShow MCP Webscraper

Python Version FastAPI MCP Server License Tests

Ein Python-Scraper und API-Wrapper für BookMyShow, der Filmlisten, Kinovorstellungen, Ticketpreise und Veranstaltungsortdetails (einschließlich GPS-Breiten- und Längengrad) extrahiert.

Es bündelt alles in einem FastAPI-REST-Server, MCP-Werkzeugen (für KI-Assistenten wie Claude oder Cursor), einem CLI-Tool und einem integrierten Web-Dashboard.


✨ Funktionen

  • Filme & Veranstaltungen auflisten: Ruft aktive oder kommende Filmlisten in indischen Städten (Mumbai, Delhi-NCR, Bengaluru, Chennai usw.) ab, mit Filtern nach Sprache und Genre.

  • Vorstellungen & Preise abrufen: Holt Kinovorstellungen, Bildschirmformate (2D, 3D, IMAX, 4DX), Ticketpreisspannen (in ₹) und Sitzplatzverfügbarkeit.

  • Veranstaltungsorte & Breiten-/Längengrad extrahieren: Ruft Straßenadressen von Kinos, genaue Breiten- und Längengradkoordinaten sowie Annehmlichkeiten des Veranstaltungsorts (Parkplatz, Food Court, M-Ticket-Eingang) ab.

  • Filmsynopsen & Trailer abrufen: Ruft Handlungszusammenfassungen, Besetzungs- und Crew-Informationen, Bewertungen, Poster und YouTube-Trailer-Links ab.

  • Als MCP-Server ausführbar: Funktioniert sofort mit KI-Tools (Claude Desktop, Cursor, Antigravity) über bms-mcp (oder lokal mcp_server.py).

  • FastAPI-REST-Server: Interaktive Swagger-API-Dokumentation (/docs).

  • Terminal-CLI: Terminal-Schnittstelle für Suche, Auflistungen und Exporte.

  • Export in Dateien: Exportiert gescrapte Daten als JSON, CSV oder Excel (.xlsx).

  • Web-Dashboard: Einfaches Dashboard mit hellem Design zum Durchsuchen von Filmen und Testen von Endpunkten.


Related MCP server: Movie Booking Assistant

🚀 Schnellstart & Installation

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

🔌 API & MCP-Werkzeuge

REST-Endpunkt

MCP-Werkzeugname

Parameter

Beschreibung

GET /api/v1/cities

bms_get_cities

popular_only

Unterstützte indische Regionen & beliebte Städte

GET /api/v1/movies

bms_get_movies

city, language, genre

Aktive Filmlisten mit Sprach-/Genre-Filtern

GET /api/v1/events

bms_get_events

city, category

Live-Veranstaltungen, Comedy-Shows, Musikkonzerte und Sport

GET /api/v1/movies/{code}

bms_get_movie_details

movie_code, city

Synopse, Besetzung, Crew, Bewertungen, Poster- & Trailer-Links

GET /api/v1/showtimes

bms_get_showtimes

movie_code, city, date, language, format

Vorstellungen, Bildschirmformate (IMAX/3D/4DX), Preise, Sitzplätze & Sprachfilterung

GET /api/v1/venues/{code}

bms_get_venue_details

venue_code, city

Straßenadresse des Kinos, genaue Breite, Länge & Einrichtungen

GET /api/v1/search

bms_search

query, city

Quersuche nach Filmen und Live-Veranstaltungen

Beispiel-Antwort für Veranstaltungsort (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"]
  }
}

🌐 Starten des REST-API-Servers

Starten Sie den Server:

python main.py

🤖 MCP-Server-Einrichtung

Verbinden Sie Ihren KI-Assistenten (Claude Desktop, Cursor, Antigravity) mit uvx. uvx holt das Paket automatisch von GitHub und führt den in pyproject.toml registrierten Skript-Einstiegspunkt bms-mcp aus.

Claude Desktop / Cursor / Antigravity-Konfiguration

Fügen Sie zu Ihrer %APPDATA%\Claude\claude_desktop_config.json (oder .cursor/mcp.json) hinzu:

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

Direkte Terminal-Ausführung

Führen Sie nativ in PowerShell oder Command Prompt aus (uv generiert und führt bms-mcp.exe-Wrapper unter Windows aus):

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

Claude Desktop / Cursor / Antigravity-Konfiguration

Fügen Sie zu Ihrer ~/.config/Claude/claude_desktop_config.json hinzu:

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

Direkte Terminal-Ausführung

Führen Sie direkt im Linux-Terminal aus:

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

Claude Desktop / Cursor / Antigravity-Konfiguration

Fügen Sie zu Ihrer ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Direkte Terminal-Ausführung

Führen Sie direkt im macOS-Terminal / zsh aus:

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

Wenn Sie das Repository lokal geklont haben:

python mcp_server.py

🐍 Python-Nutzung

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-Nutzung

Führen Sie die CLI direkt über uvx aus, ohne Abhängigkeiten zu installieren, oder lokal über 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

📊 Exportieren von Daten

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")

🧪 Ausführen von Tests

python -m pytest

⚖️ Lizenz

Verteilt unter der MIT-Lizenz.

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