- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add oxylabs/agent-skills --skill web-scraper-api -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add oxylabs/agent-skills --skill web-scraper-api -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add oxylabs/agent-skills --skill web-scraper-api -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add oxylabs/agent-skills --skill web-scraper-api -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/oxylabs/agent-skills/tree/HEAD/skills/web-scraper-apiFrom the publisher
Requires HTTP Basic Auth with credentials from environment variables:
curl -u "$OXY_WSA_USERNAME:$OXY_WSA_PASSWORD" ...
POST https://realtime.oxylabs.io/v1/queries # immediate response
POST https://data.oxylabs.io/v1/queries # Push-Pull jobs, callbacks, storage
Content-Type: application/json
user_agent_type values: desktop, desktop_chrome, desktop_edge, desktop_firefox, desktop_opera, desktop_safari, mobile, mobile_android, mobile_ios, tablet, tablet_android, tablet_ios.
Add these as { "key": "...", "value": ... } objects in context:
For multi-format output, enable types in the payload (parse, markdown, xhr, render: "png") and request them with ?type=raw,parsed,png,markdown,xhr.
For batch Push-Pull jobs, use POST /v1/queries/batch with arrays only for query or url; keep all other parameters singular. Maximum batch size is 5,000 values.
Scrape any URL:
curl -X POST 'https://realtime.oxylabs.io/v1/queries' \
-u "$OXY_WSA_USERNAME:$OXY_WSA_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"source": "universal", "url": "https://example.com"}'
Google search with parsing:
curl -X POST 'https://realtime.oxylabs.io/v1/queries' \
-u "$OXY_WSA_USERNAME:$OXY_WSA_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"source": "google_search", "query": "best laptops", "parse": true}'
Amazon product by ASIN:
curl -X POST 'https://realtime.oxylabs.io/v1/queries' \
-u "$OXY_WSA_USERNAME:$OXY_WSA_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"source": "amazon_product", "query": "B07FZ8S74R", "parse": true}'
amazon_product, google_search) - better parsing and reliabilityuniversal for unsupported sites - works with any URLparse: true for structured JSON output on supported sources{
"results": [{
"content": "...",
"status_code": 200,
"url": "https://..."
}]
}
With parse: true, content contains structured data (title, price, reviews, etc.) instead of raw HTML.
For the complete list of 40+ supported sources organized by category, see sources.md.
For detailed request/response examples including geo-location, JavaScript rendering, and custom headers, see examples.md.
parse: true for supported sources to get structured data"90210")"California,United States")render: "html" for JavaScript-heavy pagesrender: "" only to disable automatic forced rendering for force-rendered pages; set client timeouts near 180 seconds for rendered Realtime or Proxy Endpoint requestscontent_encoding: "base64" when scraping image URLs, then decode results[0].content before saving the fileProduction-grade web scraping with automatic anti-bot bypass, structured JSON parsing for 40+ targets, and geo-targeting. Use when the user needs to scrape web pages, extract product data, get search
---name: web-scraper-apidescription: Production-grade web scraping with automatic anti-bot bypass, structured JSON parsing for 40+ targets, and…---# skills/web-scraper-api/SKILL.mdOverview
Production-grade web scraping with automatic anti-bot bypass, structured JSON parsing for 40+ targets, and geo-targeting. Use when the user needs to scrape web pages, extract product data, get search results, or collect structured data from supported e-commerce and search platforms without worrying about getting blocked and when geo targeting is required.
FAQ
Download skills/web-scraper-api/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/oxylabs/agent-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.