README.md
Scrape movie theater schedules from eiga.com for AI assistants.
Cinema Scheduler
映画館の上映スケジュールをスクレイピングし、Claude Desktop からMCPツールとして利用できるシステム。
構成
| パッケージ | 説明 |
|---|---|
@cinema-scheduler/shared |
共有コード（DB、型定義） |
@cinema-scheduler/scraper |
eiga.com スクレイパー |
@cinema-scheduler/mcp |
MCP サーバー |
@cinema-scheduler/inspector |
WebUI インスペクター |
セットアップ
# 依存関係インストール
pnpm install
# ビルド
pnpm build
使い方
1. スクレイピング
# 東京エリアを3日分スクレイピング
pnpm scrape --area tokyo --days 3
# ドライラン（DB保存なし）
pnpm scrape --area tokyo --days 1 --dry-run
# 利用可能なエリア一覧
pnpm scrape --list-areas
2. Claude Desktop との連携
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"cinema-scheduler": {
"command": "node",
"args": ["/path/to/cinema-scheduler/packages/mcp/dist/server.js"]
}
}
}
3. Inspector WebUI
pnpm inspector
http://localhost:3001 でMCPツールをブラウザからテストできます。
MCPツール
| ツール | 説明 |
|---|---|
get_showtimes |
上映スケジュール検索 |
list_theaters |
映画館一覧 |
list_movies |
上映中映画一覧 |
get_data_status |
データ状態確認 |
optimize_schedule |
複数映画の最適上映順序 |
開発
# テスト
pnpm test
# 型チェック
pnpm typecheck
# リント
pnpm lint
ディレクトリ構造
cinema-scheduler/
├── packages/
│ ├── shared/ # 共有コード
│ ├── scraper/ # スクレイパー
│ ├── mcp/ # MCPサーバー
│ └── inspector/ # WebUI
├── data/ # SQLiteデータベース
└── .kiro/ # 仕様・ステアリングドキュメント
Tools (5)
get_showtimesSearch for movie screening schedules.list_theatersList available movie theaters.list_moviesList movies currently showing.get_data_statusCheck the status of the scraped data.optimize_scheduleCalculate the optimal viewing order for multiple movies.Configuration
claude_desktop_config.json
{"mcpServers": {"cinema-scheduler": {"command": "node", "args": ["/path/to/cinema-scheduler/packages/mcp/dist/server.js"]}}}Try it
→What movies are playing at theaters in Tokyo today?
→Find showtimes for the latest blockbuster movie near me.
→I want to watch three specific movies today, can you optimize my schedule to fit them all in?
→List all the theaters currently available in the database.