search_realtime
Retrieve recent posts from Yahoo! Real-time Search with filters for query, sort order, media type, and date range.
Instructions
Yahoo!リアルタイム検索で最近の公開投稿を検索します。
現在の反応、トレンド、ハッシュタグ、アカウント指定検索、日本語圏の話題、 画像や動画付き投稿を探すときに使います。一般的な Web 検索や公式情報の確認には 使わないでください。
主な引数:
query: 検索語です。"#hashtag", "-word", "A OR B", "ID:username", "@username", "URL:domain" などの検索演算子も使えます。
sort: "latest" は新着順、"popular" は反応が多い投稿を優先します。
media_type: "image", "video", "all" を指定できます。標準は "image" です。
limit: 1 ページあたりの件数です。1 から 40 まで指定できます。
pages: 取得するページ数です。1 から 25 まで指定できます。ページ数が増えるほど API へのリクエストも増えます。
start: 取得開始位置です。
since / until: Unix 秒、または ISO 8601 形式の日時を指定できます。
output_format: 標準は "markdown" です。構造化データが必要なときは "compact_json"、詳しい整形済みデータが必要なときは "full_json"、元 API の レスポンス確認には "raw_json" を使います。
Markdown 出力の構造:
H1 に検索語を表示します。
先頭の箇条書きに取得件数、推定総件数、検索条件を表示します。
投稿ごとに H3 を作り、著者、ISO 形式の投稿時刻、反応数、投稿リンクを表示します。
投稿本文は Yahoo 側の displayTextBody/displayText 由来で、引用として表示します。
外部リンクは Markdown の箇条書きで表示します。タイトルがある場合は title、 ない場合は display URL または URL を使います。
メディア URL はラベルを繰り返さず、通常の箇条書きで表示します。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| sort | No | latest | |
| media_type | No | image | |
| limit | No | ||
| pages | No | ||
| start | No | ||
| oldest_tweet_id | No | ||
| since | No | ||
| until | No | ||
| output_format | No | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |