FactSpot widget

FactSpot のスコアを CMS に埋め込む

WordPress ・ Notion ・ 自前の静的サイトなど、任意の場所に FactSpot のスコアを表示できる公開ウィジェットです。認証は不要、最新の overall スコアを 1 時間キャッシュで返します。

1. iframe で貼る (もっとも簡単)

記事 URL を query string にして読み込むだけ。HTML スニペットが返ります。

<iframe
  src="/api/widget/embed?url=https%3A%2F%2Fexample.com%2Farticle-path"
  width="380"
  height="80"
  frameborder="0"
  scrolling="no"
  title="FactSpot score">
</iframe>

プレビュー (この URL は実在しないのでスコアは「未計測」):

2. JSON で取得して自前で表示

スタイルをサイト側で完全に制御したい場合は、こちらの JSON エンドポイントを使ってください。

GET /api/widget/score?url=https%3A%2F%2Fexample.com%2Farticle-path

// Response
{
  "url": "https://example.com/article-path",
  "score": 82,            // number | null
  "lastChecked": "2026-06-18T01:23:45Z"
}

CORS: 全オリジン許可 (Access-Control-Allow-Origin: *)。キャッシュ: 1 時間 (Cache-Control: public, max-age=3600)。

注意事項 (MVP)

  • ・ 現在は 公開エンドポイント です。url パラメータと一致する最新の check 行を、ユーザーを問わず 1 件だけ返します。
  • ・ ユーザーごとのスコア秘匿が必要になったら、署名付きトークン (?token=...) で絞り込む予定です。
  • ・ サイト owner だけに見せたい場合は今は埋め込まないでください。

← FactSpot へ戻る