FireScrape MCP Server

# 🔥 FireScrape MCP Server <div align="center">    **The Ultimate Gateway for AI Agents.** *Empower your LLMs to Browse, Search, Research, and Scrape with precision.* [Installation](#-installation--usage) • [Connection Guides](#-connection-guides) • [AI Rules](#-ai-agent-rules) • [Tools](#%EF%B8%8F-tools-reference) </div> --- ## 🚀 Overview **FireScrape MCP** is a Model Context Protocol server designed to bridge the gap between AI models (Claude, Cursor, etc.) and the real world. It provides robust tools for: * **Deep Research:** Multi-step autonomous investigation and synthesis. * **Web Access:** Anti-blocking search and intelligent markdown scraping. * **Local Context:** File system access for project-aware coding. ## 📦 Installation & Usage Run instantly without global installation using `npx`: ```bash npx -y @yutugyutugyutug/firescrape-mcp ``` ### ✨ Key Features (v1.1.2) * 🧠 **`deep_research`**: Conducts autonomous, multi-step research on complex topics, filtering noise and synthesizing reports. * 🌐 **`search_web`**: High-availability web search with fallback providers (DuckDuckGo + Brave) to ensure you always get results. * 📄 **`scrape_webpage`**: Converts messy HTML into clean, token-efficient Markdown, stripping ads and irrelevant boilerplate. * 🔍 **`discover_tools`**: a "Meta-Tool" to find and install other MCP servers from GitHub and Smithery. * 📂 **Local Integration**: Seamlessly `list_files` and `read_file` to give your AI context about your local project. --- ## 🤖 AI Agent Rules **Want your AI to be smarter?** We have created a standardized rule set to teach your AI agents (Cursor, Windsurf, Cline) how to effectively use these tools to verify facts and avoid hallucinations. 👉 **[Read the AI Usage Guidelines](./rules/AI_USAGE_RULES.md)** *Copy the content of the file above into your `.cursorrules` or System Prompt to supercharge your agent.* --- ## 🔌 Connection Guides ### 1. Claude Desktop App 1. Open your configuration file: * **Windows:** `Win + R` -> `%APPDATA%\Claude\claude_desktop_config.json` * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` 2. Add this configuration: ```json { "mcpServers": { "firescrape": { "command": "npx", "args": ["-y", "@yutugyutugyutug/firescrape-mcp"] } } } ``` ### 2. Cursor (AI Code Editor) 1. Navigate to **Settings** -> **Features** -> **MCP**. 2. Click **+ Add New MCP Server**. 3. Fill in the fields: * **Name:** `FireScrape` * **Type:** `stdio` * **Command:** `npx` * **Args:** `-y @yutugyutugyutug/firescrape-mcp` 4. Click **Add** to save. ### 3. Gemini CLI 1. Locate your config file: * **Linux/Mac:** `~/.gemini/settings.json` * **Windows:** `%USERPROFILE%\.gemini\settings.json` 2. Insert the server configuration: ```json { "mcpServers": { "firescrape": { "command": "npx", "args": ["-y", "@yutugyutugyutug/firescrape-mcp"] } } } ``` ### 4. Claude Code (CLI) Run this command in your terminal to add FireScrape: ```bash claude mcp add firescrape -- npx -y @yutugyutugyutug/firescrape-mcp ``` ### 5. Google Antigravity 1. Open the **Manage MCP Servers** panel. 2. Select **"Edit Configuration"** or open `mcp_config.json`. 3. Add the entry: ```json "firescrape": { "command": "npx", "args": ["-y", "@yutugyutugyutug/firescrape-mcp"] } ``` ### 6. Cline (VS Code Extension) 1. Open **Cline Settings** (in VS Code settings or via the extension menu). 2. Locate the **MCP Servers** config file (usually via a button "Edit MCP Settings"). 3. Add the following: ```json { "mcpServers": { "firescrape": { "command": "npx", "args": ["-y", "@yutugyutugyutug/firescrape-mcp"] } } } ``` --- ## 🛠️ Tools Reference | Tool Name | Description | Parameters | | :--- | :--- | :--- | | `scrape_webpage` | Reads a specific URL and returns structured Markdown. | `url` (string) | | `search_web` | Finds current info on the web. | `query` (string) | | `discover_tools` | Finds other MCP servers on GitHub. | `query` (string) | | `search_in_page` | Searches text inside a specific page URL. | `url` (string), `query` (string) | | `list_files` | Lists files in a folder. | `path` (string, optional) | | `read_file` | Reads a file's content. | `path` (string) | | `get_agent_rules` | Returns the strict operational protocol for AI agents. | `(none)` | --- <div align="center"> Built with ❤️ by <a href="https://github.com/aasm3535/firescrape">FireScrape</a> </div>