corich_stage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dd8771af9b1f797fea78523e08fd3ca0737eb874cb09143600e1b10dbb2679cf
+  data.tar.gz: be7aead12b75f22d0e67fd1a1a1dc94423d396d6e595676d4ab100390df5fd65
+SHA512:
+  metadata.gz: b866391d145161ea1ab2beff94532d424ef6d5ffc093bc5483161dd6933b45abd790baef902839043716efea15feef61003c2186ad2169f116e06c7318a61f4a
+  data.tar.gz: '028f578c4c14bab82d53902e79d57bc5bf69b7f7bf560e445f42eb4c6de50207b0e4863ca3331e01b81d1b70771e349073b2d73923239009d5a0f2b5e5f9df91'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ryu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,119 @@
+# corich_stage
+
+[CoRich舞台芸術](https://stage.corich.jp)から公演情報をスクレイピングするRuby gem。
+
+## インストール
+
+```ruby
+# Gemfile
+gem "corich_stage", github: "ryu/corich_stage"
+
+# ローカル開発
+gem "corich_stage", path: "../corich_stage"
+```
+
+## 使い方
+
+### 公演一覧の取得
+
+```ruby
+# 東京の公演一覧（デフォルト: 90日先まで）
+summaries = CorichStage.search
+
+# 基準日を指定（デフォルト: 今日）
+summaries = CorichStage.search(date: Date.new(2026, 4, 1))
+
+# 日付範囲を変更
+summaries = CorichStage.search(days_ahead: 30)
+
+# 組み合わせ: 4月1日から30日先まで
+summaries = CorichStage.search(date: Date.new(2026, 4, 1), days_ahead: 30)
+
+# ページ数制限
+summaries = CorichStage.search(max_pages: 3)
+
+summary = summaries.first
+summary.stage_id    #=> "431567"
+summary.title       #=> "闇に咲く花"
+summary.venue       #=> "紀伊國屋サザンシアター TAKASHIMAYA"
+summary.period      #=> "2026/03/28 (土) ～ 2026/04/19 (日)"
+summary.start_date  #=> #<Date: 2026-03-28>
+summary.end_date    #=> #<Date: 2026-04-19>
+```
+
+### 公演詳細の取得
+
+```ruby
+stage = CorichStage.fetch("431567")
+
+stage.title            #=> "闇に咲く花"
+stage.company          #=> "こまつ座"
+stage.director_name    #=> "大河内直子"
+stage.playwright_name  #=> "井上ひさし"
+stage.venue            #=> "紀伊國屋サザンシアター TAKASHIMAYA"
+stage.period           #=> "2026/03/28 (土) ～ 2026/04/19 (日)"
+stage.prices           #=> "3,000円 ～ 9,500円"
+stage.duration         #=> "約3時間0分（休憩含む）を予定"
+stage.cast             #=> "筧利夫、諏訪珠理、佐藤正宏、..."
+stage.description      #=> "昭和20年、東京の下町..."
+stage.staff            #=> "作・演出・音楽：糸井幸之介..."
+stage.official_site    #=> "https://komatsuza.co.jp/..."
+```
+
+### ヘルパーメソッド
+
+```ruby
+stage.duration_minutes #=> 180        "約3時間0分" → 整数
+stage.cast_members     #=> ["筧利夫", "諏訪珠理", ...]  読点区切り → 配列
+stage.min_price        #=> 3000       "3,000円 ～ 9,500円" → 最小値
+stage.max_price        #=> 9500       "3,000円 ～ 9,500円" → 最大値
+```
+
+### 設定
+
+```ruby
+# config/initializers/corich_stage.rb
+CorichStage.configure do |config|
+  config.user_agent = "MyApp/1.0 (+https://example.com)"
+  config.request_interval = 2.0  # リクエスト間隔（秒）
+  config.timeout = 30            # タイムアウト（秒）
+  config.max_retries = 3         # リトライ回数
+end
+```
+
+Rails環境では `CorichStage.logger` に `Rails.logger` が自動設定されます。
+
+## Rails連携の例
+
+```ruby
+# app/jobs/fetch_stages_job.rb
+class FetchStagesJob < ApplicationJob
+  queue_as :default
+  limits_concurrency to: 1, key: "corich_fetch"
+
+  def perform
+    summaries = CorichStage.search(max_pages: 10)
+    summaries.each do |summary|
+      next if Performance.exists?(corich_id: summary.stage_id)
+      FetchStageDetailJob.perform_later(summary.stage_id)
+    end
+  end
+end
+```
+
+## 注意事項
+
+- 本gemは [CoRich舞台芸術](https://stage.corich.jp) の公式APIではなく、Webスクレイピングにより情報を取得します
+- サイトへの過度なアクセスを避けるため、`request_interval` を適切に設定してください（デフォルト: 1秒）
+- サイトの構造変更により動作しなくなる場合があります
+- サイト運営者から要請があった場合は利用を停止してください
+
+## 依存
+
+- Ruby >= 3.2
+- Nokogiri
+- net-http
+
+## ライセンス
+
+MIT

data/lib/corich_stage/client.rb

@@ -0,0 +1,69 @@
+module CorichStage
+  class Client
+    MAX_REDIRECTS = 5
+
+    def initialize
+      @last_request_at = nil
+    end
+
+    def get(path, params: {})
+      throttle!
+      uri = build_uri(path, params)
+
+      response = perform_request(uri)
+      @last_request_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+      response.body.dup.force_encoding("UTF-8")
+    end
+
+    private
+
+    def headers
+      {
+        "User-Agent" => CorichStage.user_agent,
+        "Accept-Language" => "ja,en-US;q=0.9,en;q=0.8",
+        "Accept" => "text/html,application/xhtml+xml"
+      }
+    end
+
+    def build_uri(path, params)
+      uri = URI.join(CorichStage::BASE_URL, path)
+      uri.query = URI.encode_www_form(params) unless params.empty?
+      uri
+    end
+
+    def perform_request(uri, attempt: 0, redirects: 0)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.open_timeout = CorichStage.timeout
+      http.read_timeout = CorichStage.timeout
+
+      request = Net::HTTP::Get.new(uri, headers)
+      response = http.request(request)
+
+      case response
+      when Net::HTTPSuccess
+        response
+      when Net::HTTPRedirection
+        raise RequestError, "Too many redirects" if redirects >= MAX_REDIRECTS
+        perform_request(URI(response["Location"]), attempt: attempt, redirects: redirects + 1)
+      when Net::HTTPTooManyRequests, Net::HTTPServiceUnavailable
+        raise RequestError, "#{response.code} after #{attempt} retries: #{response.message}" if attempt >= CorichStage.max_retries
+        sleep_time = (response["Retry-After"]&.to_i || 5) * (attempt + 1)
+        CorichStage.logger&.warn("[CorichStage] #{response.code} - retry #{attempt + 1}/#{CorichStage.max_retries}, sleeping #{sleep_time}s")
+        sleep(sleep_time)
+        perform_request(uri, attempt: attempt + 1, redirects: redirects)
+      else
+        raise RequestError, "HTTP #{response.code}: #{response.message}"
+      end
+    end
+
+    def throttle!
+      return unless @last_request_at
+
+      elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - @last_request_at
+      remaining = CorichStage.request_interval - elapsed
+      sleep(remaining) if remaining > 0
+    end
+  end
+end

data/lib/corich_stage/detail_parser.rb

@@ -0,0 +1,128 @@
+module CorichStage
+  class DetailParser
+    PERIOD_RE = /\d{4}\/\d{2}\/\d{2}\s*\([^)]+\)\s*～\s*\d{4}\/\d{2}\/\d{2}\s*\([^)]+\)/
+    STATUS_RE = /上演中|予約受付中|もうすぐ開幕|もうすぐ閉幕|終演/
+
+    SECTION_LABELS = %w[
+      スタッフ 出演 脚本 演出 料金（1枚あたり）
+      公式／劇場サイト タイムテーブル その他注意事項
+    ].to_set.freeze
+
+    def initialize(html, stage_id:)
+      @doc = Nokogiri::HTML(html)
+      @stage_id = stage_id
+      @lines = extract_lines
+    end
+
+    def parse
+      Stage.new(
+        stage_id: @stage_id,
+        url: "#{CorichStage::BASE_URL}/stage/#{@stage_id}",
+        title: extract_title,
+        company: extract_company,
+        venue: extract_labeled_value("劇場"),
+        prefecture: nil,
+        period: combined_text[PERIOD_RE],
+        status: extract_status,
+        duration: extract_inline_value("上演時間："),
+        prices: extract_labeled_value("料金（1枚あたり）"),
+        description: extract_description,
+        cast: extract_labeled_value("出演"),
+        staff: extract_labeled_value("スタッフ"),
+        director_name: extract_labeled_value("演出"),
+        playwright_name: extract_labeled_value("脚本"),
+        official_site: extract_official_site
+      )
+    end
+
+    private
+
+    def extract_lines
+      @doc.text.split("\n").map { _1.gsub(/\s+/, " ").strip }.reject(&:empty?)
+    end
+
+    def combined_text
+      @combined_text ||= @lines.join("\n")
+    end
+
+    def extract_title
+      @doc.css("h1").each do |h1|
+        text = h1.text.gsub(/\s+/, " ").strip
+        return text if !text.empty? && !text.include?("CoRich舞台芸術")
+      end
+
+      title_tag = @doc.at_css("title")
+      return title_tag.text.split("|").first.strip if title_tag
+
+      ""
+    end
+
+    def extract_company
+      troupe_link = @doc.at_css('a[href*="/troupe/"]')
+      troupe_link&.text&.strip
+    end
+
+    def extract_status
+      @lines.each do |line|
+        next unless PERIOD_RE.match?(line)
+        status = line[STATUS_RE]
+        return status if status
+      end
+
+      @lines.each do |line|
+        status = line[STATUS_RE]
+        return status if status
+      end
+
+      nil
+    end
+
+    def extract_labeled_value(label)
+      @lines.each_with_index do |line, i|
+        if line == label && i + 1 < @lines.size
+          return @lines[i + 1]
+        end
+        if line.start_with?("#{label} ")
+          return line.delete_prefix("#{label} ").strip
+        end
+      end
+      nil
+    end
+
+    def extract_inline_value(prefix)
+      @lines.each_with_index do |line, i|
+        if line.start_with?(prefix)
+          remainder = line.delete_prefix(prefix).strip
+          return remainder unless remainder.empty?
+          return @lines[i + 1] if i + 1 < @lines.size
+        end
+      end
+      nil
+    end
+
+    def extract_description
+      @lines.each_with_index do |line, i|
+        if line.start_with?("説明 ")
+          return line.delete_prefix("説明 ").strip
+        end
+        if line == "説明"
+          chunks = @lines[(i + 1)..].take_while { !SECTION_LABELS.include?(_1) }
+          return chunks.join(" ").gsub(/\s+/, " ").strip if chunks.any?
+        end
+      end
+      nil
+    end
+
+    def extract_official_site
+      %w[公式サイト： 公式サイト 公式／劇場サイト].each do |label|
+        node = @doc.at_xpath("//*[contains(text(), '#{label}')]")
+        next unless node
+        anchor = node.at_css("~ a[href], a[href]") || node.parent&.at_css("a[href]")
+        next unless anchor
+        href = anchor["href"].strip
+        return href if href.start_with?("http") && !href.include?("ticket.corich.jp")
+      end
+      nil
+    end
+  end
+end

