topic-scout-mcp/example-usage.md

MCP Server para buscar notícias e identificar tendências sobre tópicos específicos

# Exemplo de Uso - Topic Scout MCP

## Publicação no NPM

Primeiro, publique o pacote no npm:

```bash
npm login
npm publish
```

## Instalação e Uso

### Via npx (recomendado)

```bash
# Executar diretamente via npx
npx topic-scout-mcp -y

# Executar com nome personalizado do servidor
npx topic-scout-mcp -y my-news-server

# Executar com flag longa
npx topic-scout-mcp --yes custom-server-name
```

### Instalação global (opcional)

```bash
npm install -g topic-scout-mcp

# Executar com confirmação automática
topic-scout-mcp -y

# Executar com nome personalizado do servidor
topic-scout-mcp -y my-news-server
```

## Configuração da API Key

```bash
export NEWS_API_KEY="sua_chave_da_newsapi_aqui"
```

## Configuração MCP

Adicione ao seu arquivo de configuração MCP:

```json
{
  "mcpServers": {
    "topic-scout": {
      "command": "npx",
      "args": ["topic-scout-mcp", "-y", "topic-scout-server"],
      "env": {
        "NEWS_API_KEY": "sua_chave_aqui"
      }
    }
  }
}
```

## Exemplos de Comandos

### Buscar notícias sobre tecnologia
```
Claude, execute search_news_articles com topic "Technology", timeframe "7d" e max_articles 20
```

### Buscar fontes de notícias de negócios
```
Claude, execute get_news_sources com category "business" e language "en"
```

### Buscar notícias sobre imóveis em português
```
Claude, execute search_news_articles com topic "Real Estate", language "pt" e timeframe "30d"
```

## Resposta Típica

```
📰 **NOTÍCIAS SOBRE "TECHNOLOGY"** 📰

📊 Encontrados 1,247 artigos nos últimos 7d
📋 Analisando 20 artigos mais relevantes

📑 **ARTIGOS ENCONTRADOS:**

1. **AI Breakthrough in Machine Learning**
   📰 Fonte: TechCrunch
   📅 Data: 15/12/2024
   📝 Resumo: Researchers have made significant progress in AI development...
   🔗 URL: https://example.com/article1

2. **New Smartphone Features Announced**
   📰 Fonte: The Verge
   📅 Data: 14/12/2024
   📝 Resumo: Latest smartphone models include advanced features...
   🔗 URL: https://example.com/article2

💡 **DADOS PARA ANÁLISE:**
• Total de artigos: 20
• Período analisado: 7d
• Fontes principais: TechCrunch (5), The Verge (3), Wired (2)

🔍 **PRÓXIMOS PASSOS:**
• Analise os títulos e resumos para identificar temas recorrentes
• Identifique as fontes mais ativas sobre o tópico
• Compare com outros tópicos relacionados se necessário
```

## Desenvolvimento Local

```bash
# Instalar dependências
npm install

# Compilar
npm run build

# Executar em desenvolvimento
npm run dev

# Testar CLI
npm run cli

# Publicar no npm
npm publish
```