npm package: @flipfactory-it/mcp-reputation
Description: MCP Reputation Monitor — Zero-cost online reputation monitoring via DuckDuckGo + sentiment analysis
Author: FlipFactory
Latest version: 2.0.0

# MCP Reputation Monitor

[![npm version](https://img.shields.io/npm/v/@flipfactory/mcp-reputation)](https://www.npmjs.com/package/@flipfactory/mcp-reputation)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Tests](https://img.shields.io/badge/tests-passing-brightgreen)](.)

Track, compare, and analyze business reviews and ratings with AI. Search Google Maps reviews, compare competitors, get AI-powered reputation analysis, and set up monitoring alerts.

## Quick Start

```bash
npm install @flipfactory/mcp-reputation
```

Add to your Claude Desktop config:

```json
{
  "mcpServers": {
    "reputation": {
      "command": "npx",
      "args": ["@flipfactory/mcp-reputation"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "AIza...",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}
```

## Tools

| Tool | Description | API Key Required |
|------|-------------|-----------------|
| `reputation_search` | Search Google Maps reviews for a business | `GOOGLE_MAPS_API_KEY` |
| `reputation_compare` | Compare 2+ businesses by ratings and reviews | None |
| `reputation_analyze` | AI analysis of reputation patterns | `ANTHROPIC_API_KEY` |
| `reputation_alert` | Set monitoring alert for rating drops | None |

## Configuration

| Variable | Required | Description |
|----------|----------|-------------|
| `GOOGLE_MAPS_API_KEY` | For reputation_search | Google Maps Places API key |
| `ANTHROPIC_API_KEY` | For reputation_analyze | Claude API key |
| `CLAUDE_MODEL` | No | Claude model (default: claude-sonnet-4-20250514) |

## Examples

### Search for business reviews

```
"Find reviews for Miami Dental Clinic"
-> reputation_search(business_name: "Miami Dental Clinic", location: "Miami, FL")
```

### Compare competitors

```
"Compare these 3 restaurants by reputation"
-> reputation_compare(businesses: [{name: "A", rating: 4.5, totalReviews: 200}, ...])
```

### AI reputation analysis

```
"Analyze the reviews for Acme Corp"
-> reputation_analyze(business_name: "Acme Corp", reviews: [...])
```

### Set monitoring alert

```
"Alert me when Acme drops below 4.0"
-> reputation_alert(business_name: "Acme Corp", min_rating: 4.0, notify_email: "admin@acme.com")
```

## Built-in Features

- **Rate Limiting** -- Per-tool limits to protect API quotas
- **Caching** -- 1-hour cache for searches and analysis results
- **Smart Defaults** -- Minimal required params, sensible defaults
- **Structured Output** -- Typed JSON responses
- **Helpful Errors** -- Clear messages when API keys are missing or limits hit

## Development

```bash
npm install
npm run dev      # Watch mode
npm test         # Run tests
npm run build    # Compile TypeScript
```

## Pricing

| Plan | Price | Includes |
|------|-------|----------|
| Starter | **$19/mo** | reputation_search + reputation_compare + reputation_alert |
| Pro | **$39/mo** | All tools including AI-powered reputation_analyze |

Available on [Smithery](https://smithery.ai)

## License

MIT -- [FlipFactory](https://flipfactory.it.com)