AllNewsAPI

Busca de notícias ao vivo, principais manchetes e uso da API via AllNewsAPI, com filtros de sentimento por IA e entidades.

GitHub

Experimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://mcp.allnewsapi.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

AllNewsAPI MCP

Obtenha acesso a dados de notícias em tempo real e históricos, incluindo manchetes principais de fontes globais via AllNewsAPI. Suporta múltiplas opções de filtro, incluindo busca por palavras-chave, categoria, idioma e mais. Este servidor Model Context Protocol permite que clientes MCP (Claude, Cursor, VS Code, Windsurf e outros) pesquisem artigos de notícias, obtenham manchetes principais e verifiquem seu uso da API.

Você precisará de uma chave de API — obtenha uma em allnewsapi.com.

Início rápido

Escolha uma das duas formas de conectar.

Hospedado (sem instalação)

Aponte seu cliente para o servidor hospedado e passe sua chave de API no cabeçalho X-API-Key:

{
  "mcpServers": {
    "allnewsapi": {
      "type": "remote",
      "url": "https://mcp.allnewsapi.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Prefere uma configuração apenas com URL? Use https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE em vez do cabeçalho.

A chave pode ser fornecida de três formas, nesta ordem de precedência: o cabeçalho X-API-Key, o parâmetro de consulta apikey ou um cabeçalho Authorization: Bearer YOUR_API_KEY_HERE (um fallback para clientes que suportam apenas tokens bearer).

Local (npx)

Executa o servidor na sua máquina via npx — sem necessidade de clonar ou compilar:

{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
    }
  }
}

Você também pode fornecer a chave como uma variável de ambiente ALLNEWSAPI_KEY em vez de --apikey.

Configuração específica por cliente

Claude Desktop

Edite sua configuração (Settings → Developer → Edit Config) e adicione o trecho local ou hospedado acima. Guia completo: modelcontextprotocol.io/quickstart/user.

Cursor

Cursor Settings → MCP → Add new MCP Server. Nomeie como "AllNewsAPI", escolha o tipo command e insira:

npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

VS Code

code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'

O servidor estará então disponível para seu agente GitHub Copilot. Guia completo: Documentação MCP do VS Code.

Windsurf

Adicione o trecho local ou hospedado acima à sua configuração MCP. Guia completo: Documentação MCP do Windsurf.

Claude Code

Adicione pelo terminal — local:

claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

Ou o servidor hospedado:

claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"

Claude Cowork

O Cowork roda dentro do Claude Desktop. Adicione o servidor hospedado como um conector personalizado — Customize → Connectors → + — e insira a URL com sua chave:

https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE

Para uma configuração local, use a configuração do Claude Desktop mostrada acima.

OpenWork

OpenWork é uma alternativa open-source ao Cowork com suporte a MCP. Adicione AllNewsAPI usando o comando local (npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE) ou a URL hospedada acima, seguindo a configuração MCP do OpenWork.

Qualquer outro cliente MCP: aponte-o para a URL hospedada (https://mcp.allnewsapi.com/mcp) ou execute o comando npx allnewsapi-mcp@latest com sua chave de API.

Ferramentas

`search-news`

Pesquise artigos por palavra-chave, data e filtros.

Parâmetro	Tipo	Descrição
`q`	string	Palavras-chave para pesquisar
`startDate` / `endDate`	string	Intervalo de datas (`YYYY-MM-DD`)
`content`	boolean	Incluir conteúdo completo do artigo (padrão: false)
`lang`	string	Código(s) de idioma, ex.: `en`, `fr`
`country`	string	Código(s) de país, ex.: `us`, `gb`
`region`	string	Região(ões), ex.: `americas`, `europe`
`category`	string	Categoria(s), ex.: `business`
`max`	number	Número de artigos, 1–100 (padrão: 5)
`page`	number	Número da página (padrão: 1)
`attributes`	string	Onde corresponder palavras-chave: `title`, `description`, `content`
`sortby`	string	`publishedAt` ou `relevance`
`publisher`	string	Filtrar por editor(es)
`ai_sentiment`	string	`positive`, `negative` ou `neutral`
`ai_entity_name`	string	Entidade nomeada, ex.: `Apple`
`ai_entity_type`	string	Tipo de entidade, ex.: `person`, `organization`, `location`

`headlines`

Obtenha manchetes principais, opcionalmente filtradas.

Parâmetro	Tipo	Descrição
`country`	string	Código(s) de país, ex.: `us`, `gb`
`category`	string	Categoria, ex.: `technology`
`lang`	string	Código de idioma, ex.: `en`
`max`	number	Número de artigos, 1–100 (padrão: 5)
`ai_sentiment`	string	`positive`, `negative` ou `neutral`
`ai_entity_name`	string	Entidade nomeada, ex.: `Apple`
`ai_entity_type`	string	Tipo de entidade, ex.: `person`, `organization`, `location`

`usage`

Verifique seu plano, limites de solicitação e cota restante. Sem parâmetros.

Nota sobre o plano: Filtros avançados — country, region, category, publisher, lang, attributes e sortby — exigem um plano pago. No plano gratuito, use search-news com q e max. Consulte preços.

Filtragem por IA

search-news e headlines aceitam filtros analisados por IA:

ai_sentiment — sentimento geral do artigo (positive, negative, neutral)
ai_entity_name — uma entidade nomeada no artigo (ex.: United Nations)
ai_entity_type — categoria da entidade (person, organization, location)

Os artigos retornados também podem incluir pontuações de sentimento por IA, entidades detectadas e um breve resumo por IA quando disponível.

Exemplos de prompts

"Obtenha as últimas notícias de tecnologia dos EUA"
"Encontre artigos sobre mudanças climáticas de fontes europeias"
"Mostre-me as principais manchetes de negócios da última semana"
"Encontre notícias positivas sobre energia renovável"
"Mostre-me artigos mencionando a Apple como organização"
"Verifique meu uso da API e cota restante"

Valores suportados

Listas completas de valores aceitos estão na documentação da AllNewsAPI: