README.md•9.88 kB
# Scrapeless MCP Server
**Welcome to the official Scrapeless Model Context Protocol (MCP) Server** — a powerful integration layer that empowers LLMs, AI Agents, and AI applications to interact with the web in real time.
Built on the open MCP standard, Scrapeless MCP Server seamlessly connects models like **ChatGPT**, **Claude**, and tools like **Cursor** and **Windsurf** to a wide range of external capabilities, including:
- **Google services integration** (Search, Trends)
- **Browser automation** for page-level navigation and interaction
- **Scrape** dynamic, JS-heavy sites—export as HTML, Markdown, or screenshots
Whether you're building an AI research assistant, a coding copilot, or autonomous web agents, this server provides the dynamic context and real-world data your workflows need—**without getting blocked**.
## Usage Examples
1. Automated Web Interaction and Data Extraction with Claude
Using Scrapeless MCP Browser, Claude can perform complex tasks such as web navigation, clicking, scrolling, and scraping through conversational commands, with real-time preview of web interaction results via `live sessions`.
2. Bypassing Cloudflare to Retrieve Target Page Content
Using the Scrapeless MCP Browser service, the Cloudflare page is automatically accessed, and after the process is completed, the page content is extracted and returned in Markdown format.
3. Extracting Dynamically Rendered Page Content and Writing to File
Using the Scrapeless MCP Universal API, the JavaScript-rendered content of the target page above is scraped, exported in Markdown format, and finally written to a local file named **`text.md`**.
4. Automated SERP Scraping
Using the Scrapeless MCP Server, query the keyword “web scraping” on Google Search, retrieve the first 10 search results (including title, link, and summary), and write the content to the file named `serp.text`.
Here are some additional examples of how to use these servers:
| Example |
| --------------------------------------------------------------------------------------------------------------------------------- |
| Search scrapeless by Google search. |
| Find the search interest for "AI" over the last year. |
| Use a browser to visit [chatgpt.com](http://chatgpt.com), search for "What's the weather like today?", and summarize the results. |
| Scrape the HTML content of [scrapeless.com](http://scrapeless.com) page. |
| Scrape the Markdown content of [scrapeless.com](http://scrapeless.com) page. |
| Get screenshots of [scrapeless.com](http://scrapeless.com). |
## Setup Guide
1. Get Scrapeless Key
- [Log in](https://app.scrapeless.com/passport/login?utm_source=github&utm_medium=github-mcp&utm_campaign=mcp) to the Scrapeless Dashboard（Free trial available）
- Then click "**Setting**" on the left -> select "**API Key Management**" -> click "**Create API Key**". Finally, click the API Key you created to **copy** it.
2. Configure Your MCP Client
Scrapeless MCP Server supports both **Stdio** and **Streamable HTTP** transport modes.
🖥️ Stdio (Local Execution)
```JSON
{
"mcpServers": {
"Scrapeless MCP Server": {
"command": "npx",
"args": ["-y", "scrapeless-mcp-server"],
"env": {
"SCRAPELESS_KEY": "YOUR_SCRAPELESS_KEY"
}
}
}
}
```
🌐 Streamable HTTP (Hosted API Mode)
```JSON
{
"mcpServers": {
"Scrapeless MCP Server": {
"type": "streamable-http",
"url": "https://api.scrapeless.com/mcp",
"headers": {
"x-api-token": "YOUR_SCRAPELESS_KEY"
},
"disabled": false,
"alwaysAllow": []
}
}
}
```
#### Advanced Options
Customize browser session behavior with optional parameters. These can be set via environment variables (for Stdio) or HTTP headers (for Streamable HTTP):
| Stdio (Env Var) | Streamable HTTP (HTTP Header) | Description |
| ----------------------- | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| BROWSER_PROFILE_ID | x-browser-profile-id | Specifies a reusable browser profile ID for session continuity. |
| BROWSER_PROFILE_PERSIST | x-browser-profile-persist | Enables persistent storage for cookies, local storage, etc. |
| BROWSER_SESSION_TTL | x-browser-session-ttl | Defines the **maximum session timeout** in seconds. The session will automatically expire after this duration of inactivity. |
## Integration with Claude Desktop
1. Open **Claude Desktop**
2. Navigate to: `Settings` → `Tools` → `MCP Servers`
3. Click **"Add MCP Server"**
4. Paste either the `Stdio` or `Streamable HTTP` config above
5. Save and enable the server
6. Claude will now be able to issue web queries, extract content, and interact with pages using Scrapeless
## Integration with Cursor IDE
1. Open **Cursor**
2. Press `Cmd + Shift + P` and search for: `Configure MCP Servers`
3. Add the Scrapeless MCP config using the format above
4. Save the file and restart Cursor (if needed)
5. Now you can ask Cursor things like:
1. `"Search StackOverflow for a solution to this error"`
2. `"Scrape the HTML from this page"`
6. And it will use Scrapeless in the background.
## Supported MCP Tools
| Name | Description |
| ------------------ | -------------------------------------------------------------- |
| google_search | Universal information search engine. |
| google_trends | Get trending search data from Google Trends. |
| browser_create | Create or reuse a cloud browser session using Scrapeless. |
| browser_close | Closes the current session by disconnecting the cloud browser. |
| browser_goto | Navigate browser to a specified URL. |
| browser_go_back | Go back one step in browser history. |
| browser_go_forward | Go forward one step in browser history. |
| browser_click | Click a specific element on the page. |
| browser_type | Type text into a specified input field. |
| browser_press_key | Simulate a key press. |
| browser_wait_for | Wait for a specific page element to appear. |
| browser_wait | Pause execution for a fixed duration. |
| browser_screenshot | Capture a screenshot of the current page. |
| browser_get_html | Get the full HTML of the current page. |
| browser_get_text | Get all visible text from the current page. |
| browser_scroll | Scroll to the bottom of the page. |
| browser_scroll_to | Scroll a specific element into view. |
| scrape_html | Scrape a URL and return its full HTML content. |
| scrape_markdown | Scrape a URL and return its content as Markdown. |
| scrape_screenshot | Capture a high-quality screenshot of any webpage. |
## Security Best Practices
When using Scrapeless MCP Server with LLMs (like ChatGPT, Claude, or Cursor), it's critical to handle all scraped or extracted web content with care. **Web data is untrusted by default**, and improper handling may expose your application to prompt injection or other security vulnerabilities.
#### ✅ Recommended Practices
- **Never pass raw scraped content directly into LLM prompts.** Raw HTML, JavaScript, or user-generated text may contain hidden injection payloads.
- **Sanitize and validate all extracted content.** Strip or escape potentially harmful tags and scripts before using content in downstream logic or AI models.
- **Prefer structured extraction over free-form text.** Use tools like `scrape_html`, `scrape_markdown`, or targeted `browser_get_text` with known-safe selectors to extract only the content you trust.
- **Apply domain or selector whitelisting** when scraping dynamically generated pages, to restrict data flow to known and trusted sources.
- **Log and monitor all outbound requests** made via browser or scraping tools, especially if you're handling sensitive data, tokens, or internal network access.
#### 🚫 Avoid
- Injecting scraped HTML directly into prompts
- Letting users specify arbitrary URLs or CSS selectors without validation
- Storing unfiltered scraped content for future prompt usage
## Community
- [MCP Server Discord](https://backend.scrapeless.com/app/api/v1/public/links/discord)
## Contact Us
For questions, suggestions, or collaboration inquiries, feel free to contact us via:
- Email: [market@scrapeless.com](mailto:market@scrapeless.com)
- Official Website: [https://www.scrapeless.com](https://www.scrapeless.com/)
- Community Forum: https://discord.gg/Np4CAHxB9a