data/lib/corich_stage/error.rb

@@ -0,0 +1,5 @@
+module CorichStage
+  class Error < StandardError; end
+  class RequestError < Error; end
+  class ParseError < Error; end
+end

data/lib/corich_stage/listing_parser.rb

@@ -0,0 +1,68 @@
+module CorichStage
+  class ListingParser
+    STAGE_HREF_RE = %r{\A/stage/(\d+)\z}
+    PERIOD_RE = /\d{4}\/\d{2}\/\d{2}\s*\([^)]+\)\s*～\s*\d{4}\/\d{2}\/\d{2}\s*\([^)]+\)/
+    PRICE_RE = /\d[\d,]*円\s*～\s*\d[\d,]*円/
+    PREFECTURE_RE = /\A（[^）]+）\z/
+    STATUS_RE = /上演中|予約受付中|もうすぐ開幕|もうすぐ閉幕|終演/
+
+    def initialize(html)
+      @doc = Nokogiri::HTML(html)
+    end
+
+    def parse
+      seen = Set.new
+      summaries = []
+
+      @doc.css("a[href]").each do |anchor|
+        href = anchor["href"]
+        match = STAGE_HREF_RE.match(href)
+        next unless match
+
+        stage_id = match[1]
+        next if seen.include?(stage_id)
+
+        parts = extract_parts(anchor)
+        next if parts.empty?
+
+        raw_text = parts.join(" ")
+        period = raw_text[PERIOD_RE]
+        next unless period
+
+        seen.add(stage_id)
+        summaries << build_summary(stage_id, href, parts, raw_text, period)
+      end
+
+      summaries
+    end
+
+    private
+
+    def extract_parts(anchor)
+      anchor.text.split("\n").map { _1.gsub(/\s+/, " ").strip }.reject(&:empty?)
+    end
+
+    def build_summary(stage_id, href, parts, raw_text, period)
+      prefecture = parts.find { PREFECTURE_RE.match?(_1) }
+      venue = extract_venue(parts, prefecture)
+
+      StageSummary.new(
+        stage_id: stage_id,
+        url: "#{CorichStage::BASE_URL}#{href}",
+        title: parts.first,
+        venue: venue,
+        prefecture: prefecture,
+        period: period,
+        price_range: raw_text[PRICE_RE],
+        status: raw_text[STATUS_RE]
+      )
+    end
+
+    def extract_venue(parts, prefecture)
+      return nil unless prefecture
+      idx = parts.index(prefecture)
+      return nil unless idx && idx > 0
+      parts[idx - 1]
+    end
+  end
+end

