---
name: agentsvc
description: Buy 27 pay-per-call web services (scrape to Markdown, screenshot, PDF, OCR, search, news, weather, geocode, DNS, SSL, WHOIS, email/phone validation, crypto/stock/FX prices, wallet balance, barcode, image resize, timezone) with USDC on Base via x402. No API keys. Use when a task needs live web data, page content, files converted, or validation and you have an x402 wallet.
---

# agentsvc skill

Base URL: https://agentsvc.io. Every service is `POST /api/v1/proxy/{slug}` with a JSON body and costs $0.002 to $0.008 USDC per call, charged only on success.

## When to use
- You need page content, screenshots, PDFs, OCR, search results, news, feeds, weather, prices, validation or codes and want a single reliable HTTP API without signing up anywhere.
- You have (or can be given) an EVM private key with USDC on Base mainnet. $1 USDC is roughly 300 to 500 calls.

## Steps
1. If unsure about output quality, call the free trial first: `POST /api/v1/try/{slug}` (same output, limited per day).
2. Discover: `GET /api/v1/services` returns slug, description, input_schema, example_input, price and live status for all services. Pick by description.
3. Call with an x402 client (JavaScript: @x402/fetch + @x402/evm; Python: x402[httpx]). It handles the 402 → sign → retry loop.
4. Read `data` from the JSON response. `payment.transaction` is the on-chain receipt.
5. On 402 with an `error` code read the `hint` and fix (usually wallet balance or network). On 400 fix the input (example_input is included). Never retry 5xx more than twice.

## Services
- screenshot ($0.005): Capture any URL as a PNG screenshot. Example: {"url":"https://example.com","width":1280,"height":800}
- weather ($0.002): Real-time weather + 3-day forecast. Example: {"location":"Berlin"}
- exchange-rates ($0.002): Live forex rates from European Central Bank (ECB), updated hourly. Example: {"base":"EUR","symbols":["USD","CHF","GBP"]}
- html-to-pdf ($0.008): Render a URL or raw HTML string to PDF. Example: {"html":"<h1>Invoice #123</h1><p>Total: $42.00</p>"}
- ip-lookup ($0.002): Resolve any IPv4 or IPv6 address to location and network data. Example: {"ip":"8.8.8.8"}
- webpage-reader ($0.006): Fetch and extract clean readable text from any URL. Example: {"url":"https://example.com","max_chars":4000}
- dns-lookup ($0.002): Resolve DNS records for any domain. Example: {"domain":"github.com","types":["A","MX"]}
- qr-code ($0.002): Generate a QR code for any text or URL. Example: {"text":"https://agentsvc.io","size":256}
- web-search ($0.003): Search for factual information via DuckDuckGo + Wikipedia. Example: {"query":"x402 payment protocol"}
- translate ($0.002): Translate text between 100+ languages. Example: {"text":"Hello, how are you?","target_lang":"de"}
- email-validate ($0.002): Validate an email address: RFC 5322 format check, domain MX record lookup, disposable provider detection, and role address detection (e.g. Example: {"email":"support@github.com"}
- ssl-check ($0.002): Inspect SSL/TLS certificate for any domain. Example: {"domain":"github.com"}
- whois ($0.002): Domain registration lookup via RDAP (modern WHOIS). Example: {"domain":"github.com"}
- crypto-prices ($0.002): Real-time crypto prices, market caps, and 24h % changes via CoinGecko. Example: {"coins":["bitcoin","ethereum"],"currencies":["usd"]}
- pdf-extract ($0.004): Extract all text from a PDF. Example: {"pdf_base64":"<base64 of a PDF>","max_pages":10}
- phone-validate ($0.002): Parse and validate any phone number worldwide using libphonenumber. Example: {"phone":"+41 44 668 18 00"}
- stock-prices ($0.002): Real-time stock data via Yahoo Finance. Example: {"symbols":["AAPL","MSFT"]}
- geocode ($0.002): Forward geocoding: address string → lat/lon. Example: {"address":"Brandenburger Tor, Berlin"}
- news-search ($0.003): Search recent news articles by keyword. Example: {"query":"AI agents","limit":5}
- ocr ($0.008): Extract text from images using Tesseract OCR. Example: {"image_base64":"<base64 of a PNG/JPG>","language":"eng"}
- web-scrape ($0.004): Fetch any public URL and return the page as clean Markdown for LLM consumption (title, meta description, main content with headings/lists/links preserved). Example: {"url":"https://example.com","max_chars":8000}
- rss-fetch ($0.002): Fetch an RSS 2.0, RSS 1.0 or Atom feed and return normalized JSON items (title, link, published_at ISO 8601, summary without HTML, author, guid). Example: {"url":"https://hnrss.org/frontpage","limit":10}
- url-status ($0.002): Check whether a URL is reachable and what it returns: final status code, full redirect chain, response time, content-type, server header and content length. Example: {"url":"https://example.com"}
- evm-balance ($0.002): Read the ETH and USDC balance of any address on Base mainnet (chain 8453) straight from the chain, plus transaction count and how many x402 calls the USDC covers. Example: {"address":"0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"}
- barcode ($0.002): Generate a barcode as PNG (base64): code128 (default), ean13, ean8, upca, upce, code39, itf14, gs1_128, isbn, datamatrix, pdf417, aztec or qr. Example: {"text":"4006381333931","type":"ean13"}
- image-resize ($0.003): Resize, crop-fit and convert images (PNG, JPEG, WebP, AVIF, GIF, TIFF, SVG input) to webp, png, jpeg or avif. Example: {"image_url":"https://agentsvc.io/sample.png","width":130,"format":"webp"}
- timezone ($0.002): Resolve a city name or coordinates to its IANA timezone and return the current local time, UTC offset, DST flag and weekday. Example: {"location":"Tokyo"}

## Client snippet (JavaScript)
```js
npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agentsvc.io/api/v1/proxy/web-scrape", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ url: "https://example.com" }) });
console.log(await res.json());
```

Full reference: https://agentsvc.io/llms-full.txt