# scrapi

Hands your agent a web page as clean Markdown or text, with headings, lists and links kept. Useful when a task starts from a link rather than a file.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: bamchi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bamchi/scrapi-mcp-server
- Updated: 2026-05-27
- HTML: https://affpapa.org/en/nevibecode/mcp/scrapi

## What it does

scrapi is an MCP server that takes a URL and returns page content an LLM can read straight away. Metadata comes along too: title, author, date, images. JavaScript-heavy pages get rendered, so single-page apps are not a dead end.

Two transports are available. The stdio mode runs through `npx` and needs Node.js 20+; the HTTP mode points at `https://scrapi.ai/mcp` and asks for nothing installed on the client. Your key goes in `SCRAPI_API_KEY` or in the `--api-key` argument. Rate-limited responses come back with 429 and the server retries them on its own, following `Retry-After`.

You need a Scrapi MCP account, which is separate from the main Scrapi account, and a key starting with `hsmcp_`. Grab the key from the dashboard first — the server will not start without it, so editing your client config before that is wasted work.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://scrapi.ai/mcp`
- Environment variables: `SCRAPI_API_KEY` — 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: remote server**
```bash
claude mcp add --transport http scrapi https://scrapi.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SCRAPI_API_KEY=<SCRAPI_API_KEY> --transport stdio scrapi -- npx -y @scrapi.ai/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add scrapi --url https://scrapi.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add scrapi --env SCRAPI_API_KEY=<SCRAPI_API_KEY> -- npx -y @scrapi.ai/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scrapi": {
            "url": "https://scrapi.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scrapi": {
            "command": "npx",
            "args": [
                "-y",
                "@scrapi.ai/mcp-server"
            ],
            "env": {
                "SCRAPI_API_KEY": "<SCRAPI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scrapi": {
            "type": "http",
            "url": "https://scrapi.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scrapi": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@scrapi.ai/mcp-server"
            ],
            "env": {
                "SCRAPI_API_KEY": "<SCRAPI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http scrapi https://scrapi.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SCRAPI_API_KEY=<SCRAPI_API_KEY> scrapi npx -y @scrapi.ai/mcp-server
```
Replace <…> with your own values

## When to use it
- read a linked article and summarise it without ad clutter
- pull the title, author and publish date off a page
- extract text from a site that renders in JavaScript
- get a page's headings and links as a plain list
- feed documentation to an agent by URL instead of pasting it

## Example prompts
- Open https://scrapi.ai/mcp and list the endpoints it exposes
- Convert this page to Markdown and save it as `notes.md`
- Pull the title, author and date from this link

## Similar
- [firecrawl-scrape](https://affpapa.org/en/nevibecode/skills/firecrawl-scrape.md) — skill · 83500 installs
- [firecrawl-knowledge-ingest](https://affpapa.org/en/nevibecode/skills/firecrawl-knowledge-ingest.md) — skill · 31400 installs
- [tavily-crawl](https://affpapa.org/en/nevibecode/skills/tavily-crawl.md) — skill · 17400 installs
- [web-content-fetcher](https://affpapa.org/en/nevibecode/skills/web-content-fetcher.md) — skill · 3000 installs
- [brave-search](https://affpapa.org/en/nevibecode/skills/brave-search.md) — skill · 1300 installs
- [defuddle](https://affpapa.org/en/nevibecode/skills/joeseesun-defuddle.md) — skill · 1300 installs

---
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