Scraper.is

Scraper.is MCP

[![npm version](https://img.shields.io/npm/v/scraperis-mcp.svg)](https://www.npmjs.com/package/scraperis-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A [Model Context Protocol (MCP)](https://github.com/model-context-protocol/spec) integration for [Scraper.is](https://scraper.is) - A powerful web scraping tool for AI assistants.

This package allows AI assistants to scrape web content through the MCP protocol, enabling them to access up-to-date information from the web.

Features

**Web Scraping**: Extract content from any website

**Screenshots**: Capture visual representations of web pages

**Multiple Formats**: Get content in markdown, HTML, or JSON

**Progress Updates**: Real-time progress reporting during scraping operations

**MCP Integration**: Seamless integration with MCP-compatible AI assistants

Installation

Or with yarn:

Prerequisites

You need a Scraper.is API key to use this package.

Getting Your API Key

Navigate to the API Keys section in your dashboard: [https://www.scraper.is/dashboard/apikeys](https://www.scraper.is/dashboard/apikeys)

Create a new API key or copy your existing key

Store this key securely as you'll need it to use this package

Usage

Environment Setup

Create a `.env` file with your Scraper.is API key:

Claude Desktop Integration

To use this package with Claude Desktop:

Install the package globally: ```bash npm install -g scraperis-mcp ```

Add the following configuration to your `claude_desktop_config.json` file: ```json { "mcpServers": { "scraperis_scraper": { "command": "scraperis-mcp", "args": [], "env": { "SCRAPERIS_API_KEY": "your-api-key-here", "DEBUG": "*" } } } } ```

Replace `your-api-key-here` with your actual Scraper.is API key.

Restart Claude Desktop to apply the changes.

Running with MCP Inspector

For development and testing, you can use the MCP Inspector:

Integration with AI Assistants

This package is designed to be used with AI assistants that support the Model Context Protocol (MCP). When properly configured, the AI assistant can use the following tools:

Scrape Tool

The `scrape` tool allows the AI to extract content from websites. It supports various formats:

`markdown`: Returns the content in markdown format

`html`: Returns the content in HTML format

`screenshot`: Returns a screenshot of the webpage

`json`: Returns structured data in JSON format

Example prompt for the AI:

API Reference

Tools

scrape

Scrapes content from a webpage based on a prompt.

**Parameters:**

`prompt` (string): The prompt describing what to scrape, including the URL

`format` (string): The format to return the content in (`markdown`, `html`, `screenshot`, `json`, `quick`)

**Example:**

Development

Setup

Clone the repository: ```bash git clone https://github.com/Ai-Quill/scraperis-mcp.git cd scraperis-mcp ```

Install dependencies: ```bash npm install ```

Build the project: ```bash npm run build ```

Scripts

`npm run build`: Build the project

`npm run watch`: Watch for changes and rebuild

`npm run dev`: Run with MCP Inspector for development

`npm run test`: Run tests

`npm run lint`: Run ESLint

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

[Model Context Protocol](https://github.com/model-context-protocol/spec)

[Scraper.is](https://scraper.is)