data/lib/corich_stage/railtie.rb

@@ -0,0 +1,7 @@
+module CorichStage
+  class Railtie < Rails::Railtie
+    initializer "corich_stage.configure" do
+      CorichStage.logger = Rails.logger
+    end
+  end
+end

data/lib/corich_stage/search.rb

@@ -0,0 +1,59 @@
+module CorichStage
+  class Search
+    TOKYO_AREA_ID = 3
+    PER_PAGE = 20
+
+    def initialize(area_id: TOKYO_AREA_ID, sort: "start", days_ahead: 90, max_pages: nil, date: Date.today)
+      @area_id = area_id
+      @sort = sort
+      @days_ahead = days_ahead
+      @max_pages = max_pages
+      @date = date
+      @client = Client.new
+    end
+
+    def results
+      summaries = []
+      page = 1
+
+      loop do
+        html = @client.get("/stage/search", params: search_params(page))
+        batch = ListingParser.new(html).parse
+
+        break if batch.empty?
+
+        summaries.concat(batch)
+        page += 1
+
+        break if @max_pages && page > @max_pages
+        break if batch.size < PER_PAGE
+      end
+
+      filter_by_date(summaries)
+    end
+
+    def page(number)
+      html = @client.get("/stage/search", params: search_params(number))
+      ListingParser.new(html).parse
+    end
+
+    private
+
+    def search_params(page)
+      {
+        "stage_search[area_id]" => @area_id,
+        "stage_search[scope]" => "firing",
+        "sort" => @sort,
+        "page" => page,
+        "freeword_type" => "all"
+      }
+    end
+
+    def filter_by_date(summaries)
+      return summaries unless @days_ahead
+
+      cutoff = @date + @days_ahead
+      summaries.select { _1.end_date.nil? || _1.end_date <= cutoff }
+    end
+  end
+end

