Log inSign up

swdu

yahoo_realtime

Public
Yahooリアルタイム検索のラッパー
Edit with AI
1 Branch
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
mcp.ts
README.md

yahoo_realtime (yjrt)

Yahoo!リアルタイム検索APIをトークン消費の少ないTOON形式で返すLLM向けラッパー。

エンドポイント

https://yjrt.val.run/

リクエスト

GET

?q=<keyword>&n=<1-200>&mode=<full|compact|compactpp>

POST（日本語クエリのURLエンコード不要）

curl -X POST https://yjrt.val.run/ \
  -H "Content-Type: application/json" \
  -d '{"q":"堀江晶太","n":20,"mode":"compact"}'

パラメータ

名前型既定説明
qstring必須検索キーワード
nint20取得件数（1〜200）。40超で時系列順に自動切替
modeenumfull出力モード（下記）

モード

modetext内URL除去urlフィールド用途
fullしないあり既定。元情報そのまま
compactするありLLM要約向け、引用元は保持
compactppするなし純粋なトレンド把握、最小トークン

ソート挙動

  • n ≤ 40: Yahoo md=h（人気順）。1コール。
  • n > 40: Yahoo md=r（時系列順）に自動切替。最大5コール（=200件）。
    • 人気順だとページネーション時に重複が発生するため、時系列順に固定。
    • レスポンスの sort_mode フィールドで実際の値（popularity / recent）を確認可能。

レスポンスヘッダ

  • Content-Type: text/toon; charset=utf-8
  • X-Fetched-At: ISO8601タイムスタンプ
  • X-Upstream-Calls: 上流Yahooへの実コール数（1〜5）

レート制限

Render経由で x-ratelimit-limit: 5000 / 60s がデフォルトでかかる。

制約

  • 1リクエスト最大200件（Val Town free tierの60秒wall-clock内に収まる設計）
  • Yahoo側の事情で md=h 人気順は重複あり（dedupeで対処済み）