> ## 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

## One-Click Setup (Recommended)

Claude Desktop and claude.ai support custom connectors with OAuth — no API key or config file needed:

<Steps>
  <Step title="Add the Connector">
    Go to **Settings** > **Connectors** > **Add custom connector** and enter:

    ```
    https://mcp.scrapebadger.com/mcp
    ```
  </Step>

  <Step title="Sign In and Approve">
    Click **Connect**. Your browser opens the ScrapeBadger consent screen — sign in and approve. Access is tied to your account and can be revoked anytime by deactivating your API key in the dashboard.
  </Step>
</Steps>

## Alternative: Config File (API Key)

If you prefer API-key auth via a config file:

### Prerequisites

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

<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",
            "--header",
            "Authorization: Bearer YOUR_API_KEY"
          ]
        }
      }
    }
    ```

    Replace `YOUR_API_KEY` with your ScrapeBadger API key. (The older
    `?api_key=` query parameter still works but is deprecated — URLs leak
    into logs and shell history; prefer the header.)
  </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 344 ScrapeBadger tools listed (Twitter/X, Google, YouTube, TikTok, Amazon, eBay, Reddit, real estate, 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.