TrendPulse - Google News & Trends
mcp-trendpulse
TrendPulse es un servidor de Model Context Protocol (MCP) en Python para investigar noticias actuales y tendencias de interés de búsqueda. Combina el descubrimiento de Google News y la extracción de artículos con el análisis de Google Trends para que los clientes MCP puedan inspeccionar qué está en tendencia, comparar el impulso de palabras clave, explorar la demanda relacionada y añadir contexto de noticias actuales a los flujos de trabajo de investigación.
El proyecto se distribuye actualmente como un servidor MCP comunitario/autoalojado y también contiene la implementación de una superficie separada TrendPulse by DigestSEO alojado para clientes MCP remotos como ChatGPT y Codex. La capa alojada utiliza una superficie de herramientas más pequeña y orientada a objetivos, mientras que el servidor comunitario mantiene el kit completo de herramientas de investigación de bajo nivel disponible para los desarrolladores.
Estado del proyecto: el servidor local/comunitario es utilizable hoy. El MCP alojado por DigestSEO y el plugin público de OpenAI aún no se han publicado y no deben tratarse como endpoints disponibles.
Contexto de ingeniería: TrendPulse forma parte del ecosistema MCP de DigestSEO. Complementa a mcp-gsc para los datos de Google Search Console, a mcp-geo para la visibilidad en IA y a mcp-web-validator para la validación web técnica. La arquitectura general está documentada en el estudio de caso de ingeniería de DigestSEO MCP Suite.
Qué puede hacer TrendPulse
Investigación de noticias
Buscar en Google News por palabra clave, ubicación, tema o dominio de publicador.
Recuperar las noticias principales.
Resolver enlaces de Google News y extraer el contenido de los artículos.
Recurrir a Playwright/Chromium cuando la recuperación HTTP normal no funcione con páginas difíciles.
Resumir opcionalmente el texto de los artículos mediante el muestreo del cliente MCP, con NLP local como alternativa.
Investigación de tendencias
Recuperar los términos de tendencia actuales para un mercado geográfico.
Obtener datos de interés a lo largo del tiempo de Google Trends para una o más palabras clave.
Calcular el crecimiento de palabras clave en ventanas personalizadas como 3M o 1Y.
Clasificar las tendencias en vivo por volumen o crecimiento.
Inspeccionar el interés por país, región, ciudad o DMA cuando esté disponible.
Explorar consultas relacionadas, temas relacionados, sugerencias e identificadores de categoría.
Comparar las propiedades de tendencia de Google Search, YouTube Search, News Search, Image Search y Google Shopping cuando el proveedor subyacente lo admita.
Related MCP server: NewsIQ MCP
Arquitectura comunitaria y alojada
TrendPulse se está desarrollando con dos superficies intencionadas:
Superficie | Propósito | Estado |
Community MCP | Servidor MCP completo en Python para uso local, desarrollo, autoalojamiento e integraciones con clientes compatibles con MCP. | Disponible en este repositorio |
TrendPulse by DigestSEO | MCP remoto gestionado para ChatGPT/Codex y un futuro plugin público de OpenAI con una superficie de herramientas más pequeña y orientada a tareas. | En desarrollo |
El servidor comunitario sigue siendo útil de forma independiente. La edición alojada reutilizará los mismos conceptos centrales de investigación de tendencias y añadirá el despliegue, la fiabilidad, la autenticación, la observabilidad y la integración de producto necesarios para un servicio gestionado.
La superficie de herramientas alojada implementada es intencionadamente de mayor nivel que la API comunitaria y se centra en objetivos como:
discover_trendsanalyze_keyword_trendcompare_keyword_trendsdiscover_related_demandget_trend_contextfind_seo_opportunities
Estos nombres describen la interfaz alojada de ChatGPT Apps/MCP; siguen siendo independientes de los nombres actuales de las herramientas del MCP comunitario.
Instalación
Ejecutar directamente desde GitHub con uvx (recomendado)
El paquete aún no se ha publicado en PyPI, por lo que la vía de instalación más directa es:
uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulseCuando exista una versión publicada en PyPI, la forma más corta será:
uvx mcp-trendpulseInstalar con pip desde un clon del repositorio
git clone https://github.com/AKzar1el/mcp-trendpulse.git
cd mcp-trendpulse
python -m pip install .
python -m mcp_trendpulseRespaldo con navegador
Las herramientas de noticias/artículos pueden recurrir a Playwright cuando la recuperación normal no puede extraer un artículo utilizable. Instalar el paquete playwright de Python no instala Chromium automáticamente.
Para uso local:
playwright install chromiumPara entornos Linux que también requieran dependencias de sistema del navegador:
playwright install --with-deps chromiumLas operaciones que solo usan tendencias no requieren Chromium por naturaleza.
Configuración del cliente
Claude Desktop
Usando uvx directamente desde GitHub:
{
"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 admite configuración MCP global y por proyecto. Añade el servidor a la configuración mcp.json correspondiente:
{
"mcpServers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}ChatGPT y otros clientes MCP en la nube
El repositorio ahora incluye un punto de entrada ASGI HTTP Streamable sin estado dedicado en mcp_trendpulse.asgi:app. Este es independiente del punto de entrada stdio comunitario, que permanece sin cambios.
Para pruebas locales/privadas controladas, puedes ejecutar la aplicación ASGI con Uvicorn o usar el contenedor proporcionado. Consulta deploy/README.md para el contenedor endurecido, las listas de permisos de Host/Origin, los requisitos de sandbox de Chromium, los endpoints de health/readiness y las notas sobre el proxy inverso.
El endpoint alojado por DigestSEO y la aplicación pública de ChatGPT aún no se han publicado. Los despliegues alojados ahora admiten autenticación Clerk OAuth de cierre ante fallos; no expongas el transporte remoto públicamente a menos que estén configurados los ajustes de issuer/JWKS/audience de Clerk, la URL base pública y las listas de permisos de Host/Origin para ese despliegue.
Configuración
TrendPulse carga las variables de entorno del entorno del proceso y de un archivo local .env cuando existe.
Algunas variables útiles son:
HTTP_PROXY=http://your-proxy-address:port
HTTPS_PROXY=http://your-proxy-address:port
GOOGLE_TRENDS_DELAY=2.0GOOGLE_TRENDS_DELAY controla el retardo de solicitud que usa el proveedor de Trends actual. Las variables de proxy pueden ser útiles cuando el servicio ascendente limita la tasa o bloquea una red concreta.
Los despliegues remotos también admiten TRENDPULSE_HTTP_PATH, TRENDPULSE_HTTP_ALLOWED_HOSTS, TRENDPULSE_HTTP_ALLOWED_ORIGINS y TRENDPULSE_BROWSER_SANDBOX. El contenedor habilita explícitamente el sandbox de Chromium; las ejecuciones comunitarias locales conservan el valor predeterminado compatible con Playwright a menos que optes por activarlo.
No hagas commit de secretos, credenciales de proxy privadas ni archivos .env específicos de una máquina.
Herramientas MCP
El servidor MCP comunitario expone actualmente 16 herramientas.
Herramientas de noticias
Tool | Propósito |
| Buscar artículos de noticias recientes que coincidan con una palabra clave. |
| Buscar noticias recientes asociadas a una ubicación. |
| Buscar noticias recientes de un tema de Google News compatible. |
| Recuperar las principales noticias de Google News. |
| Buscar noticias recientes de un dominio de publicador específico. |
| Descargar, validar, extraer y opcionalmente resumir la URL de un artículo. |
Herramientas de tendencias
Tool | Propósito |
| Recuperar los términos de tendencia actuales para un objetivo geográfico. |
| Recuperar puntos de interés a lo largo del tiempo para una o más palabras clave. |
| Calcular el crecimiento del interés de búsqueda en las ventanas solicitadas. |
| Clasificar las tendencias actuales por crecimiento o volumen. |
| Recuperar un feed de principales tendencias sin proporcionar una palabra clave. |
| Comparar el interés de palabras clave entre regiones geográficas. |
| Recuperar consultas de búsqueda relacionadas principales y en ascenso. |
| Recuperar temas relacionados principales y en ascenso de Google Trends. |
| Resolver sugerencias de autocompletado/temas para una consulta. |
| Recuperar identificadores y nombres de categorías de Google Trends. |
Ejemplo: ventana de tendencia explícita
get_trends acepta un timeframe explícito. Proporcionarlo es preferible cuando necesitas comparaciones reproducibles.
{
"keyword": ["technical SEO audit", "AI SEO audit"],
"geo": "US",
"source": "google search",
"timeframe": "today 12-m",
"cat": 0
}Los rangos admitidos por el proveedor incluyen ventanas estándar como today 12-m y today 5-y, ventanas relativas como today 90-d, all, y rangos de fechas exactos como 2021-01-01 2026-01-01.
Los valores de Google Trends son puntuaciones de interés normalizadas. No interpretes una serie de interés de 0 a 100 como volumen de búsqueda absoluto.
CLI
La CLI Click independiente expone un conjunto de comandos más reducido y orientado a noticias que el servidor MCP:
uv run mcp-trendpulse-cli --helpComandos actuales de la CLI:
keyword
location
top
topic
trendingLas superficies CLI y MCP se documentan intencionadamente por separado porque no exponen el mismo conjunto de comandos.
Desarrollo
Instala el proyecto con sus dependencias de desarrollo usando tu entorno Python preferido y, a continuación, ejecuta la suite de pruebas unitarias:
python -m pytestLa configuración predeterminada de pytest excluye las pruebas de integración en vivo.
Ejecuta explícitamente las pruebas en vivo del proveedor con:
python -m pytest tests/integration -m integrationLas pruebas de integración marcadas como de navegador requieren que Playwright Chromium esté instalado.
Ejecuta las comprobaciones de Ruff con:
ruff check .MCP Inspector
Ejecuta el servidor publicado desde GitHub a través del MCP Inspector:
npx @modelcontextprotocol/inspector uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulsePara un clon local:
npx @modelcontextprotocol/inspector uv run mcp-trendpulseEmpaquetado
Ya existe un flujo de trabajo de GitHub Actions para compilar y publicar distribuciones de Python mediante PyPI Trusted Publishing cuando se publica una versión de GitHub. Hasta que exista la primera versión del paquete, usa el comando uvx --from ... de GitHub que se muestra arriba.
Notas de seguridad
La recuperación de artículos es una función de red saliente y se trata como entrada no confiable. La implementación valida destinos HTTP(S), rechaza destinos privados y no enrutables, comprueba los destinos de redirección, aplica límites de tamaño de respuesta y realiza validación de la ruta del navegador cuando se usa Playwright.
Si implementas TrendPulse de forma remota, conserva estos controles y añade limitación de tasa a nivel de despliegue, tiempos de espera de solicitud, observabilidad y límites de recursos, en lugar de depender solo de los valores predeterminados de la aplicación.
Hoja de ruta
El trabajo actual de preparación para producción se centra en:
Mantener la documentación, los metadatos de empaquetado y los manifiestos MCP generados coherentes con la superficie de herramientas actual.
Añadir integración continua para pruebas unitarias y comprobaciones estáticas.
Separar el acceso a los proveedores de la lógica de dominio de TrendPulse para que los proveedores puedan cambiarse sin reescribir la capa MCP.
Añadir un transporte HTTP remoto de producción manteniendo la operación stdio local.
Diseñar una superficie de herramientas alojada más pequeña y de alto nivel para ChatGPT/Codex.
Integrar el servicio alojado con la aplicación DigestSEO y su pila operativa.
Empaquetar y probar el MCP alojado como plugin de OpenAI solo después de que el servicio esté listo para producción.
Licencia
MIT. Consulta 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.-