Metadata-Version: 2.5
Name: lordevo-x402
Version: 0.1.3
Summary: Client for Lordevo's pay-per-call web, DNS, email, domain and data checks for AI agents: 44 tools from $0.002, paid with x402 (USDC on Base). LangChain and CrewAI tools included.
Project-URL: Homepage, https://shop.lordevo.com
Project-URL: Documentation, https://shop.lordevo.com/llms.txt
Author-email: Lordevo <hello@lordevo.com>
License-Expression: MIT
License-File: LICENSE
Keywords: a2a,ai-agents,base,crewai,dns,langchain,mcp,robots.txt,security,seo,usdc,x402
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: crewai
Requires-Dist: crewai>=0.80; extra == 'crewai'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.3; extra == 'langchain'
Provides-Extra: pay
Requires-Dist: eth-account>=0.13; extra == 'pay'
Requires-Dist: x402[evm,httpx,requests]>=2.25; extra == 'pay'
Description-Content-Type: text/markdown

# lordevo-x402 (Python)

Python client for the pay-per-call checks at **[shop.lordevo.com](https://shop.lordevo.com)**. It has 44 web, DNS, email, domain and data tools for AI agents, priced from $0.002 per call and paid with [x402](https://x402.org) (USDC on Base). There's no account or API key: each call is one micro-payment from the agent's wallet. Calls that fail or get refused (4xx/5xx) are never charged. LangChain and CrewAI tools are included.

```bash
pip install lordevo-x402            # free helpers
pip install "lordevo-x402[pay]"     # paid calls (x402 + eth-account)
pip install "lordevo-x402[pay,langchain]"   # or [pay,crewai]
```

## Try it free (no wallet)

3 free calls per IP per UTC day on tools priced up to $0.005. When they are used up the call raises `LordevoError` with status 402; then pay per call as below.

```python
import lordevo_x402 as L
print(L.try_free("dns-lookup", "example.com"))
```

## Quickstart

Free calls need no wallet:

```python
from lordevo_x402 import ask, quote, catalog

ask("dns-lookup example.com")            # A2A router: the endpoint, price and payment terms
quote("can-fetch", "https://example.com/blog")   # live x402 terms from the HTTP 402, nothing is paid
len(catalog()["quick_checks"])           # 44
```

Paid calls need a Base wallet holding a little USDC:

```python
import os
from lordevo_x402 import LordevoSync, Lordevo

lo = LordevoSync.from_private_key(os.environ["AGENT_WALLET_KEY"], max_price_usd=0.02)
lo.can_fetch("https://example.com/blog/post")    # robots.txt + AI-crawler gate, $0.002
lo.dns_lookup("example.com", type="MX")          # $0.002
lo.email_validate("jane@gmial.com")              # syntax + MX + disposable + typo hint, no SMTP, $0.002
lo.json_validate({"name": "Ada"}, schema={"type": "object", "required": ["name"]})   # $0.002
lo.text_chunk(url="https://example.com/post", max_tokens=300)                       # text or url, $0.005

# async
async with Lordevo.from_private_key(os.environ["AGENT_WALLET_KEY"]) as alo:
    await alo.link_check("https://bit.ly/xyz")
```

- `max_price_usd` (default 0.05): tools priced above it are refused before any request.
- `cache_seconds`: identical calls within the window are answered locally and not paid again.
- Dicts (`json`, `schema`) are sent as JSON text and lists (`urls`) as comma lists. Tools marked "POST ok" switch to a JSON POST by themselves when the GET URL would be longer than 2,000 characters.
- Errors raise `LordevoError` with `status`, `code` and `charged`.
- You can also pass your own paying client: `Lordevo(x402HttpxClient(...))` or `LordevoSync(x402_requests(...))`.

## LangChain and CrewAI

```python
from lordevo_x402.langchain import langchain_tools
tools = langchain_tools(sync_client=lo, only=["can-fetch", "link-check", "dns-lookup"])

from lordevo_x402.crewai import crewai_tools
agent = Agent(role="Researcher", goal="...", backstory="...", tools=crewai_tools(lo, only=["can-fetch", "link-check"]))
```

## Tools

These are the prices from [catalog.json](https://shop.lordevo.com/catalog.json) when this version was released; `quote()` and `catalog()` always read the live ones. Call any of them with `lo.call(slug, value, **options)` or as a method (`lo.dns_lookup`).

<!-- tools:begin (generated by gen-tools.mjs from the shop QUICK_TOOLS) -->
| Tool | Input | Price | What it does |
|---|---|---|---|
| `site-check` | `url` | $0.02 | Site check: trust + AI readiness + security headers (recommended start) |
| `agent-readiness` | `url` | $0.02 | Agent readiness / AI visibility score (GEO) |
| `url-trust` | `url` | $0.002 | URL trust check before you click or pay (safe / caution / risky) |
| `can-fetch` | `url` | $0.002 | Can I fetch this URL? robots.txt + AI-crawler permission gate |
| `link-check` | `url` | $0.002 | Link check: is it alive, where does it really go (redirects resolved) |
| `dns-lookup` | `host` (opt: type) | $0.002 | DNS lookup (A, AAAA, CNAME, MX, TXT, NS, SOA, CAA) |
| `email-validate` | `email` | $0.002 | Email address validation (syntax + domain + MX, no SMTP probing) |
| `ssl-cert` | `host` | $0.002 | SSL/TLS certificate check (expiry, issuer, SANs, chain) |
| `domain-rdap` | `domain` | $0.002 | Domain age, registrar and expiry (RDAP) |
| `ip-info` | `ip` | $0.002 | IP address owner and network (RDAP + reverse DNS) |
| `links-batch` | `urls` | $0.01 | Batch link check (up to 10 URLs per call) |
| `broken-links` | `url` | $0.01 | Broken links on a page (up to 40 links checked) |
| `sitemap-urls` | `url` | $0.005 | Sitemap URL extractor (robots.txt + sitemap index) |
| `link-preview` | `url` | $0.005 | Link preview / unfurl (title, description, image, favicon, logo) |
| `readability` | `url` | $0.005 | Readability and word count (Flesch, reading time, top terms) |
| `structured-data` | `url` | $0.005 | Structured data extractor (JSON-LD, microdata, RDFa) |
| `canonical-check` | `url` | $0.002 | Canonical, hreflang and indexability check |
| `cors-check` | `url` (opt: origin, method) | $0.002 | CORS check (preflight + allowed origins) |
| `http-ping` | `url` | $0.002 | HTTP ping: up or down, status and timings (DNS, TCP, TLS, TTFB) |
| `domain-lookalike` | `host` | $0.002 | Lookalike / homograph domain check (punycode, mixed scripts, brand typos) |
| `myr-rates` | `currency` | $0.002 | Malaysian ringgit exchange rates + OPR (Bank Negara Malaysia data) |
| `redirect-chain` | `url` | $0.002 | Redirect chain: every hop with status, Location and time |
| `text-chunk` | `text` or `url` (opt: max_tokens, overlap_tokens), POST ok | $0.005 | Text chunker for RAG (heading-aware, token-sized chunks) |
| `token-count` | `text`, POST ok | $0.002 | Token count estimate (plus characters, words, bytes) |
| `json-validate` | `json` (+ schema), POST ok | $0.002 | JSON Schema validation with JSON Pointer errors |
| `json-repair` | `json`, POST ok | $0.002 | JSON repair for LLM output (fences, quotes, commas, truncation) |
| `time-convert` | `to` (opt: from, datetime) | $0.002 | Time zone conversion (IANA zones, offsets, DST) |
| `cron-next` | `cron` (opt: tz, count, after) | $0.002 | Cron next run times + plain-English description |
| `url-clean` | `urls`, POST ok | $0.002 | URL cleaner: strip tracking parameters, normalise, dedupe (up to 50) |
| `feed-parse` | `url` (opt: limit) | $0.005 | Feed reader: RSS, Atom and JSON Feed to normalised items |
| `page-diff` | `url` (opt: previous_hash, previous_text), POST ok | $0.005 | Page change check: content hash, clean text and line diff |
| `pdf-text` | `url` (opt: max_pages) | $0.01 | PDF to text, page by page |
| `verdict-card` | `url` | $0.01 | Shareable site verdict card (grade + one-liner, SVG) |
| `page-markdown` | `url` | $0.005 | Page to Markdown (main content) |
| `page-meta` | `url` | $0.005 | Page metadata + Markdown |
| `email-auth` | `domain` | $0.005 | Email authentication check (SPF, DKIM, DMARC) |
| `security-headers` | `url` | $0.005 | Security headers + TLS quick grade |
| `tech-stack` | `url` | $0.01 | Tech stack detection |
| `seo-page` | `url` | $0.01 | On-page SEO check (one page) |
| `site-snapshot` | `url` | $0.02 | Site snapshot (SEO + security + tech + email) |
| `page-quality` | `url` | $0.005 | Page quality verdict (AI) |
| `site-verdict` | `url` | $0.01 | Is this a legit business site? (AI trust verdict) |
| `seo-audit-lite` | `url` | $0.02 | SEO Audit LITE (top 10 issues, one page) |
| `security-scan-lite` | `url` | $0.02 | Website Security Scan LITE (passive summary) |
<!-- tools:end -->

## Other ways in

| Interface | Endpoint |
|---|---|
| MCP (streamable HTTP, x402 MCP transport) | `https://shop.lordevo.com/mcp` |
| A2A JSON-RPC (`message/send`, a free router) | `https://shop.lordevo.com/a2a` |
| x402 manifest | `https://shop.lordevo.com/.well-known/x402.json` |
| OpenAPI 3.1 | `https://shop.lordevo.com/openapi.json` |

Only check sites you are allowed to check. All checks are passive and read-only.

JavaScript package: [`lordevo-x402` on npm](https://www.npmjs.com/package/lordevo-x402). Docs: [shop.lordevo.com/llms.txt](https://shop.lordevo.com/llms.txt). MIT licence.
