README

BVP Scraper は、ボートレースの公式サイトから出走表、直前情報、オッズ、結果をスクレイピングするための PHP ライブラリです。

v10 では、後継ライブラリである turnmark/scraper とは異なる方向性を持つ派生として、以下の 2 点に力を入れています。

鮮度に応じたキャッシュ: 確定済みの過去日のレースは不変とみなし、キャッシュに永続化。バックフィル用途で同じ日付を何度も取り直す必要がなくなります。
インスタンス単位の並行実行: レート制御・キャッシュ参照をインスタンススコープに保持するため、プロキシやワーカーごとに複数の Scraper インスタンスを同一プロセス内で干渉なく並行運用できます。

📦 Requirements

php: ^8.3
nesbot/carbon: ^2.63 || ^3.0
psr/simple-cache: ^3.0
symfony/browser-kit: ^7.0 || ^8.0
symfony/cache: ^7.0 || ^8.0
symfony/css-selector: ^7.0 || ^8.0
symfony/http-client: ^7.0 || ^8.0

💾 Installation

composer require bvp/scraper

⚡ Usage

サポートメソッド一覧

Scraper はインスタンスベースの API です。静的なシングルトンファサードは提供していません（後述）。

メソッド	説明	引数
`scrapeProgram($date, $stadiumNumber, $raceNumber)`	出走表を取得	`$date` : Carbon対応日付文字列またはCarbonインスタンス `$stadiumNumber` : 1〜24 `$raceNumber` : 1〜12
`scrapePreview($date, $stadiumNumber, $raceNumber)`	直前情報を取得	同上
`scrapeOdds($date, $stadiumNumber, $raceNumber)`	全オッズ（7種）を取得	同上
`scrapeWin` / `scrapePlace` / `scrapeExacta` / `scrapeQuinella` / `scrapeQuinellaPlace` / `scrapeTrifecta` / `scrapeTrio`	単勝・複勝・2連単・2連複・拡連複・3連単・3連複のオッズを個別に取得	同上
`scrapeSingle` / `scrapePair` / `scrapeTriple`	単勝・複勝 / 2連単・2連複・拡連複 / 3連単・3連複をまとめて取得	同上
`scrapeResult($date, $stadiumNumber, $raceNumber)`	結果を取得	同上
`scrapeStadium($date)`	開催中の場を取得	`$date` のみ
`scrapeProgramBulk($date, $stadiumNumbers = [], $raceNumbers = [])`	出走表を一括取得	`$stadiumNumbers`/`$raceNumbers` 省略時はその日開催している全場・全レース
`scrapePreviewBulk` / `scrapeOddsBulk` / `scrapeResultBulk`	同上の一括取得版	同上
`scrapeWinBulk` / `scrapePlaceBulk` / `scrapeExactaBulk` / `scrapeQuinellaBulk` / `scrapeQuinellaPlaceBulk` / `scrapeTrifectaBulk` / `scrapeTrioBulk`	同上の一括取得版	同上
`scrapeSingleBulk` / `scrapePairBulk` / `scrapeTripleBulk`	同上の一括取得版	同上

$date の例

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

基本的な使い方

<?php

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

use BVP\Scraper\Scraper;

$scraper = new Scraper();

// 出走表を取得
$program = $scraper->scrapeProgram('2025-01-01', 24, 1);

// 直前情報を取得
$preview = $scraper->scrapePreview('2025-01-01', 24, 1);

// オッズを取得
$odds = $scraper->scrapeOdds('2025-01-01', 24, 1);

// 結果を取得
$result = $scraper->scrapeResult('2025-01-01', 24, 1);

print_r($program);
print_r($preview);
print_r($odds);
print_r($result);

一括取得

// その日開催している全場・全レースの結果を取得
$results = $scraper->scrapeResultBulk('2025-01-01');

// 開催場・レースを絞り込む
$results = $scraper->scrapeResultBulk('2025-01-01', [24], [1, 2, 3]);

レスポンス形式（`_source` / 変換済み値）

各フィールドは、公式サイトから取得した生の文字列（{field}_source）と、型変換・Enum変換済みの値（{field}）のペアで返されます。生データが常に残るため、変換ロジックの検証やデバッグがしやすくなっています。

$result = $scraper->scrapeResult('2017-03-31', 24, 1);

