From obul-scrape
USE THIS SKILL WHEN: the user wants a quick single-page scrape to markdown or a webpage screenshot. Provides lightweight web scraping and screenshots via x402engine through the Obul proxy.
How this skill is triggered — by the user, by Claude, or both
Slash command
/obul-scrape:x402engine-webThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
x402engine provides pay-per-call web scraping and screenshot endpoints. Scrape any URL into clean markdown or capture a
x402engine provides pay-per-call web scraping and screenshot endpoints. Scrape any URL into clean markdown or capture a full-page screenshot as a base64 image. Through the Obul proxy, each request is paid individually — no x402engine account or API key required.
All requests use the obulx CLI, which handles proxy routing and authentication automatically.
Install and log in (one-time setup):
npm install -g @obul.ai/obulx
obulx login
Base URL: https://x402-gateway-production.up.railway.app
Scrape a single URL and receive clean markdown content. No configuration needed — just pass a URL and get back well-structured markdown extracted from the page.
Pricing: $0.005
obulx "https://x402-gateway-production.up.railway.app/api/web/scrape?url=https://example.com/page"
Response: JSON object with the scraped URL and clean markdown content extracted from the page.
Capture a full-page screenshot of any URL. The page is rendered in a browser and returned as a base64-encoded PNG image.
Pricing: $0.01
obulx "https://x402-gateway-production.up.railway.app/api/web/screenshot?url=https://example.com/page"
Response: JSON object with the URL and a base64-encoded PNG image of the rendered page. Decode the base64 string
and save as a .png file to view.
Perform a neural web search with highlighted snippets. Returns relevant results with context for a given query.
Pricing: $0.01
obulx -X POST -H "Content-Type: application/json" \
-d '{"query": "x402 payment protocol"}' \
"https://x402-gateway-production.up.railway.app/api/search/web"
Response: JSON object with search results, each containing title, URL, snippet, and relevance score.
Extract clean text content from up to 10 URLs in a single request. Useful for batch content extraction.
Pricing: $0.005
obulx -X POST -H "Content-Type: application/json" \
-d '{"urls": ["https://example.com/page1", "https://example.com/page2"]}' \
"https://x402-gateway-production.up.railway.app/api/search/contents"
Response: JSON object with extracted text content for each provided URL.
| Endpoint | Price | Purpose |
|---|---|---|
GET /api/web/scrape | $0.005 | Scrape a URL to clean markdown |
GET /api/web/screenshot | $0.01 | Capture a URL as a base64 PNG image |
POST /api/search/web | $0.01 | Neural web search with snippets |
POST /api/search/contents | $0.005 | Extract clean text from up to 10 URLs |
/api/search/contents.base64 -d > screenshot.png to save as a viewable file./api/search/contents (up to 10 URLs)
instead of calling /api/web/scrape repeatedly./api/web/scrape is clean and token-efficient, ideal for
feeding into LLM prompts or RAG pipelines.| Error | Cause | Solution |
|---|---|---|
402 Payment Required | Payment not processed or insufficient | Verify your account has sufficient balance at my.obul.ai. Run obulx login if not authenticated. |
400 Bad Request | Missing or invalid url parameter | Ensure the url query parameter is present and is a valid URL. |
422 Unprocessable Entity | URL cannot be scraped or screenshotted | The target URL may be inaccessible. Try a different URL. |
429 Too Many Requests | Rate limit exceeded | Add a short delay between requests and avoid rapid-fire calls. |
500 Internal Server Error | Upstream x402engine service issue | Wait a few seconds and retry. If persistent, the service may be experiencing downtime. |
504 Gateway Timeout | Page took too long to render | The target page may be very heavy. Try a simpler page or use basic HTTP scraping instead. |
npx claudepluginhub polymerdao/pay-plugin --plugin obul-scrapeCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.