o-sumo

Agentsの対応状況はこちら

English README

o-sumo は、大相撲の番付、取組、力士・行司・呼出名鑑を配信する Web アプリです。React 19 + TypeScript + Vite で構築し、Cloudflare Pages からサイトと JSON API を公開しています。AI エージェント向けには MCP、WebMCP、Markdown 表示と発見用メタデータを用意しています。

2026年11月4日から、エンドユーザー向けに相撲データをMCPで配信しています。導入手順

目次

• ドキュメント一覧
• 概要
• AIエージェントから利用する
• 主な機能
• 技術スタック
• ローカル開発
• データ更新
• 自動更新
• テスト
• Cloudflare Pages
• 令和八年十一月場所の更新運用
• 主要ファイル
• 連絡先
• ライセンス
• ダウンロード

ドキュメント一覧

• README: README.md / README_en.md
• 開発ガイド: DEVELOPMENT.md / DEVELOPMENT_en.md
• MCP 連携キット: mcp/README.md
• Skills 一覧: SKILLS.md / SKILLS_en.md
• API 仕様: docs/api/v1.md / docs/api/v1.en.md
• API ポリシー: docs/api/policy.md / docs/api/policy.en.md
• API 変更履歴: docs/api/changelog.md / docs/api/changelog.en.md
• 力士プロフィール・合い口更新手順: docs/rikishi-profile-refresh-runbook.md
• 行司・呼出データ更新手順: docs/official-profile-refresh-runbook.md
• エージェント向けガイド: docs/agent-ready.md

概要

• Web ルート:
  • ホーム: /
  • 過去場所一覧: /archives
  • 力士一覧: /rikishi
  • 力士プロフィール: /rikishi/{id}
  • マイ力士: /my-rikishi/
  • プライバシーポリシー: /privacy/
  • 力士比較: /compare/?ids={id1},{id2}
  • 行司名鑑: /gyoji/
  • 行司プロフィール: /gyoji/{id}/
  • 呼出名鑑: /yobidashi/
  • 呼出プロフィール: /yobidashi/{id}/
  • 番付: /{YYYYMM}-banzuke/
  • 結果ハブ: /{YYYYMM}-torikumi
  • 予定ハブ: /{YYYYMM}-yotei
  • 日別結果: /{YYYYMMDD}-torikumi
  • 日別予定: /{YYYYMMDD}-yotei
  • 決まり手: /kimarite
  • 場所ステータス分析: /analytics/
• 現行ルート例:
  • /202611-banzuke/
  • /202611-torikumi/
  • /20261108-yotei/
  • /compare/?ids=3842,4227
  • /kimarite
• 読みもの: https://blog.osada.us/
• /202609-o-sumo/ などの対応済み旧番付 URL は、同じ場所の月別番付を表示します。/archives/cat11/ などの廃止済み URL は HTTP 410 を返します。
• 公開 API:
  • /api/v1/banzuke.json
  • /api/v1/torikumi.json
  • /api/v1/rikishi.json
  • /api/v1/rikishi/{id}.json
  • /api/v1/rikishi-matchups.json
  • /api/v1/gyoji.json
  • /api/v1/gyoji/{id}.json
  • /api/v1/yobidashi.json
  • /api/v1/yobidashi/{id}.json
  • /api/v1/news.json
  • /api/v1/blog.json

関連ドキュメント:

• docs/api/v1.md
• docs/api/policy.md
• docs/api/changelog.md
• DEVELOPMENT.md

Skill 公開:

• SKILLS.md
• public/.well-known/agent-skills/osumo-content/SKILL.md
• public/.well-known/agent-skills/osumo-discovery/SKILL.md
• skills/osumo-api/SKILL.md

AIエージェントから利用する

AIエージェント向け利用ガイドから、クライアント別の導入手順とJSON API仕様を参照できます。公開 JSON API、公開スキル、相撲データ用 MCP は、o-sumo のアカウントや API キーなしで利用できます。 検索と回答生成時の参照を許可し、モデル学習は許可しません（search=yes, ai-input=yes, ai-train=no）。

目的	入口
APIを見つける	公開JSON APIの案内
番付・取組・力士データをツールで取得する	相撲データ用MCP連携キット
記事やプロフィールを自然言語で探す	AI Search MCPの案内
取得方法・ページURLを調べる	Agent Skillsの案内
認証方針を確認する	利用条件と認証方針
対応範囲・運用を確認する	エージェント向けガイド

上の表は人が読むための案内ページです。機械向けのURLは案内ページに記載しています。

torikumi.json の bashoId は通し番号です。月は pathDate の先頭6桁から求め、 予定・結果は各配列の status と更新時刻を確認してください。 ホーム・主要一覧・月別ページと、公開データに存在する日別予定/結果は Accept: text/markdown で取得できます。個別人物ページなど未対応ルートはHTMLを返します。

相撲データ用 MCP は Streamable HTTP（https://osada.us/mcp）の読み取り専用サーバーで、search_rikishi、 get_rikishi_profile、get_banzuke、get_torikumi、list_basho を提供します。 クライアント別の導入手順で、接続方法と開発者向け設定例を確認できます。 AI Search MCP は自然言語検索用の search ツールを提供します。

curl -fsS https://osada.us/.well-known/agent-skills/index.json
curl -fsS https://osada.us/mcp/server-card
curl -fsS https://osada.us/api/v1/torikumi.json
curl -i -H 'Accept: text/markdown' https://osada.us/20261108-yotei/

対応ブラウザーでは別途 WebMCP の4ツール（search_rikishi、list_basho、 get_banzuke_for_month、get_torikumi_for_day）をページ内で登録します。これは上記の リモート MCP エンドポイントとは別の仕組みです。A2A カードは発見用で、タスク操作は未実装です。

This is the beginning of the README. Read the rest at the original. Read the full README ↗