AproxPay CrewAI

CrewAI tools for AproxPay — residential proxy with native x402 payments (USDC on Base). No signup, no API key: a buyer wallet signs EIP-3009 transfers per request or session pass.

pip install crewai-aproxpay
# or: uv add crewai-aproxpay

Requires Python >=3.10,<3.14 (CrewAI constraint).

Every request sets X-Client-Source: crewai so AproxPay funnel metrics attribute traffic correctly.

Quickstart

export APROXPROXY_PRIVATE_KEY=0x…   # dedicated low-balance buyer wallet on Base

from crewai import Agent, Task, Crew
from crewai_aproxpay import AproxPayProxyGetTool, create_aproxpay_tools

# Single hero tool:
agent = Agent(
    role="Researcher",
    goal="Fetch public pages via residential IP",
    backstory="Uses AproxPay for geo-aware HTTP fetches.",
    tools=[AproxPayProxyGetTool()],
    verbose=True,
)

# Or bind the full set (shared client / session credential cache):
# tools = create_aproxpay_tools()

task = Task(
    description="Fetch https://api.ipify.org?format=json and report the IP.",
    expected_output="JSON with the observed public IP",
    agent=agent,
)

Crew(agents=[agent], tasks=[task]).kickoff()

Direct call without an LLM (useful for smoke tests):

from crewai_aproxpay import AproxPayProxyGetTool

print(AproxPayProxyGetTool().run(url="https://api.ipify.org?format=json"))

Environment

Tools

Product A success responses are HTTP 200 with origin status in X-Target-Status — tools return that origin status, not the envelope 200.

Session pass (Playwright)

from crewai_aproxpay import AproxPayCreateSessionTool
import json

raw = AproxPayCreateSessionTool().run(tier="entry", region="us")
session = json.loads(raw)
# Always use the https proxy URL — never plain http:// against gw:443
proxy_url = session["proxyUrl"]  # https://user:pass@gw.aproxpay.com:443

Production gateway is TLS on :443. Documented fallback: same credentials on :8443 (https://user:pass@gw.aproxpay.com:8443). Plain http:// to :443 hits the web front and returns 404.

Pricing

See aproxpay.com/pricing for the live ladder. Approximate MVP tiers:

Security

• Keep the buyer private key on the machine that runs the agent (non-custodial).
• Do not log APROXPROXY_PRIVATE_KEY, Authorization, or payment headers.
• Close session early if you are done — there is no automatic refund.

Development

uv sync --group dev
uv run ruff check src tests
uv run mypy src
uv run pytest

License

MIT © AproxPay