{"id":"web-unblocker","name":"web-unblocker","summary":"Oxylabs Web UnblockerというAI搭載のプロキシを使い、指紋認証、JavaScriptレンダリング、再試行を自動的に処理します。","body":"# Oxylabs Web Unblocker\n\nAI-powered proxy solution that automatically manages fingerprinting, headers, retries, and JavaScript rendering.\n\n## Endpoint\n\n```\nhttps://unblock.oxylabs.io:60000\n```\n\n## Authentication\n\nHTTP Basic Auth via proxy credentials:\n\n```bash\ncurl -k -x \"https://unblock.oxylabs.io:60000\" \\\n  -U \"$OXYLABS_USERNAME:$OXYLABS_PASSWORD\" \\\n  \"https://example.com\"\n```\n\n## Quick Start\n\n**Basic request:**\n```bash\ncurl -k -x \"https://unblock.oxylabs.io:60000\" \\\n  -U \"$OXYLABS_USERNAME:$OXYLABS_PASSWORD\" \\\n  \"https://ip.oxylabs.io/headers\"\n```\n\n**With JavaScript rendering:**\n```bash\ncurl -k -x \"https://unblock.oxylabs.io:60000\" \\\n  -U \"$OXYLABS_USERNAME:$OXYLABS_PASSWORD\" \\\n  -H \"x-oxylabs-render: html\" \\\n  \"https://example.com/spa-page\"\n```\n\n## Headers\n\n| Header | Description |\n|--------|-------------|\n| `x-oxylabs-render` | `html` for rendered HTML, `png` for raw PNG bytes; empty value disables automatic forced rendering |\n| `X-Oxylabs-Session-Id` | Reuse same IP across requests (any random string) |\n| `X-Oxylabs-Geo-Location` | Target country, city/state, ZIP/postcode, or coordinates |\n| `x-oxylabs-force-headers: 1` | Enable custom header passthrough |\n| `x-oxylabs-force-cookies: 1` | Enable custom cookie passthrough |\n| `X-Oxylabs-Successful-Status-Codes` | Define custom success codes to prevent retries |\n| `x-oxylabs-browser-instructions` | JSON-escaped browser actions; requires `x-oxylabs-render: html` |\n\n## Session Persistence\n\nReuse the same IP across multiple requests:\n\n```bash\ncurl -k -x \"https://unblock.oxylabs.io:60000\" \\\n  -U \"$OXYLABS_USERNAME:$OXYLABS_PASSWORD\" \\\n  -H \"X-Oxylabs-Session-Id: my-session-123\" \\\n  \"https://example.com/page1\"\n```\n\n## Geo-Location Targeting\n\n```bash\ncurl -k -x \"https://unblock.oxylabs.io:60000\" \\\n  -U \"$OXYLABS_USERNAME:$OXYLABS_PASSWORD\" \\\n  -H \"X-Oxylabs-Geo-Location: Germany\" \\\n  \"https://example.com\"\n```\n\nUse values such as `Germany`, `90210`, `California,United States`, `New York,New York,United States`, or `lat: 40.7128, lng: -74.0060, rad: 50`.\n\nUse normal HTTP methods and request bodies through the proxy; Web Unblocker supports both GET and POST.\n\n## When to Use Web Unblocker vs Regular Proxies\n\n| Scenario | Use |\n|----------|-----|\n| Sites with anti-bot protection | Web Unblocker |\n| CAPTCHAs, fingerprint detection | Web Unblocker |\n| JavaScript-heavy SPAs | Web Unblocker with `x-oxylabs-render: html` |\n| Simple requests, no protection | Regular Proxies |\n| High volume, price sensitive | Regular Proxies |\n\n## Key Guidelines\n\n- Always use `-k` flag (or disable SSL verification) - the proxy uses its own certificates\n- Add `x-oxylabs-render: html` if experiencing empty content or low success rates; set client timeouts near 180 seconds for rendered requests\n- Check `X-Oxylabs-Final-Url` in response headers when redirects matter\n- Avoid adding custom unblocking headers that may interfere with the AI\n- Browser instruction header values must be JSON-escaped and compact; pair them with `x-oxylabs-render: html`\n\nFor code examples in Python, Node.js, PHP, Go, Java, and C#, see [examples.md](examples.md).","author":"@oxylabs","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/oxylabs/agent-skills/tree/main/skills/web-unblocker","license":"MIT","category":null,"lang":"en","tokens":905,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"examples.md","size":4766,"sha256":"a02908c838356a7c009ca3117484658efcc8b076f174546bc4cf4e37bc16dacb"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":["ip.oxylabs.io","unblock.oxylabs.io"]}}