Cloudflare Workers + Hono + D1 を前提にした、公開授業情報の蓄積型 API 基盤です。
- Cloudflare 上では
Workers + D1 + Queuesのみを使い、R2 や有料アドオンは使いません。 - 原本 HTML/PDF は Cloudflare に保存せず、必要な fixture のみ
test/fixtures/parsers/を Git 管理します。 wrangler.jsoncではobservabilityを明示的に有効化せず、追加のログ/トレース課金リスクを避けます。- カスタムドメインは
k-tkms.comの Cloudflare zone 上でshimadai.k-tkms.comのようなサブドメインを Worker に割り当てる前提です。 - 取得処理は Cloudflare Queues で小分けに実行し、Workers Free の subrequest 制限を回避します。
- 無料枠を超えない限り 0 円運用を維持し、超過時は free tier の制限エラーで止まる前提です。
npm run dev: ローカル開発npm run test: テスト実行npm run typegen: Wrangler の binding 型生成npm run cf-typecheck: 型生成 + TypeScript 検査
- 公開 REST API:
/api/courses/*,/api/guides/*,/api/notices/* - 管理 API:
/admin/fetch,/admin/reparse,/admin/jobs - OpenAPI:
/openapi.json,/docs - MCP:
/mcp
POST /mcpで authless の公開 MCP を提供します。- 公開するのは
courses,guides,noticesの検索・詳細取得だけで、既存 REST API と同じ公開データ範囲に限定します。 - ツール:
search_courses,get_coursesearch_guides,get_guidesearch_notices,get_notice
- リソース:
shimadai://meta/service-overviewshimadai://meta/api-guideshimadai://courses/{id}shimadai://guides/{id}shimadai://notices/{id}
- プロンプト:
course_advisingdeadline_check
- ブラウザ系クライアントや MCP Inspector で使えるよう、
localhost:5173と同一ホストを既定で許可します。 - 必要なら
MCP_ALLOWED_ORIGINSにカンマ区切りで origin を追加できます。
ADMIN_API_KEYはwrangler secret put ADMIN_API_KEYで設定します。- D1 の実 ID は
wrangler.jsoncを更新して使います。 - Queue
school-api-fetch-queueを作成し、wrangler.jsoncの producer / consumer binding を使います。 - ローカルでは
wrangler devのローカルシミュレーションを使います。
- Cloudflare 側には原本 HTML/PDF を保存しません。
- Cloudflare 側に保持するのは正規化済みデータ、出典 URL、取得日時、ハッシュ、パース用メタデータのみです。
- パーサ回帰確認や構造変更追従に使う原本は
test/fixtures/parsers/に Git 管理で保持します。 POST /admin/reparseは Cloudflare に保存済み原本を読むのではなく、source_urlを再取得して再パースします。
- D1
school-api-dbはTakemasa0302@gmail.comの Cloudflare アカウントに作成済みdatabase_id:f6e12d2c-fbd9-4e78-9ca0-760a5d46a750 - Queue
school-api-fetch-queueは同アカウントに作成済み - 初期 migration は D1 に適用済み
- ローカル開発用の
ADMIN_API_KEYは.dev.varsに設定済み k-tkms.comzone は同アカウント上でactiveな Cloudflare zone として存在
- このリポジトリ内には Cloudflare の請求アラートを自動作成する設定はまだありません。
- Cloudflare API で通知ポリシーの確認を試しましたが、現在の API 権限では
alerting/v3が10000 Authentication errorで確認できませんでした。 - D1 の billing notifications は Cloudflare dashboard 上で
Rows Read/Rows Writtenを対象に設定可能です。 - 実運用前に Cloudflare dashboard の Notifications で billing usage alert を追加してください。