{
  "markdown": "# Scrapfly MCP Server\n\n<p align=\"center\">\n  <a href=\"https://scrapfly.io\">\n    <img src=\"https://avatars.githubusercontent.com/u/54183743?s=400&u=5279c1aaea18805aa5cc4fec1053ac2a2cfaac5d&v=4\" alt=\"Scrapfly\" width=\"200\"/>\n  </a>\n</p>\n\n<p align=\"center\">\n  <strong>Give your AI real-time access to any website</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://scrapfly.io/mcp-cloud\">🌐 Landing Page</a> •\n  <a href=\"https://scrapfly.io/docs/mcp/getting-started\">📖 Documentation</a> •\n  <a href=\"https://scrapfly.io/mcp-cloud/n8n\">🎮 Live Demo</a> •\n  <a href=\"https://scrapfly.io/register\">🔑 Get API Key</a>\n</p>\n\n---\n\n## What is Scrapfly MCP?\n\nThe **Scrapfly MCP Server** connects your AI assistants to live web data through the [Model Context Protocol](https://modelcontextprotocol.io). Transform your AI from being limited by training data to having real-time access to **any website**.\n\n### ✨ What Your AI Can Do\n\n| Capability | Description |\n|------------|-------------|\n| 🌐 **Scrape Live Data** | Pull current prices, listings, news, or any webpage content in real-time |\n| 🛡️ **Bypass Anti-Bot Systems** | Automatically handle CAPTCHAs, proxies, JavaScript rendering, and rate limits |\n| ⚡ **Extract Structured Data** | Parse complex websites into clean JSON using [AI-powered extraction](https://scrapfly.io/docs/scrape-api/extraction) |\n| 📸 **Capture Screenshots** | Take visual snapshots of pages or specific elements for analysis |\n\n### 🏆 Why Scrapfly?\n\nBuilt on **battle-tested infrastructure** used by thousands of developers:\n\n- **99.9% Uptime** — Enterprise-grade reliability\n- **100+ Countries** — [Global proxy network](https://scrapfly.io/docs/scrape-api/proxy) with datacenter & residential IPs\n- **Anti-Bot Bypass** — [Advanced ASP technology](https://scrapfly.io/docs/scrape-api/anti-scraping-protection) defeats modern protections\n- **OAuth2 Security** — [Enterprise authentication](https://scrapfly.io/docs/mcp/authentication) for production deployments\n\n> 📖 **Learn more**: [Why Scrapfly MCP?](https://scrapfly.io/docs/mcp/getting-started#why-scrapfly-mcp)\n\n---\n\n## 🚀 Quick Install\n\nClick one of the buttons below to install the MCP server in your preferred IDE:\n\n[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=scrapfly-cloud-mcp&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/Install_in-VS_Code_Insiders-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=scrapfly-cloud-mcp&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D&quality=insiders)\n[![Install in Visual Studio](https://img.shields.io/badge/Install_in-Visual_Studio-C16FDE?style=for-the-badge&logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D)\n[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=for-the-badge&logoColor=white)](https://cursor.com/en/install-mcp?name=scrapfly-cloud-mcp&config=eyJuYW1lIjoic2NyYXBmbHktY2xvdWQtbWNwIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL21jcC5zY3JhcGZseS5pby9tY3AifQ==)\n\n---\n\n## 📦 Manual Installation\n\n### Standard Configuration\n\nWorks with most MCP-compatible tools:\n\n```json\n{\n  \"servers\": {\n    \"scrapfly-cloud-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.scrapfly.io/mcp\"\n    }\n  }\n}\n```\n\n### Cloud Configuration (NPX)\n\nFor tools that require a local process:\n\n```json\n{\n  \"mcpServers\": {\n    \"scrapfly\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://mcp.scrapfly.io/mcp\"\n      ]\n    }\n  }\n}\n```\n\n---\n\n## 🔧 IDE-Specific Setup\n\n<details>\n<summary><strong>VS Code</strong></summary>\n\n### One-Click Install\n\n[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=scrapfly-cloud-mcp&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D)\n\n### Manual Install\n\nFollow the [VS Code MCP guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) or use the CLI:\n\n```bash\ncode --add-mcp '{\"name\":\"scrapfly-cloud-mcp\",\"type\":\"http\",\"url\":\"https://mcp.scrapfly.io/mcp\"}'\n```\n\nAfter installation, Scrapfly tools will be available in GitHub Copilot Chat.\n\n> 📖 **Full guide**: [VS Code Integration](https://scrapfly.io/docs/mcp/integrations/vscode)\n</details>\n\n<details>\n<summary><strong>VS Code Insiders</strong></summary>\n\n### One-Click Install\n\n[![Install in VS Code Insiders](https://img.shields.io/badge/Install_in-VS_Code_Insiders-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=scrapfly-cloud-mcp&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D&quality=insiders)\n\n### Manual Install\n\n```bash\ncode-insiders --add-mcp '{\"name\":\"scrapfly-cloud-mcp\",\"type\":\"http\",\"url\":\"https://mcp.scrapfly.io/mcp\"}'\n```\n\n> 📖 **Full guide**: [VS Code Integration](https://scrapfly.io/docs/mcp/integrations/vscode)\n</details>\n\n<details>\n<summary><strong>Visual Studio</strong></summary>\n\n### One-Click Install\n\n[![Install in Visual Studio](https://img.shields.io/badge/Install_in-Visual_Studio-C16FDE?style=flat-square&logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.scrapfly.io%2Fmcp%22%7D)\n\n### Manual Install\n\n1. Open Visual Studio\n2. Navigate to **GitHub Copilot Chat** window\n3. Click the tools icon (🛠️) in the chat toolbar\n4. Click **+ Add Server** to open the configuration dialog\n5. Configure:\n   - **Server ID**: `scrapfly-cloud-mcp`\n   - **Type**: `http/sse`\n   - **URL**: `https://mcp.scrapfly.io/mcp`\n6. Click **Save**\n\n> 📖 **Full guide**: [Visual Studio MCP documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers)\n</details>\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\n### One-Click Install\n\n[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logoColor=white)](https://cursor.com/en/install-mcp?name=scrapfly-cloud-mcp&config=eyJuYW1lIjoic2NyYXBmbHktY2xvdWQtbWNwIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL21jcC5zY3JhcGZseS5pby9tY3AifQ==)\n\n### Manual Install\n\n1. Go to `Cursor Settings` → `MCP` → `Add new MCP Server`\n2. Use the standard configuration above\n3. Click **Edit** to verify or add arguments\n\n> 📖 **Full guide**: [Cursor Integration](https://scrapfly.io/docs/mcp/integrations/cursor)\n</details>\n\n<details>\n<summary><strong>Claude Code</strong></summary>\n\nUse the Claude Code CLI:\n\n```bash\nclaude mcp add scrapfly-cloud-mcp --url https://mcp.scrapfly.io/mcp\n```\n\n> 📖 **Full guide**: [Claude Code Integration](https://scrapfly.io/docs/mcp/integrations/claude-code)\n</details>\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"scrapfly\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https://mcp.scrapfly.io/mcp\"]\n    }\n  }\n}\n```\n\n> 📖 **Full guide**: [Claude Desktop Integration](https://scrapfly.io/docs/mcp/integrations/claude-desktop)\n</details>\n\n<details>\n<summary><strong>Cline</strong></summary>\n\nAdd to your Cline MCP settings:\n\n```json\n{\n  \"scrapfly-cloud-mcp\": {\n    \"type\": \"http\",\n    \"url\": \"https://mcp.scrapfly.io/mcp\"\n  }\n}\n```\n\n> 📖 **Full guide**: [Cline Integration](https://scrapfly.io/docs/mcp/integrations/cline)\n</details>\n\n<details>\n<summary><strong>Windsurf</strong></summary>\n\nFollow the [Windsurf MCP documentation](https://docs.windsurf.com/windsurf/cascade/mcp) using the standard configuration.\n\n> 📖 **Full guide**: [Windsurf Integration](https://scrapfly.io/docs/mcp/integrations/windsurf)\n</details>\n\n<details>\n<summary><strong>Zed</strong></summary>\n\nAdd to your Zed settings:\n\n```json\n{\n  \"context_servers\": {\n    \"scrapfly-cloud-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.scrapfly.io/mcp\"\n    }\n  }\n}\n```\n\n> 📖 **Full guide**: [Zed Integration](https://scrapfly.io/docs/mcp/integrations/zed)\n</details>\n\n<details>\n<summary><strong>OpenAI Codex</strong></summary>\n\nCreate or edit `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.scrapfly-cloud-mcp]\nurl = \"https://mcp.scrapfly.io/mcp\"\n```\n\n> 📖 **More info**: [Codex MCP documentation](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers)\n</details>\n\n<details>\n<summary><strong>Gemini CLI</strong></summary>\n\nFollow the [Gemini CLI MCP guide](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) using the standard configuration.\n</details>\n\n<details>\n<summary><strong>OpenCode</strong></summary>\n\nAdd to `~/.config/opencode/opencode.json`:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"scrapfly-cloud-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.scrapfly.io/mcp\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\n> 📖 **More info**: [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/)\n</details>\n\n---\n\n## 🛠️ Available Tools\n\nThe Scrapfly MCP Server provides **5 powerful tools** covering 99% of web scraping use cases:\n\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `scraping_instruction_enhanced` | Cheat-sheet of the scraping options | Optional — when the right options are unclear |\n| `web_get_page` | Quick page fetch with smart defaults | Simple scraping tasks |\n| `web_scrape` | Full control with browser automation | Complex scraping, login flows |\n| `screenshot` | Capture page screenshots | Visual analysis, monitoring |\n| `info_account` | Check usage & quota | Account management |\n\n> 📖 **Full reference**: [Tools & API Specification](https://scrapfly.io/docs/mcp/tools)\n\n### Example: Scrape a Page\n\n```\nUser: \"What are the top posts on Hacker News right now?\"\n\nAI: Uses web_get_page to fetch https://news.ycombinator.com and returns current top stories\n```\n\n### Example: Extract Structured Data\n\n```\nUser: \"Get all product prices from this Amazon page\"\n\nAI: Uses web_scrape with extraction_model=\"product_listing\" to return structured JSON\n```\n\n> 📖 **More examples**: [Real-World Examples](https://scrapfly.io/docs/mcp/examples)\n\n---\n\n## 🔐 Authentication\n\nScrapfly MCP supports multiple authentication methods:\n\n| Method | Best For | Documentation |\n|--------|----------|---------------|\n| **OAuth2** | Production, multi-user apps | [OAuth2 Setup](https://scrapfly.io/docs/mcp/authentication#oauth2) |\n| **API Key** | Personal use, development | [API Key Setup](https://scrapfly.io/docs/mcp/authentication#api-key) |\n| **Header Auth** | Custom integrations | [Header Auth](https://scrapfly.io/docs/mcp/authentication#header) |\n\n> 🔑 **Get your API key**: [Scrapfly Dashboard](https://scrapfly.io/dashboard)\n\n---\n\n## 📊 Configuration Reference\n\n| Setting | Value |\n|---------|-------|\n| **Server Name** | `scrapfly-cloud-mcp` |\n| **Type** | Remote HTTP Server |\n| **URL** | `https://mcp.scrapfly.io/mcp` |\n| **Protocol** | MCP over HTTP/SSE |\n\n---\n\n## 🖥️ Self-Hosted / Local Deployment\n\nYou can run the Scrapfly MCP server locally or self-host it.\n\n### CLI Arguments\n\n| Flag | Description |\n|------|-------------|\n| `-http <address>` | Start HTTP server at the specified address (e.g., `:8080`). Takes precedence over `PORT` env var. |\n| `-apikey <key>` | Use this API key instead of the `SCRAPFLY_API_KEY` environment variable. |\n\n### Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `PORT` | HTTP port to listen on. Used if `-http` flag is not set. |\n| `SCRAPFLY_API_KEY` | Default Scrapfly API key. Can also be passed via query parameter `?apiKey=xxx` at runtime. |\n\n### Examples\n\n```bash\n# Start HTTP server on port 8080\n./scrapfly-mcp -http :8080\n\n# Start HTTP server using PORT env var\nPORT=8080 ./scrapfly-mcp\n\n# Start with API key\n./scrapfly-mcp -http :8080 -apikey scp-live-xxxx\n\n# Start in stdio mode (for local MCP clients)\n./scrapfly-mcp\n```\n\n### Docker\n\n```bash\n# Build\ndocker build -t scrapfly-mcp .\n\n# Run (Smithery compatible - uses PORT env var)\ndocker run -p 8080:8080 scrapfly-mcp\n\n# Run with custom port\ndocker run -e PORT=9000 -p 9000:9000 scrapfly-mcp\n```\n\n---\n\n## 🤝 Framework Integrations\n\nScrapfly MCP also works with AI frameworks and automation tools:\n\n| Framework | Documentation |\n|-----------|---------------|\n| **LangChain** | [LangChain Integration](https://scrapfly.io/docs/mcp/integrations/langchain) |\n| **LlamaIndex** | [LlamaIndex Integration](https://scrapfly.io/docs/mcp/integrations/llamaindex) |\n| **CrewAI** | [CrewAI Integration](https://scrapfly.io/docs/mcp/integrations/crewai) |\n| **OpenAI** | [OpenAI Integration](https://scrapfly.io/docs/mcp/integrations/openai) |\n| **n8n** | [n8n Integration](https://scrapfly.io/docs/mcp/integrations/n8n) |\n| **Make** | [Make Integration](https://scrapfly.io/docs/mcp/integrations/make) |\n| **Zapier** | [Zapier Integration](https://scrapfly.io/docs/mcp/integrations/zapier) |\n\n> 📖 **All integrations**: [Integration Index](https://scrapfly.io/docs/mcp/integrations)\n\n---\n\n## 📚 Resources\n\n- 🌐 [MCP Cloud Landing Page](https://scrapfly.io/mcp-cloud) — Product overview & features\n- 🎮 [Live n8n Demo](https://scrapfly.io/mcp-cloud/n8n) — Try it in your browser\n- 📖 [Full Documentation](https://scrapfly.io/docs/mcp/getting-started)\n- 🛠️ [Tools Reference](https://scrapfly.io/docs/mcp/tools)\n- 💡 [Examples & Use Cases](https://scrapfly.io/docs/mcp/examples)\n- ❓ [FAQ](https://scrapfly.io/docs/mcp/faq)\n- 🔐 [Authentication Guide](https://scrapfly.io/docs/mcp/authentication)\n\n---\n\n## 💬 Need Help?\n\n- 📖 [Scrapfly Documentation](https://scrapfly.io/docs)\n- 📧 [Contact Support](https://scrapfly.io/docs/support)\n- 🌐 [Model Context Protocol](https://modelcontextprotocol.io)\n\n---\n\n<p align=\"center\">\n  <a href=\"https://scrapfly.io\">\n    <img src=\"https://avatars.githubusercontent.com/u/54183743?s=400&u=5279c1aaea18805aa5cc4fec1053ac2a2cfaac5d&v=4\" alt=\"Scrapfly\" width=\"50\"/>\n  </a>\n  <br/>\n  <strong>Made with ❤️ by <a href=\"https://scrapfly.io\">Scrapfly</a></strong>\n  <br/>\n  <sub>The Web Scraping API for Developers</sub>\n</p>\n",
  "bytes": 14553,
  "sha": "6e7b57c3529f8afdb1d891454902ea1407a8f172de047bed948eb4b47697217d",
  "repo_slug": "scrapfly/scrapfly-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_scrapfly_mcp_mcp_0581d544/readme"
}