Dijital Sürmanşet MCP

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

Guia do desenvolvedor MCP

O Dijital Sürmanşet 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 dados registrados dos módulos financeiros abertos neste site. Não é necessário login ou chave de API.

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

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

Como conectar?

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

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, 1h, 1m, 3m, 6m, ad, 3a e 5a.

Ferramenta	Campos de entrada	Descrição
get_latest_news	limite, categoria	Busca as notícias mais recentes publicadas; 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	consulta, limite, categoria	Pesquisa em títulos, descrições e palavras-chave de notícias; pode ser limitado por categoria.
get_category_news	categoria, limite	Lista as notícias mais recentes publicadas em uma categoria específica.
list_categories	idioma	Lista as categorias principais ativas com nomes e slugs.
search	consulta, limite	Retorna resultados curtos de notícias e IDs no formato artigo:123 que podem ser usados para busca.
fetch	id	Busca o texto completo e as informações de fonte da notícia pelo ID de conteúdo obtido no resultado da busca.
search_financial_assets	consulta, tipo, limite	Busca ações e fundos ativos por código ou nome; lista apenas os tipos de ativos abertos neste site.
get_stock_quote	símbolo	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	símbolo, dias	Busca apenas fechamentos reais registrados; não faz requisições a fontes externas nem gera preços sintéticos.
get_fund_details	código	Busca ficha do fundo, preço da cota, categoria, taxas, valor de risco e distribuição atual de ativos.
get_fund_history	código, dias	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	código	Apresenta retornos registrados diários, semanais, mensais e de longo prazo em percentual.
compare_funds	códigos, período	Compara de 2 a 5 fundos diferentes no mesmo período; indica dados ausentes e diferenças de datas.
get_market_overview	limite	Busca listas de índices abertos e ações da rodada mais recente; seções fechadas não são chamadas.
get_stock_financials	símbolo	Busca demonstrações financeiras registradas da empresa com períodos e unidades atuais; séries calculadas são indicadas separadamente.
list_company_disclosures	símbolo, dias, limite	Lista os avisos KAP registrados da empresa do mais recente para o mais antigo.
list_fund_leaders	período, direção, categoria, limite	Lista fundos vencedores/perdedores periódicos; a permissão do módulo para a direção é verificada separadamente.
get_fund_holdings	código, limite	Busca as maiores posições em ações do fundo registradas; não afirma ser a carteira completa.
list_newspapers	consulta, limite	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	data, limite, deslocamento	Lista as primeiras páginas de jornais registradas do dia solicitado com fonte e links de imagem; se não houver data, usa Istambul hoje.
get_newspaper_front_page	jornal, data	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://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"}'

Buscar as cinco últimas notícias:

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

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 AAAA-MM-DD; dias futuros não são aceitos. Pode-se usar o nome do jornal ou o slug. Listas diárias aceitam no máximo 50 resultados e deslocamento 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://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":{}}}'

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

Primeira página do jornal Akşam de 8 de novembro 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 é 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 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 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 Dijital Sürmanşet, 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 a 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 com 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 cota conjunta de 30 chamadas/minuto; as três ferramentas de jornais têm cota conjunta de 60 chamadas/minuto; a ferramenta de imagem de jornal único tem cota separada de 10 chamadas/minuto. Todas também consomem a cota geral. Janelas fixas de minuto são aplicadas.
• 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 indisponível, as ferramentas retornam 503 e Retry-After: 5.
• Limite de corpo: 256 KiB; batch e IDs de sessão MCP não são suportados. Se Origin estiver presente, deve ser do mesmo site.
• JSON inválido 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 com isError do MCP.
• Notícias excluídas, em rascunho, 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?

Chamadas financeiras leem apenas 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 e conteúdos financeiros aqui apresentados não constituem recomendação de investimento. 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, data_date é a data real dos dados, se houver; 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.

No histórico de preços, há 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