naver-news-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Naver News Search

Naver新闻搜索

What this skill does

本Skill的功能

k-skill-proxy

가 네이버 검색 Open API 뉴스 검색(

openapi.naver.com/v1/search/news.json

)을 호출해 최근 뉴스 기사 후보를 정규화된 JSON 으로 돌려준다.

검색어 기반 최신 뉴스 후보 목록을 정리한다.
기사 제목, 본문 요약(description), 발행 시각(
```
pub_date
```
/
```
pub_date_iso
```
), 네이버 뉴스 링크(
```
link
```
), 원문 링크(
```
original_link
```
)를 제공한다.
Naver 가 응답에 섞어주는
```

```
하이라이트 태그와 HTML entity(
```
&amp;
```
,
```
&quot;
```
,
```
&lt;
```
등)는 proxy 쪽에서 미리 제거한다.
사용자 로그인·개인화·회원 전용 뉴스는 지원하지 않는다.

k-skill-proxy

调用Naver搜索Open API的新闻搜索接口（

openapi.naver.com/v1/search/news.json

），将近期新闻候选结果以规范化的JSON格式返回。

整理基于搜索词的最新新闻候选列表。
提供新闻标题、正文摘要（description）、发布时间（
```
pub_date
```
/
```
pub_date_iso
```
）、Naver新闻链接（
```
link
```
）、原文链接（
```
original_link
```
）。
Naver响应中混入的
```

```
高亮标签和HTML实体（
```
&amp;
```
、
```
&quot;
```
、
```
&lt;
```
等）由proxy预先移除。
不支持用户登录、个性化及会员专属新闻。

When to use

适用场景

"오늘 삼성전자 관련 뉴스 찾아줘"
"최근 AI 규제 관련 기사 최신순으로 5개만"
"네이버 뉴스에서 금리 인상 기사 요약해줘"
"이 사건 기사 링크 정리해줘"

"帮我找今天三星电子相关的新闻"
"最近AI监管相关的新闻，只要最新的5条"
"帮我总结Naver新闻里关于加息的报道"
"帮我整理这个事件的新闻链接"

When not to use

不适用场景

특정 언론사 내부 유료 기사, 로그인 뒤에만 보이는 기사
기사 본문 전체가 필요한 경우 (API 는 요약 description 만 제공)
주식/환율/부동산 실시간 시세 (뉴스 API 는 기사만 다룬다)
차단/CAPTCHA 우회가 필요한 경로

特定媒体内部的付费新闻、需登录才能查看的新闻
需要新闻全文的情况（API仅提供摘要description）
股票/汇率/房地产实时行情（新闻API仅处理新闻报道）
需要绕过拦截/CAPTCHA的路径

Required inputs

必填输入

검색어(

query

)가 없으면 먼저 물어본다.

권장 질문:

찾을 네이버 뉴스 검색어를 알려주세요. 예: "삼성전자 실적", "인공지능 규제", "금리 인상"

단어 2글자 미만이면 의미가 불분명하므로 되묻는다.

若无搜索词（

query

），则先询问用户。

推荐提问：

请告知您要查找的Naver新闻搜索词。例如：“三星电子业绩”、“人工智能监管”、“加息”

若搜索词不足2字，因含义不明确，需再次询问用户。

Proxy endpoint

代理端点

기본값은 public/read-only/no-auth 프록시다. 사용자는 네이버 개발자 센터 Client ID/Secret 을 발급받지 않아도 된다. upstream key(

NAVER_SEARCH_CLIENT_ID

NAVER_SEARCH_CLIENT_SECRET

)는 프록시 서버에서만 주입한다.

bash

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
```
번째 아이템을 요구하므로 proxy가 업스트림 호출 전에
```
400 bad_request
```
("start + display exceeds Naver's 1000-item search window")로 거절한다. 아주 오래된 기사를 찾으려면 검색어를 좁히는 것이 낫다.
```
sort
```
—
```
sim
```
(유사도 순, 기본값) 또는
```
date
```
(최신순). 그 외 값은
```
sim
```
으로 fallback.

응답 주요 필드:

```
items[].title
```
—
```

```
태그·HTML entity 가 제거된 기사 제목
```
items[].description
```
—
```

```
태그·HTML entity 가 제거된 기사 요약
```
items[].link
```
— 네이버 뉴스 redirect 링크
```
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

默认使用公共/只读/无认证的代理。用户无需在Naver开发者中心申请Client ID/Secret。上游密钥（

NAVER_SEARCH_CLIENT_ID

NAVER_SEARCH_CLIENT_SECRET

）仅在代理服务器中注入。

bash

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开始计数），默认1，最大1000。start + display - 1
不得超过1000：例如
```
start=1000 & display=100
```
会请求第1099条数据，proxy会在调用上游接口前返回
```
400 bad_request
```
（“start + display 超出Naver的1000条搜索限制”）。如需查找较旧的新闻，建议缩小搜索词范围。
```
sort
```
—
```
sim
```
（按相似度排序，默认值）或
```
date
```
（按最新排序）。其他值将 fallback 为
```
sim
```
。

响应主要字段：

```
items[].title
```
— 已移除
```

```
标签和HTML实体的新闻标题
```
items[].description
```
— 已移除
```

```
标签和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

Workflow

工作流程

