topic-scout-mcp/NPM_PUBLISH_GUIDE.md

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

# Guia de Publicação no NPM

## Pré-requisitos

1. **Conta no npm**: Crie uma conta em https://www.npmjs.com/
2. **Login no CLI**: Execute `npm login` no terminal
3. **Nome único**: Verifique se o nome `topic-scout-mcp` está disponível

## Passos para Publicação

### 1. Verificar se o nome está disponível

```bash
npm search topic-scout-mcp
```

### 2. Login no npm

```bash
npm login
```

### 3. Verificar configuração do package.json

Certifique-se de que o `package.json` está correto:

```json
{
  "name": "topic-scout-mcp",
  "version": "1.0.0",
  "description": "MCP Server para buscar notícias e identificar tendências sobre tópicos específicos",
  "main": "dist/index.js",
  "bin": {
    "topic-scout-mcp": "dist/cli.js"
  },
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js",
    "dev": "tsx src/index.ts",
    "cli": "tsx src/cli.ts",
    "test-cli": "node test-cli.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^0.4.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "tsx": "^4.0.0",
    "typescript": "^5.0.0"
  },
  "keywords": ["mcp", "news", "trending", "topics", "media"],
  "author": "Topic Scout",
  "license": "MIT"
}
```

### 4. Compilar o projeto

```bash
npm run build
```

### 5. Testar localmente

```bash
# Testar o CLI
npm run test-cli

# Testar com npx
npx topic-scout-mcp -y test-server
```

### 6. Publicar no npm

```bash
npm publish
```

### 7. Verificar publicação

```bash
npm view topic-scout-mcp
```

## Após a Publicação

### Testar o pacote publicado

```bash
# Remover instalação local (se houver)
npm uninstall -g topic-scout-mcp

# Testar via npx
npx topic-scout-mcp -y test-server
```

### Atualizações

Para atualizar o pacote:

1. Incrementar a versão no `package.json`
2. Compilar: `npm run build`
3. Publicar: `npm publish`

```bash
# Incrementar versão patch
npm version patch

# Ou manualmente no package.json
# "version": "1.0.1"
```

## Configuração MCP Após Publicação

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

## Troubleshooting

### Erro: "Package name already exists"
- Escolha um nome diferente no `package.json`
- Exemplo: `topic-scout-mcp-server`

### Erro: "You must be logged in"
- Execute `npm login` novamente

### Erro: "Invalid package name"
- Verifique se o nome segue as regras do npm
- Use apenas letras minúsculas, números e hífens

### Erro: "Missing files"
- Certifique-se de que executou `npm run build`
- Verifique se a pasta `dist/` existe