Skip to main content
Glama
TrendPulse - Google News & Trends

TrendPulse - Google News & Trends

mcp-trendpulse

MCP Python License

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_trends

  • analyze_keyword_trend

  • compare_keyword_trends

  • discover_related_demand

  • get_trend_context

  • find_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-trendpulse

Cuando exista una versión publicada en PyPI, la forma más corta será:

uvx mcp-trendpulse

Instalar 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_trendpulse

Respaldo 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 chromium

Para entornos Linux que también requieran dependencias de sistema del navegador:

playwright install --with-deps chromium

Las 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.0

GOOGLE_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

get_news_by_keyword

Buscar artículos de noticias recientes que coincidan con una palabra clave.

get_news_by_location

Buscar noticias recientes asociadas a una ubicación.

get_news_by_topic

Buscar noticias recientes de un tema de Google News compatible.

get_top_news

Recuperar las principales noticias de Google News.

get_news_by_site

Buscar noticias recientes de un dominio de publicador específico.

get_article_content

Descargar, validar, extraer y opcionalmente resumir la URL de un artículo.

Herramientas de tendencias

Tool

Propósito

get_trending_terms

Recuperar los términos de tendencia actuales para un objetivo geográfico.

get_trends

Recuperar puntos de interés a lo largo del tiempo para una o más palabras clave.

get_growth

Calcular el crecimiento del interés de búsqueda en las ventanas solicitadas.

get_ranked_trends

Clasificar las tendencias actuales por crecimiento o volumen.

get_top_trends

Recuperar un feed de principales tendencias sin proporcionar una palabra clave.

get_interest_by_region

Comparar el interés de palabras clave entre regiones geográficas.

get_related_queries

Recuperar consultas de búsqueda relacionadas principales y en ascenso.

get_related_topics

Recuperar temas relacionados principales y en ascenso de Google Trends.

get_suggestions

Resolver sugerencias de autocompletado/temas para una consulta.

get_categories

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 --help

Comandos actuales de la CLI:

keyword
location
top
topic
trending

Las 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 pytest

La 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 integration

Las 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-trendpulse

Para un clon local:

npx @modelcontextprotocol/inspector uv run mcp-trendpulse

Empaquetado

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:

  1. Mantener la documentación, los metadatos de empaquetado y los manifiestos MCP generados coherentes con la superficie de herramientas actual.

  2. Añadir integración continua para pruebas unitarias y comprobaciones estáticas.

  3. 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.

  4. Añadir un transporte HTTP remoto de producción manteniendo la operación stdio local.

  5. Diseñar una superficie de herramientas alojada más pequeña y de alto nivel para ChatGPT/Codex.

  6. Integrar el servicio alojado con la aplicación DigestSEO y su pila operativa.

  7. 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 tools
get_article_contentA
Read-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_categoriesA
Read-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_growthA
Read-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_regionA
Read-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_keywordA
Read-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_locationA
Read-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_siteA
Read-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_topicA
Read-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_suggestionsA
Read-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_newsA
Read-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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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 PyPI
      8
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -