> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Connect ScrapeBadger to Claude Desktop via MCP.

# Claude Desktop

## Prerequisites

* [Claude Desktop](https://claude.ai/download) installed
* Node.js 18+ (for `npx mcp-remote`)
* ScrapeBadger API key

## Setup

<Steps>
  <Step title="Open Config File">
    Open Claude Desktop settings, go to **Developer** > **Edit Config**, or edit the file directly:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  </Step>

  <Step title="Add ScrapeBadger">
    Add this to the config file:

    ```json theme={null}
    {
      "mcpServers": {
        "scrapebadger": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://mcp.scrapebadger.com/mcp?api_key=YOUR_API_KEY"]
        }
      }
    }
    ```

    Replace `YOUR_API_KEY` with your ScrapeBadger API key.
  </Step>

  <Step title="Restart Claude Desktop">
    Fully quit and restart Claude Desktop. The ScrapeBadger tools will appear in the tools menu.
  </Step>
</Steps>

<Note>
  Claude Desktop uses stdio transport only. The `npx mcp-remote` package bridges between Claude Desktop's stdio and our hosted HTTP server.
</Note>

## Verify

After restarting, click the tools icon (hammer) in Claude Desktop. You should see 92 ScrapeBadger tools listed (Twitter, Google, Vinted, and Web Scraping).

## Examples

Try asking Claude:

> "Search Twitter for recent posts about AI agents"

Claude will call the `twitter_advanced_search` tool automatically.

> "Find the top 3 laptops on Google Shopping under \$1500 and resolve the merchant URL for each"

Claude will chain `google_shopping_search` with `google_shopping_product_click` for each result.