Skip to main content

​
Claude Desktop

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

Add the Connector

Go to Settings > Connectors > Add custom connector and enter:
2

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.

​
Alternative: Config File (API Key)

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

​
Prerequisites

  • Claude Desktop installed
  • Node.js 18+ (for npx mcp-remote)
  • ScrapeBadger API key
1

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
2

Add ScrapeBadger

Add this to the config file:
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.)
3

Restart Claude Desktop

Fully quit and restart Claude Desktop. The ScrapeBadger tools will appear in the tools menu.
Claude Desktop uses stdio transport only. The npx mcp-remote package bridges between Claude Desktop’s stdio and our hosted HTTP server.

​
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.