vend-api-merchant

Vend — 自主 API 商户

以 Nano（XNO）结算的按次付费 API。无需注册，无需 API 密钥——只需通过带有 x402 v2 挑战的 HTTP 402 即可。

---

端点

端点	价格（XNO）	功能
GET /api/v1/extract?url=	0.0001	从任意网页提取干净的文本/Markdown
GET /api/v1/check-link?url=	0.0001	检查 HTTP 状态、响应时间和重定向链
GET /api/v1/status?url=	0.0001	URL 状态、重定向、TLS 到期时间、内容变化
GET /api/v1/domain-info?domain=	0.0005	完整的域名信息：DNS、WHOIS、SSL、HTTP 标头
GET /api/v1/web-search?q=	0.0001	通过 DuckDuckGo 搜索网页——标题、URL、摘要
GET /api/v1/geoip?ip=	0.0001	IP 地理位置——国家、城市、坐标、ISP、ASN
GET /api/v1/youtube-transcript?url=	0.0005	从 YouTube 视频获取字幕和带时间戳的转录文本
GET /api/v1/nano-info?account=	0.0005	Nano 账户信息——余额、代表、区块数、前沿区块、权重、待处理金额
GET /api/v1/youtube-transcript?url=	0.0005	从 YouTube 视频获取字幕/转录文本
GET /api/v1/select?url=&selector=	0.0001	从页面中按 CSS 选择器提取结构化字段（价格、标题、链接）
GET /api/v1/links?url=	0.0001	将页面中的所有锚点链接提取为结构化 JSON（爬取、审计、站点地图）
GET /api/v1/pdf-extract?url=	0.0005	从 PDF URL 提取文本，按页面结构组织，可直接供大模型使用
GET /api/v1/ai-jobs?q=	0.0002	搜索 19,800 多条实时 AI/AI 相关职位信息，并支持筛选
GET /api/v1/arxiv-paper?arxiv_id=	0.0001	按 ID 或搜索获取干净的 arXiv 论文元数据：标题、作者、主要类别、摘要、发布日期、DOI、PDF 链接

买家快速指南

BUYERS_GUIDE.md — 提供完整的分步指南，涵盖 curl、Python、JavaScript 和钱包说明。
简而言之：调用任意端点 -> 收到 402 -> 发送 Nano -> 使用区块哈希重试。

工作原理（买家流程）

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 示例

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())

完整的可运行脚本及错误处理示例，请参阅 examples/python-buyer.py。

一致性

所有端点均通过 Stelar x402 Doctor 检查，得分为 100.0/A：

• extract：https://api.stelardigital.com/doctor?url=https://extract.paypercall.dev/api/v1/extract
• check-link：https://api.stelardigital.com/doctor?url=https://check.paypercall.dev/api/v1/check-link
• domain-info：https://api.stelardigital.com/doctor?url=https://domain.paypercall.dev/api/v1/domain-info
• web-search：https://api.stelardigital.com/doctor?url=https://search.paypercall.dev/api/v1/web-search
• geoip：https://api.stelardigital.com/doctor?url=https://geoip.paypercall.dev/api/v1/geoip
• nano-info：https://extract.paypercall.dev/api/v1/nano-info（nano.paypercall.dev 的 DNS 仍指向一个已失效的部署，因此所有公布的 URL 都使用此主机）

x402 v2 挑战同时包含在标头和正文中。每个端点都有独立子域名。每个端点都提供 Bazaar 输入架构。

发现

• x402 清单：https://extract.paypercall.dev/.well-known/x402（check、domain、search 端点也提供）
• OpenAPI 规范：https://extract.paypercall.dev/openapi.json（check、domain、search 端点也提供）
• agent-tools.cloud：https://agent-tools.cloud/services/extract-paypercall-dev-sub822

本地运行

# 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

许可证

MIT