bvp/tokuyama-scraper

The BVP Tokuyama Scraper for Boatrace.

5.3.0 2025-08-15 07:52 UTC

This package is auto-updated.

Last update: 2025-08-15 10:36:21 UTC


README

tests codecov php stable unstable license

BVP Tokuyama Scraper は、ボートレース徳山の公式サイトから選手コメント、オリジナル展示タイムをスクレイピングして取得できる PHP ライブラリです。

📦 Requirements

  • PHP ^8.2
  • Composer
  • Carbon

💾 Installation

composer require bvp/fukuoka-scraper

⚡ Usage

サポートメソッド一覧

メソッド 説明 引数
Scraper::scrapeComments($raceNumber, $raceDate = null) 選手コメントを取得 $raceNumber : 1〜12
$raceDate : Carbon対応日付文字列またはCarbonインスタンス(省略時は当日)
Scraper::scrapeTimes($raceNumber, $raceDate = null) オリジナル展示タイムを取得 同上

$raceDate の例

  • '2025-01-01'
  • '2025/01/01'
  • 'yesterday'
  • Carbon::now()->subDay()

基本的な使い方

<?php

require __DIR__ . '/vendor/autoload.php';

use BVP\TokuyamaScraper\Scraper;

// 選手コメントを取得
$comments = Scraper::scrapeComments(1, '2025-01-01');

// オリジナル展示タイムを取得
$times = Scraper::scrapeTimes(1, '2025-01-01');

print_r($comments);
print_r($times);

Scraper::scrapeComments()

// 例: ボートレース徳山の公式サイトから2025年01月01日の1レースの選手コメントを取得
$comments = Scraper::scrapeComments(1, '2025-01-01');
print_r($comments);
取得結果
Array
(
    [boat_number_1_racer_name] => 末永祐輝
    [boat_number_1_racer_yesterday_comment_label] => 前日コメント
    [boat_number_1_racer_yesterday_comment] => 状態は良かったと思います。
    [boat_number_2_racer_name] => 金子順一
    [boat_number_2_racer_yesterday_comment_label] => 前日コメント
    [boat_number_2_racer_yesterday_comment] => 足は変わっていない。
    [boat_number_3_racer_name] => 石倉拓美
    [boat_number_3_racer_yesterday_comment_label] => 前日コメント
    [boat_number_3_racer_yesterday_comment] => 中堅くらいです。
    [boat_number_4_racer_name] => 花本剛
    [boat_number_4_racer_yesterday_comment_label] => 前日コメント
    [boat_number_4_racer_yesterday_comment] => 風が強くてもグリップが良かった。
    [boat_number_5_racer_name] => 加木郁
    [boat_number_5_racer_yesterday_comment_label] => 前日コメント
    [boat_number_5_racer_yesterday_comment] => 悪くないけど、いい感じはしない。
    [boat_number_6_racer_name] => 藤本佳史
    [boat_number_6_racer_yesterday_comment_label] => 前日コメント
    [boat_number_6_racer_yesterday_comment] => 足は普通くらい。
)

Scraper::scrapeTimes()

// 例: ボートレース徳山の公式サイトから2025年01月01日の1レースのオリジナル展示タイムを取得
$times = Scraper::scrapeTimes(1, '2025-01-01');
print_r($times);
取得結果
Array
(
    [boat_number_1_racer_name] => 末永祐輝
    [boat_number_1_racer_exhibition_time] => 6.82
    [boat_number_1_racer_lap_time] => 36.61
    [boat_number_1_racer_turn_time] => 11.33
    [boat_number_2_racer_name] => 金子順一
    [boat_number_2_racer_exhibition_time] => 6.84
    [boat_number_2_racer_lap_time] => 37.35
    [boat_number_2_racer_turn_time] => 11.62
    [boat_number_3_racer_name] => 石倉拓美
    [boat_number_3_racer_exhibition_time] => 6.92
    [boat_number_3_racer_lap_time] => 37.78
    [boat_number_3_racer_turn_time] => 11.96
    [boat_number_4_racer_name] => 花本剛
    [boat_number_4_racer_exhibition_time] => 6.94
    [boat_number_4_racer_lap_time] => 37.39
    [boat_number_4_racer_turn_time] => 11.67
    [boat_number_5_racer_name] => 加木郁
    [boat_number_5_racer_exhibition_time] => 6.87
    [boat_number_5_racer_lap_time] => 37.41
    [boat_number_5_racer_turn_time] => 11.55
    [boat_number_6_racer_name] => 藤本佳史
    [boat_number_6_racer_exhibition_time] => 6.97
    [boat_number_6_racer_lap_time] => 37.6
    [boat_number_6_racer_turn_time] => 11.59
)

⚠️ Notes

  • スクレイピング対象の公式サイトの構造が変更された場合、正しくデータを取得できなくなる可能性があります。
  • 利用時は対象サイトの利用規約を遵守してください。

📄 License

BVP Tokuyama Scraper は MIT license の元で公開されています。