TrendPulse - Google News & Trends
mcp-trendpulse
TrendPulse는 Python Model Context Protocol (MCP) 서버로, 최신 뉴스와 검색 관심 트렌드를 조사합니다. Google News 디스커버리와 기사 추출을 Google Trends 분석과 결합하여 MCP 클라이언트가 트렌딩 중인 항목을 확인하고, 키워드 모멘텀을 비교하고, 관련 수요를 탐색하고, 리서치 워크플로에 최신 뉴스 컨텍스트를 추가할 수 있게 합니다.
이 프로젝트는 현재 커뮤니티/자체 호스팅 MCP 서버로 제공되며, ChatGPT 및 Codex 같은 원격 MCP 클라이언트용 별도의 호스팅된 TrendPulse by DigestSEO 인터페이스 구현도 포함합니다. 호스팅 레이어는 더 작고 목표 지향적인 도구 인터페이스를 사용하는 반면, 커뮤니티 서버는 개발자가 사용할 수 있는 전체 저수준 리서치 도구 키트를 유지합니다.
프로젝트 상태: 로컬/커뮤니티 서버는 지금 사용할 수 있습니다. DigestSEO 호스팅 MCP와 공개 OpenAI 플러그인은 아직 출시되지 않았으며 사용 가능한 엔드포인트로 취급해서는 안 됩니다.
엔지니어링 컨텍스트: TrendPulse는 DigestSEO MCP 생태계의 일부입니다. Google Search Console 데이터용 mcp-gsc, AI 가시성용 mcp-geo, 기술적 웹 검증용 mcp-web-validator를 보완합니다. 전체 아키텍처는 DigestSEO MCP Suite 엔지니어링 사례 연구에 문서화되어 있습니다.
TrendPulse가 할 수 있는 기능
뉴스 리서치
Google News를 키워드, 위치, 주제 또는 게시자 도메인별로 검색합니다.
상위 뉴스 기사를 가져옵니다.
Google News 링크를 확인하고 기사 콘텐츠를 추출합니다.
어려운 페이지의 경우 일반 HTTP 검색에서 Playwright/Chromium으로 대체합니다.
선택적으로 MCP 클라이언트 샘플링으로 기사 텍스트를 요약하며, 로컬 NLP를 대체 수단으로 사용합니다.
트렌드 리서치
특정 지역 시장의 현재 인기 검색어를 가져옵니다.
하나 이상의 키워드에 대한 Google Trends 시간별 관심도 데이터를 가져옵니다.
3M 또는 1Y 같은 사용자 지정 기간에 걸친 키워드 성장률을 계산합니다.
실시간 트렌드를 볼륨 또는 성장률 기준으로 순위를 매깁니다.
지원되는 경우 국가, 지역, 도시 또는 DMA별 관심도를 확인합니다.
관련 검색어, 관련 주제, 추천 검색어 및 카테고리 ID를 탐색합니다.
기본 제공자가 지원하는 경우 Google Search, YouTube Search, News Search, Image Search 및 Google Shopping 트렌드 속성을 비교합니다.
Related MCP server: NewsIQ MCP
커뮤니티 및 호스팅 아키텍처
TrendPulse는 의도적으로 두 가지 인터페이스로 개발되고 있습니다.
인터페이스 | 목적 | 상태 |
Community MCP | 로컬 사용, 개발, 자체 호스팅 및 MCP 호환 클라이언트와의 통합을 위한 전체 Python MCP 서버. | 이 저장소에서 사용 가능 |
TrendPulse by DigestSEO | ChatGPT/Codex용 관리형 원격 MCP와 더 작고 작업 지향적인 도구 인터페이스를 갖춘 향후 공개 OpenAI 플러그인. | 개발 중 |
커뮤니티 서버는 독립적으로도 유용합니다. 호스팅 버전은 동일한 핵심 트렌드 리서치 개념을 재사용하면서, 관리형 서비스에 필요한 배포, 안정성, 인증, 관측 가능성 및 제품 통합을 추가합니다.
구현된 호스팅 도구 인터페이스는 의도적으로 커뮤니티 API보다 높은 수준이며 다음과 같은 목표에 중점을 둡니다.
discover_trendsanalyze_keyword_trendcompare_keyword_trendsdiscover_related_demandget_trend_contextfind_seo_opportunities
이러한 이름은 호스팅 ChatGPT Apps/MCP 인터페이스를 설명하며, 현재 Community MCP 도구 이름과는 별개입니다.
설치
GitHub에서 uvx로 직접 실행(권장)
이 패키지는 아직 PyPI에 게시되지 않았으므로 가장 직접적인 설치 방법은 다음과 같습니다.
uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulsePyPI 릴리스가 나온 후에는 더 짧은 형식을 사용할 수 있습니다.
uvx mcp-trendpulse체크아웃에서 pip로 설치
git clone https://github.com/AKzar1el/mcp-trendpulse.git
cd mcp-trendpulse
python -m pip install .
python -m mcp_trendpulse브라우저 대체
뉴스/기사 도구는 일반 검색으로 유용한 기사를 추출할 수 없을 때 Playwright로 대체할 수 있습니다. Python playwright 패키지를 설치한다고 해서 Chromium이 자동으로 설치되지는 않습니다.
로컬 사용 시:
playwright install chromium브라우저 시스템 종속성도 필요한 Linux 환경의 경우:
playwright install --with-deps chromium트렌드 전용 작업은 기본적으로 Chromium이 필요하지 않습니다.
클라이언트 구성
Claude Desktop
GitHub에서 uvx를 직접 사용:
{
"mcpServers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}VS Code
{
"mcp": {
"servers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}
}Cursor
Cursor는 전역 및 프로젝트 MCP 구성을 지원합니다. 해당 mcp.json 구성에 서버를 추가하세요:
{
"mcpServers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}ChatGPT 및 기타 클라우드 MCP 클라이언트
이 저장소에는 이제 mcp_trendpulse.asgi:app에 전용 상태 비저장 Streamable HTTP ASGI 진입점이 포함되어 있습니다. 이는 변경되지 않은 Community stdio 진입점과 분리되어 있습니다.
통제된 로컬/개인 테스트를 위해 Uvicorn으로 ASGI 앱을 실행하거나 제공된 컨테이너를 사용할 수 있습니다. 강화된 컨테이너, Host/Origin 허용 목록, Chromium 샌드박스 요구 사항, 상태/준비 엔드포인트 및 리버스 프록시 참고 사항은 deploy/README.md를 참조하세요.
DigestSEO 호스팅 엔드포인트와 공개 ChatGPT 앱은 아직 출시되지 않았습니다. 호스팅 배포는 이제 fail-closed 방식의 Clerk OAuth 인증을 지원합니다. Clerk 발급자/JWKS/대상(audience) 설정, 공개 기본 URL 및 Host/Origin 허용 목록이 해당 배포에 구성되지 않는 한 원격 전송을 공개적으로 노출하지 마십시오.
구성
TrendPulse는 프로세스 환경 변수와 로컬 .env 파일(있는 경우)에서 환경 변수를 로드합니다.
유용한 변수는 다음과 같습니다.
HTTP_PROXY=http://your-proxy-address:port
HTTPS_PROXY=http://your-proxy-address:port
GOOGLE_TRENDS_DELAY=2.0GOOGLE_TRENDS_DELAY는 현재 Trends 제공자가 사용하는 요청 지연을 제어합니다. 업스트림 서비스가 특정 네트워크를 속도 제한하거나 차단할 때 프록시 변수가 유용할 수 있습니다.
원격 배포는 또한 TRENDPULSE_HTTP_PATH, TRENDPULSE_HTTP_ALLOWED_HOSTS, TRENDPULSE_HTTP_ALLOWED_ORIGINS, TRENDPULSE_BROWSER_SANDBOX를 지원합니다. 컨테이너는 Chromium 샌드박싱을 명시적으로 활성화합니다. 로컬 Community 실행은 별도로 선택하지 않는 한 Playwright 호환 기본값을 유지합니다.
비밀, 개인 프록시 자격 증명 또는 특정 머신용 .env 파일을 커밋하지 마십시오.
MCP 도구
커뮤니티 MCP 서버는 현재 16개 도구를 제공합니다.
뉴스 도구
도구 | 목적 |
| 키워드와 일치하는 최근 뉴스 기사를 찾습니다. |
| 위치와 관련된 최근 뉴스를 찾습니다. |
| 지원되는 Google News 주제의 최근 뉴스를 찾습니다. |
| 상위 Google News 기사를 가져옵니다. |
| 특정 게시자 도메인의 최근 뉴스를 찾습니다. |
| 하나의 기사 URL을 다운로드하고 검증하고 추출하며 선택적으로 요약합니다. |
트렌드 도구
도구 | 목적 |
| 특정 지역 대상의 현재 인기 검색어를 가져옵니다. |
| 하나 이상의 키워드에 대한 시간별 관심도 데이터 포인트를 가져옵니다. |
| 요청된 기간에 대한 검색 관심도 성장률을 계산합니다. |
| 현재 트렌드를 성장률 또는 볼륨 기준으로 순위를 매깁니다. |
| 키워드 없이 상위 트렌드 피드를 가져옵니다. |
| 지리적 지역 간 키워드 관심도를 비교합니다. |
| 상위 및 급상승 관련 검색어를 가져옵니다. |
| 상위 및 급상승 관련 Google Trends 주제를 가져옵니다. |
| 쿼리에 대한 자동 완성/주제 추천을 확인합니다. |
| Google Trends 카테고리 ID와 이름을 가져옵니다. |
예: 명시적 트렌드 기간
get_trends는 명시적 timeframe을 허용합니다. 재현 가능한 비교가 필요할 때는 이를 지정하는 것이 좋습니다.
{
"keyword": ["technical SEO audit", "AI SEO audit"],
"geo": "US",
"source": "google search",
"timeframe": "today 12-m",
"cat": 0
}지원되는 제공자 범위에는 today 12-m, today 5-y 같은 표준 기간, today 90-d, all 같은 상대 기간, 2021-01-01 2026-01-01 같은 정확한 날짜 범위가 포함됩니다.
Google Trends 값은 정규화된 관심도 점수입니다. 0-100 관심도 시계열을 절대 검색량으로 해석하지 마십시오.
CLI
별도의 Click CLI는 MCP 서버보다 더 작은 뉴스 중심 명령 세트를 제공합니다.
uv run mcp-trendpulse-cli --help현재 CLI 명령:
keyword
location
top
topic
trendingCLI와 MCP 인터페이스는 동일한 명령 세트를 제공하지 않으므로 의도적으로 별도로 문서화됩니다.
개발
선호하는 Python 환경에서 개발 종속성과 함께 프로젝트를 설치한 다음 단위 테스트 스위트를 실행하세요:
python -m pytest기본 pytest 구성은 라이브 통합 테스트를 제외합니다.
라이브 제공자 테스트를 명시적으로 실행하려면:
python -m pytest tests/integration -m integration브라우저 표시 통합 테스트에는 Playwright Chromium이 설치되어 있어야 합니다.
Ruff 검사를 실행하려면:
ruff check .MCP Inspector
GitHub에서 게시된 서버를 MCP Inspector를 통해 실행하세요:
npx @modelcontextprotocol/inspector uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulse로컬 체크아웃의 경우:
npx @modelcontextprotocol/inspector uv run mcp-trendpulse패키징
GitHub 릴리스가 게시되면 PyPI Trusted Publishing을 통해 Python 배포판을 빌드하고 게시하기 위한 GitHub Actions 워크플로가 이미 포함되어 있습니다. 첫 번째 패키지 릴리스가 나올 때까지 위에 표시된 GitHub uvx --from ... 명령을 사용하세요.
보안 참고 사항
기사 검색은 아웃바운드 네트워크 기능이며 신뢰할 수 없는 입력으로 취급됩니다. 구현은 HTTP(S) 대상을 검증하고, 사설 및 라우팅 불가능한 대상을 거부하고, 리디렉션 대상을 확인하고, 응답 크기 제한을 적용하며, Playwright 사용 시 브라우저 경로 검증을 적용합니다.
원격으로 TrendPulse를 배포하는 경우 이러한 제어 장치를 유지하고 애플리케이션 기본값에만 의존하지 말고 배포 수준의 속도 제한, 요청 시간 초과, 관측 가능성 및 리소스 제한을 추가하세요.
로드맵
현재 프로덕션 준비 작업은 다음에 중점을 둡니다.
문서, 패키징 메타데이터 및 생성된 MCP 매니페스트를 실제 도구 인터페이스와 일관되게 유지하는 것.
단위 테스트와 정적 검사를 위한 지속적 통합을 추가하는 것.
공급자를 MCP 레이어를 다시 작성하지 않고 교체할 수 있도록 공급자 액세스를 TrendPulse의 도메인 로직과 분리하는 것.
로컬 stdio 작동을 유지하면서 프로덕션 원격 HTTP 전송을 추가하는 것.
ChatGPT/Codex용 더 작은 고수준 호스팅 도구 인터페이스를 설계하는 것.
호스팅 서비스를 DigestSEO 애플리케이션 및 운영 스택과 통합하는 것.
서비스가 프로덕션 준비가 된 후에만 호스팅 MCP를 OpenAI 플러그인으로 패키징하고 테스트하는 것.
라이선스
MIT. LICENSE를 참조하세요.
Available Tools
16 toolsget_article_contentARead-only
Download and parse one specific news article when you already have an article URL. Use it to retrieve article text or metadata or summarize that URL; do not use it for discovery - use the news search tools instead.
Inputs: url (required), full_data, summarize. Returns: result
get_categoriesARead-only
Return a bounded page of Google Trends category IDs and names for use in the cat parameter of trend tools. Use query to find categories by name and offset/limit to page through broader results; do not guess category IDs.
Inputs: limit, query, offset. Returns: result
get_growthARead-only
Estimate momentum for one or more known keywords across requested growth windows. Use this when percentage growth is the goal; use get_trends when the user needs the underlying historical time series.
Inputs: keyword (required), geo, source, percent_growth. Returns: result
get_interest_by_regionARead-only
Return geographic Google Trends interest for one or more known keywords at country, region, city, or DMA resolution. Use this to compare where demand is strongest; use get_trends for interest over time instead.
Inputs: keywords (required), cat, geo, gprop, +3 more. Returns: result
get_news_by_keywordARead-only
Find recent Google News articles for a free-form keyword or phrase. Use this for ad-hoc subject searches; use get_news_by_topic for a predefined topic category or get_news_by_site for one publisher.
Inputs: keyword (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_locationARead-only
Find recent Google News articles about a place-focused location such as a city, state, or country. Use this when geography is the primary filter; use get_news_by_keyword for general subject searches.
Inputs: location (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_siteARead-only
Find recent Google News articles from one publisher domain. Use this when the user wants source-specific coverage; use get_news_by_keyword for cross-publisher subject search.
Inputs: site (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_topicARead-only
Find recent Google News articles from a predefined Google News topic category. Use this for topic category browsing such as BUSINESS, TECHNOLOGY, or SPORTS; use get_news_by_keyword for a free-form query.
Inputs: topic (required), period, full_data, summarize, +2 more. Returns: result
get_ranked_trendsARead-only
Return ranked terms in the Google Trending Now 24-hour feed by provider-reported recent growth or approximate volume. The growth percentage has no stated comparison baseline and is NOT a week-over-week change. Use get_top_trends for a simpler current feed and get_trends for historical series.
Inputs: geo, sort, limit, source. Returns: result
get_suggestionsARead-only
Return Google Trends autocomplete suggestions for a seed keyword. Use this for lightweight autocomplete or entity candidates; use get_related_queries when you need top or rising demand signals.
Inputs: keyword (required), language. Returns: result
get_top_newsARead-only
Return general headline and top-news stories from Google News without a keyword or topic seed. Use this for a broad news snapshot; use the keyword, location, topic, or site tools when the user gives a filter.
Inputs: period, full_data, summarize, max_results, +1 more. Returns: result
get_top_trendsARead-only
Return a bounded current topic discovery feed from Google Trends RSS, including related news where available. Use this for current top or daily trends; use get_ranked_trends when explicit ranking by growth or volume matters.
Inputs: geo, type, limit. Returns: result
get_trending_termsARead-only
Return terms that are trending now for a geography, optionally with related news metadata. Use this for current trend discovery; use get_trends when the user wants historical interest over time for known keywords.
Inputs: geo, full_data. Returns: result
get_trendsARead-only
Return historical Google Trends interest-over-time points for one or more known keywords. Use this for trajectory and comparisons across a timeframe; values are normalized 0-100 interest scores, not absolute search volume. Use get_trending_terms for what is trending now.
Inputs: keyword (required), cat, geo, source, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
The news tools are cleanly separated by filter (keyword, location, topic, site, top), and trend tools mostly include explicit cross-references to guide selection. The main overlap is among get_ranked_trends, get_top_trends, and get_trending_terms, which all surface current trends, though descriptions provide clear usage cues.
All tools use snake_case with a get_ verb prefix and noun-based names such as get_news_by_topic, get_interest_by_region, and get_related_queries. The pattern is predictable throughout, with only natural variation between get_news_by_* and get_top_* forms.
Sixteen tools cover two related but distinct domains—Google News search and Google Trends analysis—and each maps to a specific query type. The count is slightly above the ideal 3–15 range but remains reasonable for the breadth of functionality.
The surface covers news discovery across keyword, location, topic, site, and top stories, plus article retrieval and a broad Trends lifecycle including historical interest, growth, regional interest, categories, related queries/topics, suggestions, and current trends. Minor gaps include no date-range or language filters for news search and no batch article retrieval, but core workflows are well supported.
Maintenance
Related MCP Connectors
MCP server for Google Veo AI video generation
MCP server for Google search results via SERP API
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.MIT
- FlicenseNot gradedqualityDmaintenanceAn AI-powered news aggregator MCP server that fetches live news from multiple sources, provides AI summaries via Claude, and performs sentiment analysis and trending topic detection.-
- AlicenseNot gradedqualityCmaintenanceA persistent news intelligence MCP server that enables AI agents to fetch, store, deduplicate, embed, and semantically query news from Google News across 141 countries and 41 languages.34 PyPI8MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Google Trends data via BigQuery, enabling LLMs to query top search terms, rising terms, and compare term interest over time for different countries.-