scrapling-data

Lead-magnet Python SDK for Scrapling Data — pay-per-call crypto & web intel for AI agents via x402 (USDC on Base, no API key).

Install once. Get free local address tools and free store teasers. When you need the real answer, the same client speaks HTTP 402 → pay → retry against the live catalog.

• Site: https://scraplingdata.xyz
• Docs: https://scraplingdata.xyz/docs
• GitHub: https://github.com/scraplingdata
• Hugging Face: https://huggingface.co/scraplingdata
• MCP: https://scraplingdata.xyz/mcp

This package is the public thin SDK. It does not include Scrapling's private scrapers, label builders, or secrets.

Install

pip install scrapling-data

(Until published: pip install -e /path/to/scrapling-data)

30-second sticky start

# Free local checksum + free wallet-label teaser + paid price menu
scrapling-data check 0x28C6c06298d514Db089934071355E5743bf21d60

# Lookalike / address-poisoning heuristic (local, free)
scrapling-data check 0x28C6c06298d514Db089934071355E5743bf21d60 \
  --compare 0x28C6c06298d514Db089934071355E5743bf21d61

from scrapling_data import ScraplingData, inspect_address, to_checksum_address

print(inspect_address("0x28c6c06298d514db089934071355e5743bf21d60"))
print(to_checksum_address("0x28c6c06298d514db089934071355e5743bf21d60"))

with ScraplingData() as sd:
    print(sd.free_crypto_top10())          # free
    print(sd.free_wallet_label("0x28C6c06298d514Db089934071355E5743bf21d60"))
    # Paid — raises PaymentRequiredError with accepts[] unless you attach a signer:
    # sd.counterparty("0x28C6c06298d514Db089934071355E5743bf21d60")

What's free vs paid

Sticky funnel (by design)

1. scrapling-data check <addr> → valid + checksum + free label teaser.
2. See the paid menu with live catalog prices.
3. Call ScraplingData(...).counterparty(addr) (or risk-check / hack-tracker / …).
4. Without a wallet: clear 402 payload + docs link. With payment_handler: auto-retry with PAYMENT-SIGNATURE.

Paying with x402

from scrapling_data import ScraplingData, PaymentRequiredError

def my_signer(payment):
    """Return a PAYMENT-SIGNATURE string. Use your own wallet / x402 client.
    Never put a private key in this library or in source control."""
    accept = payment.preferred_accept()
    # ... sign accept with your viem / eth-account / Coinbase AgentKit / x402 SDK ...
    raise NotImplementedError("wire your signer here")

sd = ScraplingData(payment_handler=my_signer)
try:
    print(sd.counterparty("0x28C6c06298d514Db089934071355E5743bf21d60"))
except PaymentRequiredError as e:
    print(e.payment.to_dict())  # accepts, amount, payTo, how_to_pay

Also supported: pass_token= (day/month pass), api_key= (Bearer sk_scrapling_...), trial_code=.

Day pass $2 · month pass $25 · settlement payTo (EVM): 0x72C80C01fD89Bac74f47cf604b61ACd119c9BCdb.

Highlight paid routes (catalog hints)

Prices from live /llms.txt + OpenAPI (Nov 2026). 402 body is authoritative.

Full machine list: https://scraplingdata.xyz/llms.txt · https://scraplingdata.xyz/openapi.json

CLI

scrapling-data check <address> [--compare 0x...] [--offline] [--json]
scrapling-data catalog [--max-price 0.01]
scrapling-data ping

For agents / MCP

See AGENT.md. Remote MCP (same store): https://scraplingdata.xyz/mcp.

License

MIT © Scrapling Data