External APIs
外部 API (8)
Wikipedia Pageviews API
Attention (注目度)直近 7 日 / 90 日の日本語版ページビュー。Momentum モードの主力シグナル。短期話題性と長期地力の両軸に使用。
公式ドキュメントAniList GraphQL API
Fandom (ファンダム厚み)各 IP のファン登録数・評価分布・キャラクター構造。Core モードの主力シグナルで、長期的な支持基盤を測る。
公式ドキュメントGoogle Trends (via SerpAPI)
Search Demand (検索需要)検索需要の相対推移。HOT TOPIC のキャッチアップ用に利用。生のトレンド変動を週次で取得。
公式ドキュメントYouTube Data API
Official Channel Activity公式チャンネルの動画公開・再生数推移。新作告知・劇場版・イベントの効果測定に使用。
公式ドキュメントTMDb API
Film / TV Metadata映画・TV シリーズのメタデータ (公開年・評価・ポスター)。映画カテゴリ接続用。
公式ドキュメントAmazon Product Advertising API
EC Sales Rank関連商品の Amazon ランキング。アフィリエイト経由で独自に購買シグナルも取得予定。
公式ドキュメントRakuten Ichiba API
EC Sales (JP)楽天市場の関連商品ランキング。日本国内 EC の独立ソース。
公式ドキュメントSteam Web API
Game Playtime / Concurrent Usersゲーム原産 IP の同時接続プレイヤー数・レビュー数。/works/game 接続用。
公式ドキュメントInternal Registries
手動レジストリ (4)
外部 API はシグナルを供給しますが、「何を観測対象にするか」は手動で管理しています。 レジストリの範囲が CEI の網羅性を決める最も重要な変数です。
IP_REGISTRY
221 件CEI スコアリング対象の漫画発 IP 群。漫画雑誌系の connection keys (wikipediaTitle / trendsQuery / youtubeQuery) を整備。
src/lib/cei/ip-registry.ts
CHARACTER_REGISTRY
548 件キャラクター単体の CEI スコアリング対象。AniList ID ベースの stable slug で管理。
src/lib/cei/character-registry.ts
WORKS_REGISTRY
40 件非漫画発 IP のカタログ (アニメ発 / ゲーム発 / 映画発 / オリジナル)。/works/{category} の駆動源。CEI スコア対象ではなく表示専用。
src/lib/cei/works-registry.ts
CONTEST_REGISTRY
6 件 / winners 25 件賞・コンテストのカタログ。winners 年表 + 関連 IP 接続。/awards セクションの駆動源。
src/lib/cei/contest-registry.ts
Principles
運用原則
① リクエスト時は外部 API を呼ばない — 全ての外部取得は日次 cron で事前に済ませ、KV snapshot から読み出します。 ページ表示が外部サービスのレート制限・障害に左右されない設計です。
② 全件取得の禁止 — 221 IP 全件の外部取得は Vercel Pro の 800s タイムアウトに抵触するため、 Priority IP Import Mode で Tier 1/2/3 に分割して段階取得しています (詳細は Methodology)。
③ 失敗は機械分類して記録 — 429 rate_limit / 404 not_found / timeout などを区別して KV に保存し、 次回 cron で最優先再試行します。障害の因果を後から辿れる設計です。