data/lib/corich_stage/stage.rb

@@ -0,0 +1,56 @@
+module CorichStage
+  Stage = Data.define(
+    :stage_id,
+    :url,
+    :title,
+    :company,
+    :venue,
+    :prefecture,
+    :period,
+    :status,
+    :duration,
+    :prices,
+    :description,
+    :cast,
+    :staff,
+    :director_name,
+    :playwright_name,
+    :official_site
+  ) do
+    DURATION_RE = /(\d+)\s*時間\s*(\d+)?\s*分?|約?(\d+)\s*分/
+
+    def duration_minutes
+      return nil unless duration
+      match = duration.match(DURATION_RE)
+      return nil unless match
+
+      if match[1] # N時間M分
+        match[1].to_i * 60 + (match[2]&.to_i || 0)
+      else # N分
+        match[3].to_i
+      end
+    end
+
+    def cast_members
+      return [] unless cast
+      cast.split(/[、,]/).map(&:strip).reject(&:empty?)
+    end
+
+    def min_price
+      extract_price(:min)
+    end
+
+    def max_price
+      extract_price(:max)
+    end
+
+    private
+
+    def extract_price(type)
+      return nil unless prices
+      numbers = prices.scan(/[\d,]+(?=円)/).map { _1.delete(",").to_i }
+      return nil if numbers.empty?
+      type == :min ? numbers.min : numbers.max
+    end
+  end
+end

