Ekonomi Köşesi MCP

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

Guia do desenvolvedor MCP

O Ekonomi Köşesi oferece acesso somente leitura, a partir de aplicações de inteligência artificial, às suas notícias publicadas, primeiras páginas de jornais registradas e aos dados registrados dos módulos financeiros abertos neste site. Não é necessário login ou chave de API.

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

Este endereço é uma página de descrição via GET; as chamadas MCP são feitas via POST sobre Streamable HTTP. O GET não abre uma sessão SSE.

Como conectar?

Adicione o registro abaixo ao arquivo indicado, preservando suas configurações atuais. Os exemplos de Claude e Gemini referem-se a clientes Code/CLI; o Codex usa 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"

Ferramentas disponíveis

Somente as ferramentas abertas neste site são listadas. Listas de notícias e busca de ativos retornam no máximo 50 resultados.

No histórico financeiro, podem ser usados 30, 90, 180, 365 ou 730 dias (padrão: 365).

A comparação de fundos aceita de 2 a 5 códigos diferentes; o período padrão é 1a, e os demais períodos são 1d, 1m, 1t, 3m, 6m, aa, 3a e 5a.

Ferramenta	Campos de entrada	Descrição
get_latest_news	limit, category	Busca as notícias mais recentes; um filtro opcional por categoria pode ser usado.
get_article	id, slug	Busca o texto completo, data, categoria e informações de fonte da notícia pelo ID numérico da URL ou pelo slug.
search_news	query, limit, category	Pesquisa em títulos, descrições e palavras-chave de notícias; pode ser limitado por categoria.
get_category_news	category, limit	Lista as notícias mais recentes publicadas em uma categoria específica.
list_categories	language	Lista as categorias principais ativas com nomes e slugs.
search	query, limit	Retorna resultados curtos de notícias e IDs no formato article:123 que podem ser usados para busca.
fetch	id	Busca o texto completo e as informações de fonte da notícia usando o ID de conteúdo obtido no resultado da busca.
search_financial_assets	query, type, limit	Busca ações e fundos ativos por código ou nome; lista apenas os tipos de ativos abertos neste site.
get_stock_quote	symbol	Busca o último preço registrado, variação e informações básicas; não há garantia de preço em tempo real.
get_stock_history	symbol, days	Busca apenas fechamentos reais registrados; não faz requisições a fontes externas nem gera preços sintéticos.
get_fund_details	code	Busca a ficha do fundo, preço da cota, categoria, taxas, valor de risco e a distribuição atual de ativos.
get_fund_history	code, days	Busca preços reais de cotas a partir de registros diários; não apresenta índice aproximado de retorno como preço.
get_fund_returns	code	Apresenta retornos registrados diários, semanais, mensais e de longo prazo em percentual.
compare_funds	codes, period	Compara de 2 a 5 fundos diferentes no mesmo período; indica dados ausentes e diferenças de datas.
get_market_overview	limit	Busca os índices abertos e as listas de ações da rodada mais recente; seções fechadas não são chamadas.
get_stock_financials	symbol	Busca os demonstrativos financeiros registrados da empresa com períodos e unidades atuais; séries calculadas são indicadas separadamente.
list_company_disclosures	symbol, days, limit	Lista os avisos KAP registrados da empresa, do mais recente para o mais antigo.
list_fund_leaders	period, direction, category, limit	Lista fundos que ganharam/perderam no período; a permissão do módulo para a direção é verificada separadamente.
get_fund_holdings	code, limit	Busca as maiores posições em ações do fundo registradas; não afirma ser o portfólio completo.
list_newspapers	query, limit	Lista nomes de jornais, slugs e primeiras/últimas datas de arquivo disponíveis; não garante a existência dos dias intermediários.
get_newspaper_headlines	date, limit, offset	Lista as primeiras páginas de jornais registradas para o dia solicitado, com fonte e links de imagem; se não houver data, usa Istambul hoje.
get_newspaper_front_page	newspaper, date	Busca a primeira página completa do jornal na data solicitada com imagem MCP e links. Não faz OCR/recorte; em data ausente, não avança para outro dia.

Exemplos de chamadas

Listar ferramentas:

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"}'

Buscar as cinco últimas notícias:

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}}}'

Manchetes de jornais e primeiras páginas

Se nenhuma data for fornecida, usa-se hoje conforme Europe/Istanbul. As datas devem ser dias reais no formato YYYY-MM-DD; dias futuros não são aceitos. Pode-se usar o nome do jornal ou o slug. As listas diárias retornam no máximo 50 resultados e aceitam offset de 0 a 1000. Em datas ausentes no arquivo, não se avança para outro dia; as primeiras/últimas datas de arquivo não garantem que todos os dias intermediários existam.

