Data Sources

データソース

CEI は公開 API と手動整備レジストリを組み合わせてスコアを算出しています。 このページは いま何を見て、どう扱っているかを公開し、透明性と再現性を担保するためのものです。

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 で最優先再試行します。障害の因果を後から辿れる設計です。