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 입력에 연결하세요:
| 필드 | 값 |
|---|---|
| Endpoint | https://news-search-mcp.webz.io/mcp |
| Server Transport | HTTP Streamable |
| Authentication | Bearer Auth |
| Tools to Include | All |
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 | 필수 | 자연어 주제 또는 질문 |
| k | 10 | 반환할 기사 수(1-50) |
| days | 7 | 검색할 과거 일수 |
| allow_all_dates | false | days 대신 전체 보도 기간을 검색 |
| score_gte | 4 | 최소 일치 점수, 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_article | false | true로 설정하면 동일한 기사에서 관련 청크를 여러 개 반환 |
각 결과는 기사 제목, URL, 게시 날짜, 일치하는 텍스트 발췌 및 메타데이터(topic, person, organization, location, ticker, political_bias, domain_rank)를 반환합니다.
모든 도구 호출은 토큰으로 일반 News Search 요청을 실행합니다. 동일한 크레딧과 요율 제한이 적용됩니다. 오류, 요율 제한 및 크레딧을 참조하세요.
토큰 안전하게 보관하기
토큰을 git에 커밋하거나 URL에 넣지 마세요.
환경 변수로 한 번 설정하고 구성에서 참조하세요:
"Authorization": "Bearer ${env:WEBZ_API_TOKEN}"
다음 단계
- Framework SDK 사용: LangChain, LlamaIndex 또는 n8n.
- Agent Skill을 추가하여 에이전트가 검색 시기와 방법을 알 수 있게 하세요.
- 모든 필터 값은 필터에서 확인하세요.