Philippine Baseball Platform Docs
メニュー

データ辞書

data/ は収集した情報の一次置き場です。ここでは7ファイルの目的、列の意味、必須項目、扱うときの注意、検証と切り出しの方法をまとめます。

最終更新 2026-11-22行数は 2026-11-21 時点の参考値

データの原則

  • 出典URLを保持する。 データ行は出典URLを持ちます。アプリ用に切り出すときも、落とす場合は理由を spec.md に書きます。
  • 元データは書き換えない。 data/ の編集は収集担当の明示的な依頼があったときだけ行います。
  • 空値は空文字。 NULL や - ではなく "" です。
  • 推測で埋めない。 不明な値は空欄のままにし、確認区分や補足に状態を書きます。
  • 文字コードは UTF-8。 読み込み時は utf-8-sig を推奨します(BOM があっても安全側)。

ファイル一覧

7ファイルの形式と供給先(2026-11-21 時点)
ファイル形式行数供給先主な用途
baseball-news.csvCSV276news-digest / timeline日本語要約ニュース
uaap-players.csvCSV470player-databaseUAAP の出場選手
lbp-players.csvCSV150player-databaseLBP の所属選手
national-team-players-colleges.csvCSV108player-database代表選手の大学歴
national-team-rosters.csvCSV601player-database / timeline大会別の代表ロースター
baseball-game-videos.mdMarkdown103video-guide / timeline試合動画URL
baseball-game-video-summaries.mdMarkdown52video-guide動画のタイムスタンプ要約

動画の行数はアプリ生成後の videos.json の件数です。Markdown の箇条書き行数とは一致しないことがあります。収集・評価に使うスクリプトは 運用手順のデータ更新 を参照してください。

ニュース baseball-news.csv

2000〜2026年のフィリピン野球関連記事を、日本語の2〜3文要約つきで蓄積します。1行が1記事です。

baseball-news.csv の列
列型必須例注意
日付日付必須2026-01-01YYYY-MM-DD。年と矛盾させない
年整数必須20262000〜2026。日付 の年と一致させる
分野文字列必須代表8値のいずれか。区分を参照
ニュース名文字列必須代表チームが…日本語の見出し。長すぎる場合は要約しない
概要文字列必須…を述べた。2〜3文。事実中心。推測を書かない
出典文字列必須Example News媒体名。URL ではない
元記事・記録URLURL必須https://example.com/article公開記事のURL。署名付きURLは使わない
要約のルール

要約は2〜3文・事実中心で、出典URLを必ず添えます。未成年選手は公報・記録の範囲に限定し、個人情報を足しません。

UAAP uaap-players.csv

UAAP 男子大学野球の選手出場記録を、報道ベースで1行ずつ蓄積します。大学は UST / DLSU / NU / Ateneo / Adamson / UP の6校です。

uaap-players.csv の列
列型必須例注意
開催年整数必須20232000〜2019、2023〜2026。2020〜2022は欠落
UAAPシーズン文字列必須Season 85年から推定しない。 列の値をそのまま読む
大学文字列必須Ateneo6校コードのいずれか
選手名(出典表記)文字列必須<選手名>出典の表記をそのまま。自動名寄せは慎重に
ポジション(報道記載)文字列任意Pitcher英語表記。空欄あり
出場確認内容文字列必須Match play described何で確認したかの短文
記事日付日付必須2023-03-29YYYY-MM-DD
出典記事文字列必須…記事タイトル
出典URLURL必須https://example.com/…公開記事のURL
ポジション出典URLURL任意https://example.com/…ポジションを別記事で補った場合
開催年 ≠ シーズン番号

2023年が Season 85 のように、開催年とシーズン番号は一致しません。シーズン番号は必ず列から読み、年から計算しません。

LBP lbp-players.csv

Liga Baseball Philippines の大会・チーム・選手・背番号・ポジションを蓄積します。大会名は「Tingzon Cup」「Baseball Philippines Series VIII」など多様です。

lbp-players.csv の列
列型必須例注意
開催年整数必須2024大会の開催年
大会文字列必須Tingzon Cup「Series VIII」と「Series 8」の表記ゆれに注意
LBPチーム文字列必須Example Starsチーム名
選手名(出典表記)文字列必須<選手名>出典の表記をそのまま
背番号(LBP)文字列任意#16空欄あり。# の有無は出典に合わせる
ポジション(LBP資料)文字列任意P空欄が多い。複合表記あり
確認区分文字列必須大会前名簿掲載確認の段階。区分を参照
確認内容・補足文字列任意…名簿のみか、試合で確認したか
記事日付日付必須2024-05-22YYYY-MM-DD
出典記事文字列必須…記事タイトル
出典URLURL必須https://example.com/…公開記事のURL
ポジション出典URLURL任意https://example.com/…ポジションの補助出典

代表の大学歴 national-team-players-colleges.csv

男子シニア代表選手の大学・短大の経歴を、根拠区分つきで蓄積します。1行が1選手の経歴です。