검색어를 확인한다. (없거나 2글자 미만이면 먼저 물어본다)
사용자가 "최신순"을 원하면
```
sort=date
```
, 그 외에는
```
sort=sim
```
으로 호출한다.
```
GET /v1/naver-news/search
```
를 호출한다.
```
items
```
가 있으면 상위 3~5건을 제목, 발행 시각(KST 기준으로 재포맷해도 좋다), 요약, 링크로 짧게 정리한다.
발행 시각은
```
pub_date_iso
```
기준으로 오늘/어제 표기를 붙여도 된다. (KST = UTC+9)
```
items
```
가 비었거나
```
upstream_error
```
가 나면 재시도하지 말고 검색어를 좁혀 다시 물어본다.

确认搜索词（若无或不足2字，则先询问用户）。
若用户要求“最新排序”，则使用
```
sort=date
```
，否则使用
```
sort=sim
```
调用接口。
调用
```
GET /v1/naver-news/search
```
接口。
若
```
items
```
有内容，则整理前3~5条的标题、发布时间（可重新格式化为KST时区）、摘要和链接，简洁呈现。
发布时间可基于
```
pub_date_iso
```
标注“今天/昨天”（KST = UTC+9）。
若
```
items
```
为空或出现
```
upstream_error
```
，请勿重试，需缩小搜索词范围后再次询问用户。

Response style

响应风格

기사 제목/요약은 API 가 돌려준 원문만 인용한다. 원문에 없는 해설은 덧붙이지 않는다.
기사 발행 시각은 "KST 기준 {YYYY-MM-DD HH:mm}" 또는 "{n}시간 전" 정도로 짧게 표시한다.
원문 링크(
```
original_link
```
)가 있으면 우선 노출하고, 없으면
```
link
```
(네이버 뉴스 redirect)를 안내한다.
서로 다른 언론사가 같은 사건을 다루면 링크 2~3개를 병렬로 제시해 사용자가 비교할 수 있게 한다.
```
description
```
은 요약이므로, 팩트로 단정하지 말고 "기사 요약에 따르면"이라고 전한다.

新闻标题/摘要仅引用API返回的原文，不得添加原文未有的解说。
新闻发布时间简洁表示为“KST 标准时间 {YYYY-MM-DD HH:mm}”或“{n}小时前”。
若有原文链接（
```
original_link
```
）则优先展示，若无则展示
```
link
```
（Naver新闻跳转链接）。
若不同媒体报道同一事件，可并列展示2~3个链接，方便用户对比。
因
```
description
```
是摘要，请勿断言事实，需以“据新闻摘要显示”开头表述。

Failure modes

失败场景

```
400 bad_request
```
— 검색어 누락, 2글자 미만, 허용되지 않는 파라미터, 혹은
```
start + display - 1 > 1000
```
조합(네이버 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
```
— 네이버 검색 API 일일 쿼터(25,000 호출/일) 초과(
```
errorCode: 010
```
). 재시도 루프는 금지. 잠시 후 다시 시도하도록 안내한다.
```
502 upstream_error
```
— 네이버 API 5xx 또는 응답 JSON 파싱 실패.
upstream 차단이나 장애 발생 시 재시도하지 않는다. cache + rate limit 만으로 대응하고, 사용자에게는 현재 조회 불가능함을 분명히 말한다.

```
400 bad_request
```
— 缺少搜索词、搜索词不足2字、参数不允许，或
```
start + display - 1 > 1000
```
（超出Naver的1000条搜索限制）。直接将错误信息告知用户。
```
503 upstream_not_configured
```
— 代理服务器未配置
```
NAVER_SEARCH_CLIENT_ID
```
/
```
NAVER_SEARCH_CLIENT_SECRET
```
。需管理员注册密钥。告知用户“请稍后重试”。
```
401 upstream_error
```
— 代理服务器的Client ID/Secret错误（
```
errorCode: 024
```
）。需管理员重新申请。
```
429 upstream_error
```
— 超出Naver搜索API每日调用限额（25,000次/天）（
```
errorCode: 010
```
）。禁止重试循环。告知用户请稍后重试。
```
502 upstream_error
```
— Naver API返回5xx错误或响应JSON解析失败。
上游被拦截或发生故障时，请勿重试。仅通过缓存+速率限制应对，并明确告知用户当前无法查询。

Privacy

隐私说明

검색어/결과를 영구 저장하지 않는다.
기사 본문은 요청하지 않는다. description(API 가 주는 요약)만 사용한다.
특정 인물·사건을 비방·추측하는 서술은 하지 않는다. 기사 원문만 전달한다.

不永久存储搜索词/结果。
不请求新闻全文，仅使用API提供的摘要（description）。
不添加诽谤/猜测特定人物·事件的表述，仅传递新闻原文。

Done when

完成标准

검색어를 확인했다.
최소 1건 이상의 기사를 제목·요약·발행 시각·링크로 정리해서 돌려주거나, 왜 결과가 없는지 설명했다.
발행 시각은 KST 기준으로 표시했다.
네이버 API 쿼터 상태·차단 발생 여부·재시도 금지 원칙을 지켰다.
로그인/개인화/차단 우회 범위를 벗어나지 않았다.

已确认搜索词。
已整理至少1条新闻的标题、摘要、发布时间、链接返回给用户，或已说明无结果的原因。
发布时间已按KST时区显示。
遵守了Naver API限额状态、拦截情况及禁止重试的原则。
未超出登录/个性化/绕过拦截的范围。