Ekonomi Köşesi MCP

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

Guía para desarrolladores de MCP

Ekonomi Köşesi 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 de API.

Servidor: https://ekonomikosesi.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": {
    "ekonomikosesi_com": {
      "type": "http",
      "url": "https://ekonomikosesi.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "ekonomikosesi_com": {
      "httpUrl": "https://ekonomikosesi.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "ekonomikosesi_com": {
      "url": "https://ekonomikosesi.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.ekonomikosesi_com]
url = "https://ekonomikosesi.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 usar 30, 90, 180, 365 o 730 días (predeterminado: 365).

La comparación de fondos acepta de 2 a 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 valor 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	Lista las noticias publicadas más recientes en una categoría específica.
list_categories	language	Lista las categorías principales activas con sus nombres y valores slug.
search	query, limit	Devuelve resultados breves de noticias e identificadores con 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 lista 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 solo los 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 actual.
get_fund_history	code, days	Obtiene los precios reales de participación a partir de los 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 de 2 a 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 vigentes; las series calculadas se indican por separado.
list_company_disclosures	symbol, days, limit	Lista los avisos KAP registrados de la empresa de más reciente a más antiguo.
list_fund_leaders	period, direction, category, limit	Lista los fondos ganadores/perdedores del período; el permiso del módulo de 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	Lista nombres de periódicos, valores slug y primeras/últimas fechas de archivo disponibles; no garantiza la existencia de los días intermedios.
get_newspaper_headlines	date, limit, offset	Lista las portadas de periódicos registradas del día solicitado con enlaces a la fuente y a las 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/recorte; en fechas faltantes no pasa a otro día.

Ejemplos de llamadas

Listar herramientas:

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

Obtener las últimas cinco noticias:

curl -X POST 'https://ekonomikosesi.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 y portadas de periódicos

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 devuelven un máximo de 50 resultados y offset de 0 a 1000. En fechas no disponibles en el archivo no se pasa a otro día; las primeras/últimas fechas de 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 y con enlaces a la 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://ekonomikosesi.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://ekonomikosesi.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://ekonomikosesi.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 del texto completo y presentación de fecha/fuente.
• Lectura de datos bursátiles — Lectura de datos de acciones registrados conservando la distinción entre fuente y hora de los datos.
• Titulares de periódicos — Verificación del nombre del periódico y la fecha solicitada, y presentación de la imagen de 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 de API — /auth.md.
• Atribución obligatoria. Al utilizar contenido de Ekonomi Köşesi, 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 los derechos de autor de sus respectivos titulares. El acceso no otorga una licencia de reutilización; conserve la información de fuente/licencia existente y no asuma una licencia no indicada.
• Formato de errores: los errores de protección HTTP se devuelven como error JSON-RPC con application/json; los errores de herramientas se devuelven con isError de MCP. 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 de confianza; search y search_news juntas 60 llamadas/minuto. Las herramientas financieras tienen además un límite común de 30 llamadas/minuto; las tres herramientas de periódicos tienen un límite 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 fijas por minuto.
• En respuesta 429, espere el tiempo de Retry-After. Los encabezados X-RateLimit-Limit, Remaining y Reset muestran la cuota general. Si el servicio de cuotas Redis no está disponible, las herramientas devuelven 503 y Retry-After: 5.
• Límite de cuerpo de 256 KiB; no se admiten batch 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 herramientas se explican con isError de MCP.
• No se presentan noticias eliminadas, borradores, con fecha futura o retiradas de este sitio. No hay 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 financieros y contenidos 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 tiempos 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 a la fuente.

Manifiesto de descubrimiento MCP · llms.txt