API, feeds y MCP Activa

El archivo de CheckNews está abierto en modo de solo lectura. Cada noticia conserva el medio original, el país, el idioma, la fecha y hora de publicación y la URL de la fuente. No hace falta clave.

Inicio rápido

Cualquier búsqueda del sitio tiene una URL pública y permanente, y la misma búsqueda en JSON:

https://checknews.org/search?q=Mel+Gibson
https://checknews.org/buscar.php?q=Mel+Gibson
https://checknews.org/buscar.php?q=Mel+Gibson&format=json    → JSON
https://checknews.org/buscar.php?q=Mel+Gibson&format=rss     → RSS

Cada historia tiene su página permanente, con datos estructurados (schema.org) y su versión JSON:

https://checknews.org/historia.php?id=12345
https://checknews.org/api/v1/story.php?id=12345

API REST

Todas las rutas aceptan GET, responden JSON en UTF-8, permiten CORS desde cualquier origen y añaden &pretty=1 para leerlo con sangría.

Ruta	Qué devuelve
/api/v1/search.php	Búsqueda en todo el archivo. Sin q, lo más reciente con los filtros que pongas.
/api/v1/story.php?id=N	Una historia con todas sus noticias y el resumen de IA si ya existe.
/api/v1/top.php	Lo más cubierto (más fuentes distintas) en las últimas N horas; 24 por omisión.
/api/v1/sources.php	Feeds que se consultan y medios que publicaron en los últimos N días.
/api/v1/countries.php	Países vigilados, con su actividad reciente, y la lista de categorías.
/api/v1/	Índice legible por máquinas.

Parámetros de búsqueda

Se aceptan en inglés o en español (country o pais, from o desde…). Los mismos sirven para los feeds.

Parámetro	Ejemplo	Descripción
q	Mel Gibson	Palabras clave o "frase exacta". Une variantes con OR o |: Noah's Ark OR Durupınar.
from / to	2026-09-21	Fecha o fecha-hora ISO 8601. Una historia entra si estuvo activa dentro del rango.
days / hours	7	Atajo: solo los últimos N días u horas.
country	TR, Turkey, Turquía	Código ISO 3166-1 de dos letras o nombre del país. Varios, separados por comas.
language	en,tr	Código ISO 639-1. Varios, separados por comas.
publisher	BBC News	Nombre exacto del medio. Consulta los nombres en sources.php.
category	politics	politics, business, technology, climate, sports, science o culture.
status	hot	breaking, developing, updates, quiet o hot (breaking más developing).
min_sources	3	Solo historias cubiertas por al menos N fuentes distintas.
sort	coverage	relevance (con q), recent, coverage u oldest.
limit / offset	20 / 40	Paginación: hasta 100 por página. Usa next_offset de la respuesta.
max_articles	10	Noticias listadas por historia (0–60).
coverage	0	Pon 0 para omitir el resumen de cobertura y responder más rápido.

Forma de la respuesta

{
  "query": { "q": "Durupınar", "from": "2026-09-21T00:00:00-06:00", "sort": "relevance" },
  "total": 19, "total_is_capped": false, "offset": 0, "limit": 20, "next_offset": null,
  "results": [{
    "id": 59881,
    "title": "Researchers return to Noah's Ark site at Durupınar formation",
    "permalink": "https://checknews.org/historia.php?id=59881",
    "status": "breaking", "category": "science",
    "country": "US", "country_name": "United States", "language": "en",
    "first_seen_at": "2026-09-28T09:39:28-06:00", "last_activity_at": "2026-09-28T10:39:28-06:00",
    "source_count": 4, "article_count": 4,
    "source_url": "https://…",
    "articles": [{
      "title": "…", "publisher": "Daily Sabah", "url": "https://…",
      "country": "TR", "country_name": "Türkiye", "language": "en",
      "published_at": "2026-09-28T10:09:28-06:00"
    }]
  }],
  "coverage": {
    "stories": 19, "articles": 54,
    "publishers": [{ "name": "Hürriyet", "country": "TR", "articles": 5, "stories": 5 }],
    "countries":  [{ "code": "TR", "name": "Türkiye", "articles": 11, "stories": 9, "publishers": 3 }],
    "languages":  [{ "code": "en", "articles": 30 }],
    "timeline":   [{ "date": "2026-09-27", "articles": 21 }]
  },
  "links": { "self": "…", "next": null, "html": "…", "rss": "…", "atom": "…", "json_feed": "…" }
}

