ScrapeGraph MCP Server
Official
# ScrapeGraph MCP Server
<a href="https://glama.ai/mcp/servers/37us0q2tr6">
<img width="380" height="200" src="https://glama.ai/mcp/servers/37us0q2tr6/badge" alt="ScrapeGraph Server MCP server" />
</a>
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/release/python-3100/)
[](https://smithery.ai/server/@ScrapeGraphAI/scrapegraph-mcp)
A production-ready [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides seamless integration with the [ScapeGraph AI](https://scrapegraphai.com) API. This server enables language models to leverage advanced AI-powered web scraping capabilities with enterprise-grade reliability.
## Available Tools
The server provides the following enterprise-ready tools:
- `markdownify(website_url: str)`: Transform any webpage into clean, structured markdown format
- `smartscraper(user_prompt: str, website_url: str)`: Leverage AI to extract structured data from any webpage
- `searchscraper(user_prompt: str)`: Execute AI-powered web searches with structured, actionable results
## Setup Instructions
To utilize this server, you'll need a ScapeGraph API key. Follow these steps to obtain one:
1. Navigate to the [ScapeGraph Dashboard](https://dashboard.scrapegraphai.com)
2. Create an account and generate your API key
### Automated Installation via Smithery
For automated installation of the ScrapeGraph API Integration Server using [Smithery](https://smithery.ai/server/@ScrapeGraphAI/scrapegraph-mcp):
```bash
npx -y @smithery/cli install @ScrapeGraphAI/scrapegraph-mcp --client claude
```
### Claude Desktop Configuration
Update your Claude Desktop configuration file with the following settings (located on the top rigth of the Cursor page):
(remember to add your API key inside the config)
```json
{
"mcpServers": {
"@ScrapeGraphAI-scrapegraph-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@ScrapeGraphAI/scrapegraph-mcp",
"--config",
"\"{\\\"scrapegraphApiKey\\\":\\\"YOUR-SGAI-API-KEY\\\"}\""
]
}
}
}
```
The configuration file is located at:
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
### Cursor Integration
Add the ScrapeGraphAI MCP server on the settings:
## Example Use Cases
The server enables sophisticated queries such as:
- "Analyze and extract the main features of the ScapeGraph API"
- "Generate a structured markdown version of the ScapeGraph homepage"
- "Extract and analyze pricing information from the ScapeGraph website"
- "Research and summarize recent developments in AI-powered web scraping"
- "Create a comprehensive summary of the Python documentation website"
## Error Handling
The server implements robust error handling with detailed, actionable error messages for:
- API authentication issues
- Malformed URL structures
- Network connectivity failures
- Rate limiting and quota management
## Common Issues
### Windows-Specific Connection
When running on Windows systems, you may need to use the following command to connect to the MCP server:
```bash
C:\Windows\System32\cmd.exe /c npx -y @smithery/cli@latest run @ScrapeGraphAI/scrapegraph-mcp --config "{\"scrapegraphApiKey\":\"YOUR-SGAI-API-KEY\"}"
```
This ensures proper execution in the Windows environment.
## License
This project is distributed under the MIT License. For detailed terms and conditions, please refer to the LICENSE file.
## Acknowledgments
Special thanks to [tomekkorbak](https://github.com/tomekkorbak) for his implementation of [oura-mcp-server](https://github.com/tomekkorbak/oura-mcp-server), which served as starting point for this repo.
Made with ❤️ by [ScrapeGraphAI](https://scrapegraphai.com) Team