Webz.io News Search

공식

자연어를 사용하여 전 세계 뉴스를 검색합니다. Webz.io News Search API는 출처, 국가, 언어, 날짜, 감정, 카테고리 필터와 함께 가장 관련성 높은 기사와 콘텐츠를 반환합니다.

Webz Io News Search MCP(으)로 무엇을 할 수 있나요?

  • 주제별 글로벌 뉴스 검색 — 모든 주제에 대한 최근 보도를 요청하면 news_search_by_webz가 제목, URL, 날짜, 발췌문이 포함된 일치하는 기사를 반환합니다.
  • 출처 또는 엔터티별 필터링 — domain, person, organization, location, ticker, political_bias 같은 매개변수를 사용하여 결과를 좁혀 특정 매체나 주제를 대상으로 지정할 수 있습니다.
  • 최신성 및 볼륨 제어 — days(1–50개 기사, k 사용)를 설정하여 최신 뉴스를 얻거나 전체 아카이브를 검색하는 데 사용할 수 있습니다.
  • 관련성 점수 조정 — 최소 또는 최대 일치 점수를 설정하거나 하한선을 완전히 비활성화하는 데 사용합니다.
  • 기사당 여러 발췌문 가져오기 — 동일한 출처에서 둘 이상의 관련 텍스트 청크를 검색하려면 활성화합니다.

문서

AI 클라이언트(Cursor, Claude, ChatGPT 또는 n8n)를 Webz.io News Search에 연결하세요. 클라이언트는 news_search_by_webz 도구를 받아 전 세계 뉴스를 자체적으로 검색할 수 있습니다.

https://news-search-mcp.webz.io/mcp

1단계: API 토큰 받기

계정이 없으신가요? 무료로 가입하여 API 토큰을 받으세요.

webz.io에 로그인하고 대시보드에서 API 토큰을 복사하세요. News Search API에 사용하는 것과 동일한 토큰입니다.

2단계: 클라이언트 연결

YOUR_WEBZ_TOKEN을(를) 본인의 토큰으로 교체하세요.

Cursor

~/.cursor/mcp.json(Windows에서는 %USERPROFILE%\.cursor\mcp.json)에 다음을 추가하고 Cursor를 다시 시작하세요:

{
  "mcpServers": {
    "webz-news-search": {
      "url": "https://news-search-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Claude Desktop

동일한 webz-news-search 항목을 Claude Desktop 구성 파일에 병합하세요(전체 파일을 교체하지 마세요). 그런 다음 Claude Desktop을 다시 시작하세요:

OS구성 파일
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Claude Code

프로젝트 루트에서 실행하세요:

claude mcp add --transport http webz-news-search https://news-search-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

n8n

MCP Client Tool 노드를 추가하고 AI Agent 노드의 Tool 입력에 연결하세요:

필드값
Endpointhttps://news-search-mcp.webz.io/mcp
Server TransportHTTP Streamable
AuthenticationBearer Auth
Tools to IncludeAll

Bearer Auth 자격 증명을 만들고 Webz.io API 토큰을 bearer 토큰으로 붙여넣으세요. 커뮤니티 노드, 독립형 워크플로 및 준비된 템플릿에 대한 자세한 내용은 n8n 통합을 참조하세요.

Claude.ai 및 ChatGPT(웹)

https://news-search-mcp.webz.io/mcp을(를) 사용자 지정 커넥터로 추가하세요(Claude.ai: 설정 > 커넥터, ChatGPT: 설정 > 앱 및 커넥터에서 개발자 모드 켜기). 둘 다 OAuth를 사용합니다: Client ID와 Secret은 비워 두고, 승인 페이지에서 Webz 토큰을 붙여넣으세요. 전체 단계별 가이드: news-search-mcp.webz.io.

브라우저에서 /mcp 엔드포인트를 열면 설계상 401 Unauthorized이(가) 반환됩니다. 브라우저는 토큰을 보내지 않기 때문입니다. MCP 클라이언트를 사용하세요.

3단계: 사용해 보기

AI 클라이언트에게 자연스럽게 요청하세요. "news" 또는 "Webz"를 언급하면 도구 선택에 도움이 됩니다:

  • "EU AI 규제에 대한 최근 발전 사항을 Webz 뉴스에서 검색하고 출처와 함께 요약해 줘."
  • "Webz 뉴스 도구를 사용해 지난주 이스라엘과 그리스 간 무역 협정에 대한 보도를 찾아줘."
  • "news_search_by_webz를 호출해서 '재생 에너지 투자'를 k=10, days=30으로 검색한 다음 요약해 줘."

도구 참조

news_search_by_webz

매개변수기본값설명
query필수자연어 주제 또는 질문
k10반환할 기사 수(1-50)
days7검색할 과거 일수
allow_all_datesfalsedays 대신 전체 보도 기간을 검색
score_gte4최소 일치 점수, 0-10(하한을 비활성화하려면 0 설정)
score_lte-최대 일치 점수, 0-10
domain-특정 소스 도메인만, 예: cnn.com, yahoo.com
exclude_domain-제외할 소스 도메인, 도메인은 두 목록에 동시에 포함될 수 없음
language, country, sentiment, category-필터와 동일한 값, 국가 코드는 ISO-2 대문자(US, GB)
topic-주제 태그(대소문자 구분 없음)
person, organization, location-엔터티 이름(대소문자 구분 없음)
ticker-주식 티커 기호, 예: AAPL(대소문자 구분 없음)
political_bias-소스 정치 성향: left, center, right
domain_rank_gte, domain_rank_lte-소스 도메인 순위 범위(정수)
allow_multiple_chunks_per_articlefalsetrue로 설정하면 동일한 기사에서 관련 청크를 여러 개 반환

각 결과는 기사 제목, URL, 게시 날짜, 일치하는 텍스트 발췌 및 메타데이터(topic, person, organization, location, ticker, political_bias, domain_rank)를 반환합니다.

모든 도구 호출은 토큰으로 일반 News Search 요청을 실행합니다. 동일한 크레딧과 요율 제한이 적용됩니다. 오류, 요율 제한 및 크레딧을 참조하세요.

토큰 안전하게 보관하기

토큰을 git에 커밋하거나 URL에 넣지 마세요.

환경 변수로 한 번 설정하고 구성에서 참조하세요:

"Authorization": "Bearer ${env:WEBZ_API_TOKEN}"

다음 단계