# Scrape.ly

Scrape.ly is an MCP server for Claude Code that finds Actors in the Scrape.ly Store, runs them, and retrieves their data. It can also search Scrape.ly and Crawlee docs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: scrapely-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/scrapely-app/scrapely-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/scrapely

## What it does

Scrape.ly lets an agent browse Actors, inspect their README files and input schemas, start runs, and retrieve outputs. Results can come from datasets, key-value stores, and logs. The server also searches Scrape.ly and Crawlee documentation and manages saved tasks and automations.

Connect to the hosted HTTP endpoint or run the stdio server locally. Hosted access uses OAuth or a Scrape.ly token; local setup requires Python 3.11 or newer. Provide the token through `SCRAPELY_TOKEN` or a Scrape.ly credentials file. Actor search, Actor detail lookup, and documentation tools can work without a token.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.scrape.ly`
- Environment variables: `SCRAPELY_TOKEN`, `SCRAPELY_API_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env SCRAPELY_TOKEN=<SCRAPELY_TOKEN> --env SCRAPELY_API_BASE_URL=<SCRAPELY_API_BASE_URL> --transport stdio scrapely -- uvx scrapely-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from scrapely-mcp <command>

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http scrapely https://mcp.scrape.ly
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add scrapely --url https://mcp.scrape.ly
```

2. **Platform CLI**
```bash
codex mcp add scrapely --env SCRAPELY_TOKEN=<SCRAPELY_TOKEN> --env SCRAPELY_API_BASE_URL=<SCRAPELY_API_BASE_URL> -- uvx scrapely-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from scrapely-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scrapely": {
            "url": "https://mcp.scrape.ly"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scrapely": {
            "command": "uvx",
            "args": [
                "scrapely-mcp"
            ],
            "env": {
                "SCRAPELY_TOKEN": "<SCRAPELY_TOKEN>",
                "SCRAPELY_API_BASE_URL": "<SCRAPELY_API_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from scrapely-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scrapely": {
            "type": "http",
            "url": "https://mcp.scrape.ly"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scrapely": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "scrapely-mcp"
            ],
            "env": {
                "SCRAPELY_TOKEN": "<SCRAPELY_TOKEN>",
                "SCRAPELY_API_BASE_URL": "<SCRAPELY_API_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from scrapely-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http scrapely https://mcp.scrape.ly
```

2. **Platform CLI**
```bash
gemini mcp add -e SCRAPELY_TOKEN=<SCRAPELY_TOKEN> -e SCRAPELY_API_BASE_URL=<SCRAPELY_API_BASE_URL> scrapely uvx scrapely-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from scrapely-mcp <command>

## When to use it
- find an Actor and inspect its input schema
- run an Actor and retrieve dataset records
- check a run's status and read its logs
- search Scrape.ly or Crawlee documentation
- manage saved Scrape.ly tasks and automations

## Example prompts
- Find an Actor for product data collection and show its input schema.
- Run the Actor and return records from its dataset.
- Search the Scrape.ly docs for instructions on managing a saved task.

## Similar
- [apify-actor-development](https://affpapa.org/en/nevibecode/skills/apify-actor-development.md) — skill · 11000 installs
- [Apify](https://affpapa.org/en/nevibecode/mcp/apify.md) — MCP server · 218 installs
- [scrape](https://affpapa.org/en/nevibecode/skills/scrape.md) — skill · 1002 installs
- [pp-scrape-creators](https://affpapa.org/en/nevibecode/skills/pp-scrape-creators.md) — skill · 574 installs
- [firecrawl-scrape](https://affpapa.org/en/nevibecode/skills/firecrawl-scrape.md) — skill · 84400 installs
- [facebook-groups-scrape-posts](https://affpapa.org/en/nevibecode/skills/facebook-groups-scrape-posts.md) — skill · 1 install

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