Las fechas llevan zona horaria. coverage cuenta cada noticia publicada dentro del rango por medio, país e idioma: responde directamente a «qué medios y qué países están cubriendo esto».

Feeds RSS, Atom y JSON Feed

Lo más reciente, o cualquier búsqueda o filtro, como feed. Cada entrada lleva el titular, el medio original, el país, el idioma, la fecha y la URL de la fuente, y enlaza a la página de la historia.

https://checknews.org/feed/                                  RSS 2.0, lo más reciente
https://checknews.org/feed/?format=atom                      Atom 1.0
https://checknews.org/feed/?format=json                      JSON Feed 1.1
https://checknews.org/feed/?q=Mel+Gibson                     una búsqueda
https://checknews.org/feed/?country=MX&min_sources=3          México, historias con 3 o más fuentes
https://checknews.org/feed/?language=en&category=science&days=2

El sitemap está en https://checknews.org/sitemap.php: un índice con un sitemap por día del archivo y sus fechas de última modificación.

Servidor MCP

Para asistentes y agentes compatibles con Model Context Protocol. Transporte Streamable HTTP (JSON-RPC 2.0 por POST), sin autenticación y de solo lectura.

https://checknews.org/mcp/
https://checknews.org/mcp.php      (misma cosa, por si tu cliente no sigue la barra final)

Herramienta	Para qué
search_news	Búsqueda con fechas, país, idioma, medio y categoría. Devuelve historias, sus fuentes y el resumen de cobertura.
get_coverage	Qué medios, países e idiomas cubren un tema en un rango de fechas, con línea de tiempo y las historias principales.
get_story	Una historia con todas sus noticias originales.
search_by_country	Lo último de un país, con palabras clave opcionales.
get_top_stories	Lo más cubierto en las últimas N horas.
get_sources	Feeds consultados y medios activos por país o idioma.
list_countries	Países vigilados, con códigos, nombres y actividad.

Conectarlo

Claude (web o escritorio): Ajustes → Conectores → Añadir conector personalizado, con la URL https://checknews.org/mcp/.

Claude Code:

claude mcp add --transport http checknews https://checknews.org/mcp/

Otros clientes (Cursor, VS Code, etc.), en su archivo de configuración:

{
  "mcpServers": {
    "checknews": { "type": "http", "url": "https://checknews.org/mcp/" }
  }
}

Probarlo a mano

curl -s -X POST https://checknews.org/mcp/ \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_coverage","arguments":{"query":"Durupınar","days":7}}}'

Ejemplo completo

«Busca en CheckNews todas las noticias sobre Noah's Ark/Durupınar publicadas durante la última semana y dime qué medios y países las están cubriendo.»

Con MCP, el agente llama a get_coverage:

{ "query": "Noah's Ark OR Durupınar OR Nuh'un Gemisi", "days": 7 }

Con la API, una sola petición; la respuesta trae coverage.publishers y coverage.countries:

https://checknews.org/api/v1/search.php?q=Noah%27s%20Ark%20OR%20Durup%C4%B1nar%20OR%20Nuh%27un%20Gemisi&days=7

Reglas de uso

• Sin clave ni registro. Límite: 120 peticiones por minuto por IP. Al pasarlo, la respuesta es 429 con Retry-After; las cabeceras X-RateLimit-Remaining indican cuánto queda.
• Identifica tu integración con la cabecera X-Client-Name: TuApp (o el parámetro client=TuApp). No es obligatorio, pero nos ayuda a saber quién usa el archivo y a avisarte de cambios.
• Las respuestas se guardan en caché unos minutos. Para seguir un tema, usa los feeds en lugar de repetir la misma búsqueda.
• Cita la fuente original (articles[].url) y el enlace permanente de la historia (permalink). Los titulares pertenecen a sus medios.
• Los buscadores y agentes de IA que respetan robots.txt pueden rastrear el archivo, la búsqueda, los feeds y la API.
• La API es de solo lectura: no da acceso al panel ni a ninguna configuración.