// $result の抜粋
[
    'weather_number_source' => '雨',
    'weather_number' => 3,
    'wind_direction_number_source' => '南西',
    'wind_direction_number' => 11,
    'racers' => [
        1 => [
            'name' => '中辻 博訓',
            'number_source' => '3833',
            'number' => 3833,
            // ...
        ],
        // ...
    ],
];

キャッシュ

過去日（実行日より前の日付）のスクレイピング結果は、既定でファイルシステムベースの PSR-16 キャッシュに無期限保存されます。当日・未来日はキャッシュされません（レース情報自体が変動しうるため）。

use BVP\Scraper\Caching\CacheFactory;

// キャッシュディレクトリを指定
$scraper = new Scraper(cache: CacheFactory::createDefault('/path/to/cache'));

// 1回目: ネットワークにアクセス
$scraper->scrapeResult('2017-03-31', 24, 1);

// 2回目: キャッシュから即座に返る
$scraper->scrapeResult('2017-03-31', 24, 1);

Psr\SimpleCache\CacheInterface を実装した任意のバックエンド（Redis や APCu など）や、キャッシュ対象の判定ロジック（BVP\Scraper\Caching\CachePolicyInterface）を差し替えることもできます。

確定済み過去レースが修正された場合（`forceRefresh`）

ごく稀に、公式サイト側で確定済みの過去レースのデータに修正が入ることがあります。そのような場合は forceRefresh: true を指定すると、キャッシュを無視してネットワークから再取得し、その結果でキャッシュを上書きします。以降の通常呼び出しは上書き後の値を返します。

// キャッシュを無視して再取得し、キャッシュも上書きする
$scraper->scrapeResult('2017-03-31', 24, 1, forceRefresh: true);

forceRefresh は全ての scrape*()/scrape*Bulk() メソッドに指定できます（scrape*Bulk() に指定した場合、開催場一覧の解決も含めて一括分すべてが再取得されます）。

並行実行・マルチテナンシー

レート制御はインスタンスごとに保持されるため、プロキシやアカウントが異なる複数の Scraper インスタンスを同一プロセス内で並行運用しても、互いのペース配分を食い合いません。

use BVP\Scraper\RateLimiting\ThrottleRateLimiter;
use Symfony\Component\BrowserKit\HttpBrowser;
use Symfony\Component\HttpClient\HttpClient;

// ワーカー1: プロキシA経由で今日分を取得（3秒間隔）
$scraperA = new Scraper(
    httpBrowser: new HttpBrowser(HttpClient::create(['proxy' => 'http://proxy-a:8080'])),
    rateLimiter: new ThrottleRateLimiter(3.0),
);

// ワーカー2: プロキシB経由で過去分をバックフィル（1秒間隔）
$scraperB = new Scraper(
    httpBrowser: new HttpBrowser(HttpClient::create(['proxy' => 'http://proxy-b:8080'])),
    rateLimiter: new ThrottleRateLimiter(1.0),
);

// 両者は独立したレート状態を持つため、同一プロセス内で並行運用しても
// 互いのペース配分を食い合わない

⚠️ Notes

v10 は v6 との後方互換性を意図的に持たない大きな設計変更（インスタンスベース API・レスポンススキーマの変更）を含みます。既存の利用箇所は bvp/scraper: ^6.0 に固定してください。
スクレイピング対象の公式サイトの構造が変更された場合、正しくデータを取得できなくなる可能性があります。
利用時は対象サイトの利用規約を遵守してください。

📄 License

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

bvp / boatrace-scraper

Maintainers

Package info

Statistics

Security

README

📦 Requirements

💾 Installation

⚡ Usage

サポートメソッド一覧

基本的な使い方

一括取得

レスポンス形式（`_source` / 変換済み値）

キャッシュ

確定済み過去レースが修正された場合（`forceRefresh`）

並行実行・マルチテナンシー

⚠️ Notes

📄 License

bvp / boatrace-scraper

Maintainers

Package info

Statistics

Security

README

📦 Requirements

💾 Installation

⚡ Usage

サポートメソッド一覧

基本的な使い方

一括取得

レスポンス形式（_source / 変換済み値）

キャッシュ

確定済み過去レースが修正された場合（forceRefresh）

並行実行・マルチテナンシー

⚠️ Notes

📄 License

レスポンス形式（`_source` / 変換済み値）

確定済み過去レースが修正された場合（`forceRefresh`）