Dijital Sürmanşet MCP

npx add-mcp 'https://dijitalsurmanset.com/api/mcp'

Guía para desarrolladores de MCP

Dijital Sürmanşet ofrece acceso de solo lectura desde aplicaciones de inteligencia artificial a sus noticias publicadas, portadas de periódicos archivadas y datos registrados de los módulos financieros abiertos en este sitio. No se requiere inicio de sesión ni clave API.

Servidor: https://dijitalsurmanset.com/api/mcp

Esta dirección es una página de descripción mediante GET; las llamadas MCP se realizan mediante POST a través de Streamable HTTP. GET no abre una sesión SSE.

¿Cómo conectarse?

Añada el siguiente registro al archivo indicado conservando su configuración actual. Los ejemplos de Claude y Gemini corresponden a clientes Code/CLI; Codex utiliza TOML.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "dijitalsurmanset_com": {
      "type": "http",
      "url": "https://dijitalsurmanset.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "dijitalsurmanset_com": {
      "httpUrl": "https://dijitalsurmanset.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "dijitalsurmanset_com": {
      "url": "https://dijitalsurmanset.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.dijitalsurmanset_com]
url = "https://dijitalsurmanset.com/api/mcp"

Herramientas disponibles

Solo se enumeran las herramientas abiertas en este sitio. Las listas de noticias y la búsqueda de activos devuelven un máximo de 50 resultados.

En el historial financiero se pueden utilizar 30, 90, 180, 365 o 730 días (por defecto 365).

La comparación de fondos acepta entre 2 y 5 códigos distintos; el período predeterminado es 1a, y los demás períodos son 1g, 1h, 1a, 3a, 6a, yb, 3y y 5y.

Herramienta	Campos de entrada	Descripción
get_latest_news	limit, category	Obtiene las noticias más recientes publicadas; se puede usar un filtro de categoría opcional.
get_article	id, slug	Obtiene el texto completo, la fecha, la categoría y la información de la fuente mediante el ID numérico de URL o el slug de la noticia.
search_news	query, limit, category	Busca en títulos, descripciones y palabras clave de noticias; se puede limitar por categoría.
get_category_news	category, limit	Enumera las noticias publicadas más recientes en una categoría específica.
list_categories	language	Enumera las categorías principales activas con sus nombres y slugs.
search	query, limit	Devuelve resultados breves de noticias e identificadores en formato article:123 que se pueden usar para fetch.
fetch	id	Obtiene el texto completo y la información de la fuente de la noticia mediante el ID de contenido obtenido del resultado de búsqueda.
search_financial_assets	query, type, limit	Busca acciones y fondos activos por código o nombre; solo enumera los tipos de activos abiertos en este sitio.
get_stock_quote	symbol	Obtiene el último precio registrado, la variación y la información básica; no se garantiza un precio en tiempo real.
get_stock_history	symbol, days	Obtiene únicamente cierres reales registrados; no realiza solicitudes a fuentes externas ni genera precios sintéticos.
get_fund_details	code	Obtiene la ficha del fondo, el precio de la participación, la categoría, las comisiones, el valor de riesgo y la distribución de activos disponible.
get_fund_history	code, days	Obtiene precios reales de participación a partir de registros diarios; no presenta un índice de rendimiento aproximado como precio.
get_fund_returns	code	Presenta los rendimientos registrados diarios, semanales, mensuales y a largo plazo en porcentaje.
compare_funds	codes, period	Compara entre 2 y 5 fondos distintos con el mismo período; indica datos faltantes y diferencias de fechas.
get_market_overview	limit	Obtiene los índices abiertos y las listas de acciones de la última ronda; no se invocan secciones cerradas.
get_stock_financials	symbol	Obtiene los estados financieros registrados de la empresa con sus períodos y unidades disponibles; las series calculadas se indican por separado.
list_company_disclosures	symbol, days, limit	Enumera los avisos KAP registrados de la empresa de más reciente a más antiguo.
list_fund_leaders	period, direction, category, limit	Enumera los fondos ganadores/perdedores del período; el permiso del módulo para la dirección se verifica por separado.
get_fund_holdings	code, limit	Obtiene las mayores posiciones en acciones del fondo registradas; no se afirma que sea la cartera completa.
list_newspapers	query, limit	Enumera nombres de periódicos, slugs y fechas de archivo disponibles iniciales/finales; no garantiza la existencia de los días intermedios.
get_newspaper_headlines	date, limit, offset	Enumera las portadas de periódicos registradas del día solicitado con enlaces a fuentes e imágenes; si no hay fecha, se usa hoy en Estambul.
get_newspaper_front_page	newspaper, date	Obtiene la portada completa del periódico en la fecha solicitada con imagen MCP y enlaces. No realiza OCR ni recortes; si falta la fecha, no pasa a otro día.

Ejemplos de llamadas

Enumere las herramientas:

curl -X POST 'https://dijitalsurmanset.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Obtenga las últimas cinco noticias:

curl -X POST 'https://dijitalsurmanset.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_latest_news","arguments":{"limit":5}}}'

Titulares de periódicos y portadas

Si no se proporciona fecha, se usa hoy según Europe/Istanbul. Las fechas deben ser días reales en formato YYYY-MM-DD; no se aceptan días futuros. Se puede usar el nombre del periódico o su slug. Las listas diarias aceptan un máximo de 50 resultados y un offset de 0 a 1000. Si la fecha no existe en el archivo, no se pasa a otro día; las fechas iniciales/finales del archivo no garantizan que cada día intermedio esté disponible.

La llamada de un solo periódico devuelve la portada completa como contenido de imagen MCP con enlaces a fuente/imagen. No se realiza OCR ni recorte de noticias. Si la imagen grande no cumple el límite de 2 MiB, se intenta con la imagen pequeña disponible; el tiempo total de lectura es de 10 segundos. Cuando no se puede adjuntar la imagen, se devuelve image_embedded: false y una advertencia explicativa.

Titulares del día:

curl -X POST 'https://dijitalsurmanset.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_headlines","arguments":{}}}'

Portada de hoy del periódico Akşam:

curl -X POST 'https://dijitalsurmanset.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam"}}}'

Portada del periódico Akşam del 8 de noviembre de 2024:

curl -X POST 'https://dijitalsurmanset.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam","date":"2024-11-08"}}}'

2024-11-08 es un ejemplo de llamada; no se garantiza que exista archivo en esa fecha.

Habilidades del agente

Índice de descubrimiento de habilidades de este sitio: /.well-known/agent-skills/index.json. Los archivos de habilidades explican cómo usar las herramientas; este índice es una superficie de descubrimiento que ofrece el sitio.

• Investigación de noticias — Búsqueda de noticias, obtención de texto completo y citación de fecha/fuente.
• Lectura de datos bursátiles — Lectura de datos de acciones registrados conservando la distinción entre fuente y momento de los datos.
• Titulares de periódicos — Verificación del nombre del periódico y la fecha solicitada, y presentación de la portada completa del archivo con su fuente.
• Comparación de fondos — Comparación de fondos con el mismo período, conservando fechas de datos y valores faltantes.

Reglas y límites

• Gratuito. No hay plan de pago ni suscripción para MCP — /pricing.md. La aplicación a la que se conecta puede tener sus propias tarifas.
• Sin autenticación. No se requiere cuenta, token ni clave API — /auth.md.
• Atribución obligatoria. Al utilizar contenido de Dijital Sürmanşet, enlace a la dirección permanente de la noticia o página de datos correspondiente.
• Datos de entrenamiento: ai-train=no — no queremos que el contenido se incluya en conjuntos de datos de entrenamiento de modelos; robots.txt. Esta preferencia no es una garantía de que todos los clientes la cumplan.
• Derechos de imagen. Las imágenes de noticias y las portadas de periódicos pueden estar sujetas a derechos de autor de los titulares correspondientes. El acceso no otorga licencia de reutilización; conserve la información de fuente/licencia existente y no asuma licencias no indicadas.
• Formato de errores: los errores de protección HTTP se devuelven con application/json como error JSON-RPC; los errores de herramientas se devuelven con MCP isError. No se utiliza RFC 9457 application/problem+json.

Guía de uso completa: /AGENTS.md.

Seguridad y límites

• 120 solicitudes/minuto por sitio + IP confiable; search y search_news juntos 60 llamadas/minuto. Las herramientas financieras tienen además una cuota común de 30 llamadas/minuto; las tres herramientas de periódicos tienen una cuota común de 60 llamadas/minuto; la herramienta de imagen de un solo periódico tiene una cuota adicional de 10 llamadas/minuto. Todas también descuentan de la cuota general. Se aplican ventanas de minutos fijas.
• Ante una respuesta 429, espere el tiempo de Retry-After. Los encabezados X-RateLimit-Limit, Remaining y Reset indican la cuota general. Si el servicio de cuota Redis no está disponible, las herramientas devuelven 503 con Retry-After: 5.
• Límite de cuerpo de 256 KiB; no se admiten lotes ni identificadores de sesión MCP. Si hay Origin, debe pertenecer al mismo sitio.
• JSON malformado devuelve 400, Origin no permitido 403, cuerpo excesivo 413, identificador de sesión 404 y método HTTP no compatible 405. Los errores internos de las herramientas se explican con MCP isError.
• No se presentan noticias eliminadas, borradores, con fecha futura o retiradas de este sitio. No existen herramientas para añadir/editar/eliminar contenido.

¿Cómo leer los datos financieros?

Las llamadas financieras solo leen la base de datos y la caché; no realizan solicitudes a proveedores externos. Los datos tienen un retraso de 15 minutos. Los datos y contenidos financieros presentados aquí no constituyen asesoramiento de inversión. Los precios no tienen garantía de tiempo real. retrieved_at es el momento de acceso, record_updated_at es el momento de actualización del registro y data_date, si existe, es la fecha real de los datos; no son intercambiables. No se estiman fuentes ni momentos desconocidos. Los números faltantes permanecen como null y las advertencias se transmiten junto con el resultado.

El historial de precios contiene solo registros reales. No se presentan índices de rendimiento aproximados, precios rellenados para días vacíos ni precios sintéticos de hoy. En la comparación de fondos, tenga en cuenta las diferentes fechas de datos; los rendimientos pasados no garantizan rendimientos futuros. Al transmitir contenido y datos, conserve el enlace de la fuente.

Manifiesto de descubrimiento MCP · llms.txt