A chamada de um único jornal retorna a primeira página completa com conteúdo de imagem MCP e links de fonte/imagem. Não é feito OCR nem recorte de notícias. Se a imagem grande não couber no limite de 2 MiB, tenta-se a imagem pequena disponível; o tempo total de leitura é de 10 segundos. Quando a imagem não pode ser anexada, retorna image_embedded: false e um aviso explicativo.

Manchetes do dia:

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":{}}}'

Primeira página de hoje do jornal 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"}}}'

Primeira página do jornal Akşam de 8 de novembro 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 é um exemplo de chamada; não há garantia de que exista arquivo nessa data.

Habilidades do agente

Índice de descoberta de habilidades deste site: /.well-known/agent-skills/index.json. Os arquivos de habilidade explicam como usar as ferramentas; este índice é uma superfície de descoberta oferecida pelo site.

• Pesquisa de notícias — Busca de notícias, obtenção de texto completo e indicação de data/fonte.
• Leitura de dados de bolsa — Leitura de dados de ações registrados, preservando a distinção entre fonte e horário dos dados.
• Manchetes de jornais — Verificação do nome do jornal e da data solicitada, exibindo a imagem da primeira página completa do arquivo com a fonte.
• Comparação de fundos — Comparação de fundos no mesmo período, preservando datas dos dados e valores ausentes.

Regras e limites

• Gratuito. Não há plano de pagamento ou assinatura para o MCP — /pricing.md. O aplicativo ao qual você se conecta pode ter seus próprios custos.
• Sem autenticação. Não é necessária conta, token ou chave de API — /auth.md.
• Atribuição obrigatória. Ao usar conteúdo do Ekonomi Köşesi, forneça link para o endereço permanente da notícia ou página de dados relevante.
• Dados de treinamento: ai-train=no — não queremos que o conteúdo seja incluído em conjuntos de dados de treinamento de modelos; robots.txt. Essa preferência não é garantia de que todos os clientes a cumprirão.
• Direitos de imagem. Imagens de notícias e primeiras páginas de jornais podem estar sujeitas aos direitos autorais dos respectivos titulares. O acesso não concede licença de reutilização; preserve as informações de fonte/licença existentes e não presuma licenças não indicadas.
• Formato de erro: erros de proteção HTTP retornam erro JSON-RPC com application/json; erros de ferramenta retornam via MCP isError. RFC 9457 application/problem+json não é usado.

Guia de uso completo: /AGENTS.md.

Segurança e limites

• 120 requisições/minuto por site + IP confiável; search e search_news juntas: 60 chamadas/minuto. Ferramentas financeiras têm adicionalmente uma cota comum de 30 chamadas/minuto; as três ferramentas de jornais têm uma cota comum de 60 chamadas/minuto; a ferramenta de imagem de jornal único tem uma cota separada de 10 chamadas/minuto. Todas também consomem da cota geral. São aplicadas janelas fixas de minuto.
• Em resposta 429, aguarde o tempo de Retry-After. Os cabeçalhos X-RateLimit-Limit, Remaining e Reset indicam a cota geral. Se o serviço de cota Redis estiver inacessível, as ferramentas retornam 503 e Retry-After: 5.
• Limite de corpo de 256 KiB; batch e IDs de sessão MCP não são suportados. Se Origin estiver presente, deve pertencer ao mesmo site.
• JSON malformado retorna 400, Origin não permitido retorna 403, corpo excessivo retorna 413, ID de sessão retorna 404 e método HTTP não suportado retorna 405. Erros internos de ferramenta são explicados via MCP isError.
• Notícias excluídas, rascunhos, com data futura ou removidas da publicação neste site não são exibidas. Não há ferramentas para adicionar/editar/excluir conteúdo.

Como ler dados financeiros?

As chamadas financeiras apenas leem o banco de dados e o cache; não fazem requisições a provedores externos. Os dados têm atraso de 15 minutos. Os dados financeiros e conteúdos aqui apresentados não constituem recomendação de investimento. Os preços não têm garantia de tempo real. retrieved_at é o horário de acesso, record_updated_at é o horário de atualização do registro e data_date, se presente, é a data real dos dados; não são intercambiáveis. Fonte e horário desconhecidos não são estimados. Números ausentes permanecem como null, e avisos são transmitidos junto com o resultado.

O histórico de preços contém apenas registros reais. Índices aproximados de retorno, preços preenchidos para dias sem negociação ou preços sintéticos de hoje não são apresentados. Na comparação de fundos, considere as diferentes datas de dados; retornos passados não garantem retornos futuros. Ao transmitir conteúdo e dados, preserve o link da fonte.

Manifesto de descoberta MCP · llms.txt