English Français العربية

dev.paypercall.extract/vend-api-merchant

السجل الرسمي البحث والويب

Pay-per-call web intel: extract, search, link check, domain, geo, Nano. Settled via Nano x402.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http vend-api-merchant 'https://extract.paypercall.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vend-api-merchant": {
            "type": "http",
            "url": "https://extract.paypercall.dev/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Vend — Autonomous API Merchant
  2. Endpoints
  3. Quick buyer guide
  4. How it works (buyer flow)
  5. Conformance
  6. Discovery
  7. Running locally
  8. License

Vend — Autonomous API Merchant

Pay-per-call APIs settled in Nano (XNO). No signup, no API keys — just HTTP 402 with an x402 v2 challenge.

Endpoints

EndpointPrice (XNO)What it does
GET /api/v1/extract?url=0.0001Extract clean text/markdown from any web page
GET /api/v1/check-link?url=0.0001Check HTTP status, response time, redirect chain
GET /api/v1/status?url=0.0001URL status, redirects, TLS expiry, content-drift
GET /api/v1/domain-info?domain=0.0005Full domain intelligence: DNS, WHOIS, SSL, HTTP headers
GET /api/v1/web-search?q=0.0001Web search via DuckDuckGo — titles, URLs, snippets
GET /api/v1/geoip?ip=0.0001IP geolocation — country, city, coordinates, ISP, ASN
GET /api/v1/youtube-transcript?url=0.0005Captions + timestamped transcript from a YouTube video
GET /api/v1/nano-info?account=0.0005Nano account intelligence — balance, representative, block count, frontier, weight, pending
GET /api/v1/youtube-transcript?url=0.0005Captions/transcript from a YouTube video
GET /api/v1/select?url=&selector=0.0001CSS-selector structured field extraction from a page (prices, headings, links)
GET /api/v1/links?url=0.0001Extract every anchor link on a page as structured JSON (crawl, audit, sitemap)
GET /api/v1/pdf-extract?url=0.0005Extract text from a PDF URL, page-structured, ready for LLM consumption
GET /api/v1/ai-jobs?q=0.0002Search 19,800+ live AI/AI-adjacent job postings with filters
GET /api/v1/arxiv-paper?arxiv_id=0.0001Clean arXiv paper metadata by ID or search: title, authors, primary category, abstract, published, DOI, PDF link

Quick buyer guide

BUYERS_GUIDE.md — full step-by-step walkthrough with curl, Python, JavaScript, and wallet instructions.
The short version: call any endpoint -> get 402 -> send Nano -> retry with block hash.

How it works (buyer flow)

1. GET /api/v1/extract?url=https://example.com
   → HTTP 402 with x402 payment challenge

2. Send 0.0001 XNO to nano_1yo6c1t64ahfjdw1dxizmbbnpdmbrckwhw9phbg5pdkeubrizga4qhnjmnx7
   → Get back a 64-char block hash

3. GET /api/v1/extract?url=https://example.com  -H "X-PAYMENT: <block-hash>"
   → HTTP 200 with the extracted text
Python example
import httpx

# Step 1: Probe unpaid
resp = httpx.get("https://search.paypercall.dev/api/v1/web-search?q=nano")
assert resp.status_code == 402
challenge = resp.json()

# Step 2: Extract payment info
accept = challenge["accepts"][0]
print(f"Pay {challenge['price_xno']} XNO to {accept['payTo'][:15]}...")

# Step 3: Send Nano payment, get block hash (use your wallet)
# Step 4: Retry with payment
result = httpx.get(
    "https://search.paypercall.dev/api/v1/web-search?q=nano",
    headers={"X-PAYMENT": "your-64-char-block-hash"}
)
print(result.json())

See examples/python-buyer.py for a full working script with error handling.

Conformance

All endpoints pass the Stelar x402 Doctor at 100.0/A:

x402 v2 challenge in both header and body. Per-endpoint subdomains. Bazaar input schema on every endpoint.

Discovery

Running locally

# Our package is not on PyPI yet (the `vend` name on PyPI is an unrelated packaging tool).
# Run from this repo instead:
uv sync
export VEND_WALLET_ADDRESS="nano_..."
uv run python -m vend

License

MIT

الأسئلة الشائعة

ما هو dev.paypercall.extract/vend-api-merchant؟

Pay-per-call web intel: extract, search, link check, domain, geo, Nano. Settled via Nano x402.

كيف أثبّت dev.paypercall.extract/vend-api-merchant؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http vend-api-merchant 'https://extract.paypercall.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج dev.paypercall.extract/vend-api-merchant إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل dev.paypercall.extract/vend-api-merchant مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون dev.paypercall.extract/vend-api-merchant؟

ينشره dhyabi2. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.