Metadata-Version: 2.4
Name: proxyclaw-mcp-server
Version: 1.0.0
Summary: ProxyClaw MCP Server — Route web requests through 175M+ residential IPs with TLS spoofing, headless rendering, and structured data extraction
Project-URL: Homepage, https://proxyclaw.ai
Project-URL: Repository, https://github.com/Iploop/proxyclaw-mcp.git
Project-URL: Issues, https://github.com/Iploop/proxyclaw-mcp/issues
Author-email: IPLoop <team@iploop.io>
License: MIT
Keywords: anti-bot,iploop,mcp,proxy,proxyclaw,render,residential,scraper
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: iploop-sdk>=1.8.0
Requires-Dist: mcp>=1.27.0
Provides-Extra: all
Requires-Dist: curl-cffi>=0.6.0; extra == 'all'
Requires-Dist: playwright>=1.40.0; extra == 'all'
Requires-Dist: tls-client>=1.0.0; extra == 'all'
Provides-Extra: render
Requires-Dist: playwright>=1.40.0; extra == 'render'
Provides-Extra: stealth
Requires-Dist: curl-cffi>=0.6.0; extra == 'stealth'
Requires-Dist: tls-client>=1.0.0; extra == 'stealth'
Description-Content-Type: text/markdown

# ProxyClaw MCP Server (Python)

Model Context Protocol server for [ProxyClaw](https://proxyclaw.ai) — the most powerful web access tool for AI agents. Route requests through 175M+ residential IPs with TLS fingerprint spoofing, headless browser rendering, and structured data extraction.

## Install

```bash
# Core (proxy + stealth headers + auto-retry)
pip install proxyclaw-mcp-server[stealth]

# With rendering (Playwright anti-detection)
pip install proxyclaw-mcp-server[all]

# Or via uv (Claude Desktop recommended)
uv tool install proxyclaw-mcp-server[all]
```

## Claude Desktop Config

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "proxyclaw": {
      "command": "uvx",
      "args": ["proxyclaw-mcp-server[all]"],
      "env": {
        "IPLOOP_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Tools

| Tool | What it does |
|------|-------------|
| `proxy_fetch_stealth` | Fetch URL with Chrome fingerprint + TLS JA3 spoofing + auto-retry |
| `proxy_render` | Full headless Chromium render — bypasses Cloudflare, JS apps, SPAs |
| `proxy_scrape` | Smart cascade: direct → stealth → render → search fallback |
| `proxy_extract` | Structured data from 60+ sites (eBay, Amazon, LinkedIn, Google, Nasdaq, etc.) |
| `proxy_check_ip` | Verify exit IP and geo-location |
| `proxy_list_countries` | List 195+ available countries |

## Quick Start

Get your API key at [iploop.io/signup](https://iploop.io/signup.html).

Then ask Claude:

> "Fetch https://example.com through a German IP with stealth headers"

> "Render https://spa-site.com and extract the product title"

> "Scrape eBay search results for 'laptop' and return structured data"

## Features

- **Residential proxy network** — 175M+ real IPs across 195+ countries
- **TLS fingerprint spoofing** — curl_cffi / tls_client for JA3 bypass (Cloudflare can't detect you)
- **Headless rendering** — Playwright with anti-detection (removes webdriver, mocks plugins, fake Chrome runtime)
- **Structured extraction** — 60+ site-specific parsers (eBay, Amazon, LinkedIn, Twitter, Nasdaq, etc.)
- **Smart cascade** — tries direct fetch first, escalates to stealth → render → search fallback
- **Sticky sessions** — keep same IP across requests
- **Cookie persistence** — cookies saved between requests
- **Auto-retry with rotation** — 403/502/503 automatically retries with fresh IP

## Links

- **Website**: [proxyclaw.ai](https://proxyclaw.ai)
- **Dashboard**: [iploop.io/dashboard](https://iploop.io/dashboard)
- **Python SDK**: [iploop on PyPI](https://pypi.org/project/iploop-sdk/)
- **Node.js SDK**: [iploop on npm](https://www.npmjs.com/package/iploop)

## License

MIT