national-team-players-colleges.csv の列
列型必須例注意
選手名文字列必須<選手名>代表ロースターとの名寄せは表記ゆれに注意
確認できた大学・短大文字列必須<大学名>大学名は裏付け未確認 はプレースホルダ。実データとして扱わない
大学野球歴の確認時期文字列必須2019年以前に競技歴いつ時点の経歴か
対象期間内の大学出場文字列必須未確認出場が確認できたか
根拠区分文字列必須試合報道試合報道 / 公式名簿 / 連盟公表歴 / 未確認
出典URLURL必須https://example.com/…根拠のURL
補足文字列任意…卒業の有無など、確認できていない点

代表ロースター national-team-rosters.csv

2001年以降の大会別シニア代表ロースターを、1選手×1大会=1行で蓄積します。同一選手が複数大会に出場すると行が重複します。

national-team-rosters.csv の列
列型必須例注意
開催年整数必須20012001〜2026。欠落年がある
大会文字列必須<大会名>大会名の表記は出典に合わせる
選手名文字列必須<選手名>英語表記が多い
ポジション文字列任意IFP, OF や IF/P の複合表記あり
背番号文字列任意#00空欄が多い
確認区分文字列必須二次資料(大会エントリー)確認の段階
出典URLURL必須https://example.com/…公開資料のURL
備考文字列任意…補足
複合ポジション

ポジションは P / IF / OF / C が軸ですが、P, OF や 3B, P のように複合します。主ポジションが必要な場合は先頭要素を使うのが安全です。

試合動画 baseball-game-videos.md

国内リーグ、UAAP、フィリピン代表などの試合動画URLを、1行1動画で蓄積します。見出しはカテゴリ別です。

- YYYY-MM-DD | 対戦・大会 | 種類・公開元 | [動画URL](URL) | メモ
行の構成
位置内容例
1日付2026-01-01
2対戦・大会UAAP 男子野球
3種類・公開元ハイライト / YouTube
4動画URL[動画](https://example.com/video)
5メモ…

映像の4分類

種類定義
フル試合試合全体を中継・配信する映像
ハイライト得点シーンや好プレーをダイジェスト編集した映像
ニューススポーツニュース番組内の短い試合結果報道
場面ホームラン、好捕、最終アウトなど単一プレーの映像

動画の存在・タイトル・チャンネル・長さは check_video.py が機械取得し、4分類の提案に使います。消失した動画は登録を見送ります。

動画解析サマリー baseball-game-video-summaries.md

解析済み動画のタイムスタンプ付き要約です。## YYYY-MM-DD | 対戦 の見出しの下に、動画URL・分類・大会・解析種別・解析日時と本文が続きます。

## YYYY-MM-DD | 対戦
- 動画URL: https://example.com/video
- 分類・公開元: ハイライト / YouTube
- 大会・所属: …
- 解析種別: …
- 解析日時: …

### 解析内容
…
全部を一度に読まない

ファイルは約180KBあります。日付・対戦・URLで検索し、該当セクションだけを読みます。

横断の注意

論点注意
選手名の表記ゆれ出典ごとに表記が揺れます。異なる大学で同名選手が出る場合は、留年・転校の可能性もあり、自動マッチングは慎重にします。
大会名の表記ゆれ「Series VIII」と「Series 8」など。正規化する場合は対応表を spec.md に明記します。
複合ポジションP, OF / IF/P / 3B, P など。区切りは , と / の両方があります。
年とシーズンUAAP は開催年とシーズン番号が一致しません。年から推定しません。
プレースホルダ大学名は裏付け未確認 は実データではありません。集計から除外します。
重複行代表ロースターは同一選手が複数大会に出場すると行が重複します。選手単位で数える場合は名寄せが必要です。

検証

validate.py が UTF-8、必須列、必須値、URL、日付形式、出典ドメインを検査します。--strict は警告もエラーとして扱います。

python3 .opencode/skills/phb-validate-baseball-data/scripts/validate.py --strict
検査内容
文字コードUTF-8 として読めるか
必須列各ファイルの必須列が存在するか
必須値必須列が空欄でないか。URL列も必須
URLhttp(s):// で始まるか
日付YYYY-MM-DD 形式か
出典ドメイン既知の出典ドメインと突合するか

アプリへの切り出し

アプリは data/ を直接読みません。各アプリの data/build-data.py が JSON を生成し、index.html がそれを相対パスで fetch します。再実行すると同じ結果になることが要件です。

元データ生成物アプリ
baseball-news.csvnews.jsonnews-digest
uaap-players.csv / lbp-players.csv / national-team-players-colleges.csv / national-team-rosters.csvplayers.jsonplayer-database
baseball-game-videos.md / baseball-game-video-summaries.mdvideos.jsonvideo-guide
news / rosters / videostimeline.jsontimeline
兄弟アプリの JSONapps.jsonportal
cd apps/<name>/data
python3 build-data.py

生成物は apps/<name>/data/ にあります。手で編集せず、必ずスクリプトから再生成します。