data/lib/corich_stage/stage_summary.rb

@@ -0,0 +1,30 @@
+module CorichStage
+  StageSummary = Data.define(
+    :stage_id,
+    :url,
+    :title,
+    :venue,
+    :prefecture,
+    :period,
+    :price_range,
+    :status
+  ) do
+    def detail_url
+      "#{CorichStage::BASE_URL}/stage/#{stage_id}"
+    end
+
+    def end_date
+      return nil unless period
+      match = period.match(%r{～\s*(\d{4})/(\d{2})/(\d{2})})
+      return nil unless match
+      Date.new(match[1].to_i, match[2].to_i, match[3].to_i)
+    end
+
+    def start_date
+      return nil unless period
+      match = period.match(%r{(\d{4})/(\d{2})/(\d{2})})
+      return nil unless match
+      Date.new(match[1].to_i, match[2].to_i, match[3].to_i)
+    end
+  end
+end

data/lib/corich_stage.rb

@@ -0,0 +1,43 @@
+require "uri"
+require "net/http"
+require "nokogiri"
+require "set"
+require "date"
+
+require_relative "corich_stage/error"
+require_relative "corich_stage/stage_summary"
+require_relative "corich_stage/stage"
+require_relative "corich_stage/client"
+require_relative "corich_stage/listing_parser"
+require_relative "corich_stage/detail_parser"
+require_relative "corich_stage/search"
+
+module CorichStage
+  BASE_URL = "https://stage.corich.jp"
+
+  class << self
+    attr_accessor :user_agent, :request_interval, :timeout, :max_retries, :logger
+  end
+
+  self.user_agent = "CorichStage/0.1 (+https://github.com/ryu/corich_stage)"
+  self.request_interval = 1.0
+  self.timeout = 20
+  self.max_retries = 3
+  self.logger = nil
+
+  def self.configure
+    yield self
+  end
+
+  def self.search(**params)
+    Search.new(**params).results
+  end
+
+  def self.fetch(stage_id)
+    client = Client.new
+    html = client.get("/stage/#{stage_id}")
+    DetailParser.new(html, stage_id: stage_id).parse
+  end
+end
+
+require_relative "corich_stage/railtie" if defined?(Rails::Railtie)

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: corich_stage
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ryu Yamamoto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby library for scraping performance information from CoRich Stage (stage.corich.jp).
+  Supports searching listings and fetching detailed show data with built-in rate limiting.
+email:
+- ryu.yamamoto@icloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/corich_stage.rb
+- lib/corich_stage/client.rb
+- lib/corich_stage/detail_parser.rb
+- lib/corich_stage/error.rb
+- lib/corich_stage/listing_parser.rb
+- lib/corich_stage/railtie.rb
+- lib/corich_stage/search.rb
+- lib/corich_stage/stage.rb
+- lib/corich_stage/stage_summary.rb
+homepage: https://github.com/ryu/corich_stage
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ryu/corich_stage
+  source_code_uri: https://github.com/ryu/corich_stage
+  documentation_uri: https://github.com/ryu/corich_stage#readme
+  bug_tracker_uri: https://github.com/ryu/corich_stage/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Scraper for CoRich Stage (stage.corich.jp)
+test_files: []