Naver News Search

このスキルが行うこと

k-skill-proxyが Naver Search Open API のニュース検索(openapi.naver.com/v1/search/news.json)を呼び出し、最新のニュース記事候補を正規化された JSON で返す。

• 検索キーワードに基づいて最新ニュース候補の一覧を整理する。
• 記事のタイトル、本文要約(description)、配信時刻(pub_date/pub_date_iso)、Naver ニュースリンク(link)、原文リンク(original_link)を提供する。
• Naver が応答に混ぜ込む <b> ハイライトタグと HTML エンティティ(&, ", < など)は、プロキシ側であらかじめ削除する。
• ユーザーログイン、パーソナライズ、会員限定ニュースは対応しない。

使用する場合

• 「今日のサムスン電子関連ニュースを探して」
• 「最近の AI 規制関連記事を最新順で 5 件だけ」
• 「Naver ニュースから金利引き上げ記事を要約して」
• 「この事件の記事リンクを整理して」

使用しない場合

• 特定のメディア社内有料記事、ログイン後のみ表示される記事
• 記事本文全体が必要な場合 (API は要約 description のみ提供)
• 株価/為替/不動産リアルタイム相場 (ニュース API は記事のみ対象)
• ブロック/CAPTCHA 回避が必要なパス

必須入力

検索キーワード(q / query)がない場合は、まず確認する。

推奨質問:

検索する Naver ニュースのキーワードを教えてください。例: 「サムスン電子 実績」、「人工知能 規制」、「金利 引き上げ」

2 文字未満の単語は意味が不明確なため、再確認する。

Proxy エンドポイント

デフォルトは public/read-only/no-auth プロキシである。ユーザーは Naver Developer Center の Client ID/Secret を発行する必要がない。upstream key(NAVER_SEARCH_CLIENT_ID / NAVER_SEARCH_CLIENT_SECRET)はプロキシサーバーのみで注入される。

curl -fsS --get "${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}/v1/naver-news/search" \
  --data-urlencode 'q=삼성전자 실적' \
  --data-urlencode 'display=10' \
  --data-urlencode 'sort=date'

クエリパラメータ:

• q または query — 検索キーワード。2 文字以上。
• display — 返却件数。デフォルト 10、範囲 1~100。
• start — 検索開始位置(1-indexed)。デフォルト 1、最大 1000。start + display - 1 は 1000 を超えることはできない: 例えば start=1000 & display=100 は 1099 番目のアイテムを要求するため、プロキシは upstream 呼び出し前に 400 bad_request("start + display exceeds Naver's 1000-item search window")で拒否する。非常に古い記事を探すには、検索キーワードを狭めるのが望ましい。
• sort — sim(関連度順、デフォルト値) または date(最新順)。その他の値は sim に fallback する。

レスポンスの主要フィールド:

• items[].title — <b> タグ・HTML エンティティが削除された記事タイトル
• items[].description — <b> タグ・HTML エンティティが削除された記事要約
• items[].link — Naver ニュースリダイレクトリンク
• items[].original_link — 原文ニュースリンク(空文字列の場合は null)
• items[].pub_date — 原本 RFC822 形式の配信時刻
• items[].pub_date_iso — パース済み ISO-8601(UTC)配信時刻。パース失敗時は null
• meta.extraction — 常に naver-openapi
• meta.total, meta.start, meta.display, meta.last_build_date, meta.sort

ワークフロー

1. 検索キーワードを確認する。(ない、または 2 文字未満の場合はまず確認する)
2. ユーザーが「最新順」を望む場合は sort=date、その他の場合は sort=sim で呼び出す。
3. GET /v1/naver-news/search を呼び出す。
4. items があれば、上位 3~5 件をタイトル、配信時刻(KST 基準で再フォーマットしてもよい)、要約、リンクで短く整理する。
5. 配信時刻は pub_date_iso を基準に、今日/昨日の表記を付けてもよい。(KST = UTC+9)
6. items が空または upstream_error が発生した場合、再試行せず検索キーワードを狭めて再度確認する。

レスポンススタイル

• 記事タイトル/要約は API が返した原文のみを引用する。原文にない解説は付け加えない。
• 記事配信時刻は「KST 基準 {YYYY-MM-DD HH:mm}」または「{n}時間前」程度で短く表示する。
• 原文リンク(original_link)がある場合は優先的に表示し、ない場合は link(Naver ニュースリダイレクト)を案内する。
• 異なるメディアが同じ事件を扱う場合は、リンク 2~3 個を並列で提示し、ユーザーが比較できるようにする。
• description は要約なので、事実として断定せず「記事要約によると」と伝える。

失敗モード

• 400 bad_request — 検索キーワード漏落、2 文字未満、許可されないパラメータ、または start + display - 1 > 1000 の組み合わせ(Naver 1000-item search window 超過)。エラーメッセージをそのままユーザーに表示する。
• 503 upstream_not_configured — プロキシサーバーに NAVER_SEARCH_CLIENT_ID/NAVER_SEARCH_CLIENT_SECRET がない場合。運営者がキーを登録する必要がある。ユーザーには「しばらく経ってからもう一度お試しください」程度で案内する。
• 401 upstream_error — プロキシサーバーの Client ID/Secret が誤っている場合(errorCode: 024)。運営者が再発行する必要がある。
• 429 upstream_error — Naver Search API 日次クォータ(25,000 呼び出し/日)超過(errorCode: 010)。再試行ループは禁止。しばらく経ってからもう一度お試しするよう案内する。
• 502 upstream_error — Naver API 5xx またはレスポンス JSON パース失敗。
• upstream ブロックまたは障害発生時は再試行しない。cache + rate limit のみで対応し、ユーザーには現在の照会が不可能なことを明確に伝える。

プライバシー

• 検索キーワード/結果を永続保存しない。
• 記事本文は要求しない。description(API が提供する要約)のみを使用する。
• 特定の人物・事件に対する非難・推測の記述はしない。記事原文のみを伝える。

完了条件

• 検索キーワードを確認した。
• 最低 1 件以上の記事をタイトル・要約・配信時刻・リンクで整理して返すか、結果がない理由を説明した。
• 配信時刻は KST 基準で表示した。
• Naver API クォータ状態・ブロック発生の有無・再試行禁止原則を守った。
• ログイン/パーソナライズ/ブロック回避の範囲を逸脱しなかった。