Metadata-Version: 2.5
Name: scrapereviews-mcp
Version: 0.1.0
Summary: MCP server for the ScrapeReviews API: Trustpilot companies, reviews and categories
Project-URL: Homepage, https://scrapereviews.com
Project-URL: Documentation, https://scrapereviews.com/docs/mcp
Project-URL: Repository, https://github.com/scrapereviews/mcp-server
Author: ScrapeReviews
License-Expression: MIT
License-File: LICENSE
Keywords: ai,mcp,reviews,trustpilot
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: mcp[cli]<2,>=1.2
Provides-Extra: dev
Requires-Dist: pytest-asyncio<2,>=0.24; extra == 'dev'
Requires-Dist: pytest<10,>=8.0; extra == 'dev'
Requires-Dist: respx<1,>=0.22; extra == 'dev'
Description-Content-Type: text/markdown

# ScrapeReviews MCP Server

<!-- mcp-name: com.scrapereviews/scrapereviews -->

An [MCP](https://modelcontextprotocol.io) server that gives AI assistants (Claude Desktop, Cursor, etc.) access to Trustpilot company profiles, reviews and category rankings via the [ScrapeReviews](https://scrapereviews.com) API.

## Features

**5 Tools** — search companies, company profile, filtered reviews, category tree, category rankings

**4 Documentation Resources** — API reference, quickstart guide, pricing, workflow examples

**3 Prompt Templates** — analyze company reviews, compare companies, find best companies in a category

Tool results are compact JSON (nulls and logos dropped) and always include `credits_used`.

## Quick Start

### 1. Get an API Key

Sign up at [scrapereviews.com](https://scrapereviews.com) and create an API key from the dashboard (100 free credits every month).

### 2. Configure Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "scrapereviews": {
      "command": "uvx",
      "args": ["scrapereviews-mcp"],
      "env": {
        "SCRAPEREVIEWS_API_KEY": "your_api_key"
      }
    }
  }
}
```

### 3. Use it

Ask Claude:
- "What do customers complain about on Trustpilot for zalando.it?"
- "Compare monzo.com and revolut.com on Trustpilot"
- "Which banks in Italy have a TrustScore above 4?"

## Configuration for Other Clients

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "scrapereviews": {
      "command": "uvx",
      "args": ["scrapereviews-mcp"],
      "env": {
        "SCRAPEREVIEWS_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add scrapereviews -e SCRAPEREVIEWS_API_KEY=your_api_key -- uvx scrapereviews-mcp
```

## Installation Alternatives

### pip

```bash
pip install scrapereviews-mcp
SCRAPEREVIEWS_API_KEY=... scrapereviews-mcp
```

### npx

```bash
SCRAPEREVIEWS_API_KEY=... npx scrapereviews-mcp
```

### Docker

```bash
docker build -t scrapereviews-mcp . && docker run -i --rm -e SCRAPEREVIEWS_API_KEY=... scrapereviews-mcp
```

## Tools

| Tool | Description | Cost |
|------|-------------|------|
| `search_companies` | Find companies by name or domain | 1 credit / 10 results |
| `get_company` | Profile: TrustScore, star distribution, reply rate, contacts | 2 credits |
| `get_reviews` | Reviews filtered by stars, language, dates, verified, reply, text; cursor pagination | 1 credit / 5 reviews |
| `list_categories` | Trustpilot category tree | 1 credit |
| `get_category_companies` | Company ranking of a category in a country | 1 credit / 10 companies |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `SCRAPEREVIEWS_API_KEY` | Yes | Your API key |
| `SCRAPEREVIEWS_BASE_URL` | No | Override API base URL (default: `https://api.scrapereviews.com`) |

## Development

```bash
uv venv -p 3.12 && uv pip install -e ".[dev]"
.venv/bin/pytest
```

Test with MCP Inspector:

```bash
SCRAPEREVIEWS_API_KEY=... mcp dev dev_server.py
```

## License

MIT
