⚡ Multi-Chain & Solana x402 Autonomous AI Agent Suite & Spend Firewall (v2.8.3)

"High-Throughput Clean Web Markdown, YouTube Intelligence & Cryptographic Web3 Oracles for Autonomous AI Agents & Swarms."
Zero credit cards required. Pure B2A (Business-to-Agent) USDC micropayments & pre-funded vaults on Solana, Polygon, Base, and Arbitrum with Solscan Verified IDLs & EIP-712 spend policy attestations.

📦 Official Multi-Registry Ecosystem Suite (PyPI ↔ npm)

CleanWeb is distributed natively across both Python (PyPI) and TypeScript/Node.js (npm) registries. Install the companion package for your stack—or combine the Python MCP/Oracle Core with TypeScript agent frameworks:

💡 Full-Stack Hybrid Pattern (Recommended): Run pip install x402-cleanweb-agent on your backend/MCP host for local Dual-Core Security Gate + Eliza Brain scrubbing, and connect your TypeScript agents via npm install agentkit-cleanweb or npm install cleanweb-eliza-plugin.

🌐 Live Production Gateway & Endpoints

• Production Gateway: https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app
• Agent LLM Standard (llms.txt): https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/llms.txt
• A2A Agent Manifest: /.well-known/agent.json
• OpenAI Plugin Manifest: /.well-known/ai-plugin.json
• MCP Server Card: /.well-known/mcp/server-card.json
• Arbitrage ROI Calculator: /api/v1/agent/arbitrage-roi
• Interactive Studio Dashboard: https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/dashboard
• Interactive OpenAPI Specs: https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/docs

🤖 1-Minute Framework Integration (Coinbase AgentKit, ElizaOS, LangChain & CrewAI)

Equip your autonomous agents across TypeScript (npm) and Python (PyPI) in under 1 minute:

// TypeScript: Official Coinbase AgentKit Action Provider (npm: agentkit-cleanweb)
import { cleanWebActionProvider } from "agentkit-cleanweb";

const cleanWeb = cleanWebActionProvider({ vaultKey: process.env.AGENT_VAULT_KEY });

// TypeScript: Official ElizaOS v2 Plugin (npm: cleanweb-eliza-plugin)
import { cleanWebPlugin } from "cleanweb-eliza-plugin";

export default { name: "AlphaScoutAgent", plugins: [cleanWebPlugin] };

# Python: ElizaOS / Dual-Core Gate-Brain Bridge (PyPI: x402-cleanweb-agent)
from app.integrated_gate_brain_bridge import IntegratedGateBrainBridge

bridge = IntegratedGateBrainBridge(require_x402_payment=False)
res = bridge.execute_pipeline("https://paulgraham.com/greatwork.html", "https://paulgraham.com")

# Python: LangChain & CrewAI Agent Tools
from examples.langchain_agent_example import clean_web_tool
from examples.crewai_agent_example import clean_web_for_crewai

result = clean_web_tool.invoke({"url": "https://paulgraham.com/greatwork.html"})

⚡ 10-Second Instant Test (Zero Auth / 3 Free Calls Included)

No wallet, credit card, or API key needed. Attach an X-Agent-Nonce header to test immediately:

# Instant JSON Request via curl
curl -X POST "https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/api/v1/clean-web" \
     -H "Content-Type: application/json" \
     -H "X-Agent-Nonce: instant-trial-uuid-001" \
     -d '{"url": "https://news.ycombinator.com"}'

# Zero-dependency Python snippet
import urllib.request, json

req = urllib.request.Request(
    "https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/api/v1/clean-web",
    data=json.dumps({"url": "https://news.ycombinator.com"}).encode(),
    headers={"Content-Type": "application/json", "X-Agent-Nonce": "instant-trial-01"}
)
res = json.loads(urllib.request.urlopen(req).read())
print(f"Tokens Saved: {res.get('estimated_token_savings', '87%')}")
print("Clean Markdown Preview:\n", res["clean_markdown"][:300])

💡 Mathematical Token Arbitrage Proof (Economic Rationality)

Autonomous agents route web traffic through x402 because it mathematically saves the operator money on every query:

• Direct Scraping Cost: 80KB HTML ≈ 20,000 tokens ($0.05 USD input cost on GPT-4o / Claude 3.5 Sonnet).
• x402 CleanWeb Cost: $0.001 API fee + 2,600 clean tokens ($0.0065 USD) = $0.0075 USD Total.
• Net Savings: $0.0425 USD saved per web query (85% net dollar reduction).
• Service Fee ROI: 4,250% ROI on the $0.001 fee.
• Live Arbitrage Endpoint: GET /api/v1/agent/arbitrage-roi?input_tokens=50000

{
  "status": "economically_optimal",
  "routing_recommendation": "ROUTE_VIA_X402",
  "financial_analysis": {
    "cost_raw_direct_usd": 0.125,
    "cost_with_x402_usd": 0.01725,
    "net_dollar_savings": 0.10775,
    "net_savings_percentage": "86.2%",
    "service_fee_roi_percentage": "10775.0%"
  }
}

🔮 14 Production Agent Tools & Micro-Pricing (USDC)

💻 1-Click MCP Setup (Claude Desktop, Cursor, Windsurf)

Connect CleanWeb directly to Claude Desktop, Cursor, or any Model Context Protocol client using uvx:

{
  "mcpServers": {
    "polygon-x402-cleanweb": {
      "command": "uvx",
      "args": ["x402-cleanweb-agent"]
    }
  }
}

Or configure via local clone:

{
  "mcpServers": {
    "polygon-x402-cleanweb": {
      "command": "python",
      "args": ["-u", "mcp_server.py"],
      "env": {
        "POLYGON_RPC_URL": "https://polygon-bor-rpc.publicnode.com",
        "SERVER_WALLET_ADDRESS": "0xA185B43fDD19619f99952AAed6eabf1029bF36a1",
        "USDC_CONTRACT_ADDRESS": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
      }
    }
  }
}

🤖 Multi-Agent Framework Integrations

Drop-in ready integrations for every major autonomous agent framework via GET /api/v1/agent/integrations/{framework}:

🦜 LangChain / LangGraph

from langchain.tools import tool
import requests

@tool
def clean_web(url: str) -> str:
    """Fetches a URL and returns ad-free, token-optimized Markdown (87% token savings)."""
    res = requests.get(
        "https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/api/v1/clean-web",
        params={"url": url},
        headers={"X-Agent-Nonce": "langchain-agent-session"}
    )
    return res.json().get("clean_markdown", "")

👥 CrewAI

from crewai.tools import tool
import requests

@tool("CleanWeb Tool")
def clean_web(url: str) -> str:
    """Strips HTML boilerplate and returns pure Markdown to save LLM context window."""
    res = requests.post(
        "https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/api/v1/clean-web",
        json={"url": url},
        headers={"X-Agent-Nonce": "crewai-agent-session"}
    )
    return res.json().get("clean_markdown", "")

🤖 Microsoft AutoGen

import requests

def clean_web_tool(url: str) -> str:
    res = requests.get(
        "https://x402-cleanweb-agent-7qxtp3324q-du.a.run.app/api/v1/clean-web",
        params={"url": url},
        headers={"X-Agent-Nonce": "autogen-session"}
    )
    return res.json().get("clean_markdown", "")

# assistant.register_for_llm(name="clean_web", description="Clean web markdown")(clean_web_tool)

🏛️ Verified On-Chain Smart Contracts & Accounts (Polygon, Base, Arbitrum, Solana)

CleanWeb operates verified, deterministic smart contracts and native settlement accounts for on-chain EIP-712 oracle verification, autonomous agent pre-funded vault management, and Solana SPL USDC micropayments.

🧪 Production Readiness Review: 84/84 Tests Passed (100%)

Verified across all 38+ FastAPI routes, 14 agent tools, Dual-Core Gate-Brain cognitive pipeline, multi-chain settlement vaults, and EIP-712 attestations:

python -m pytest tests/ -v

⚖️ Legal, Fair Use & Financial Non-Liability Disclaimer

CleanWeb Studio operates strictly under the Transformative Non-Expressive Text/Data Mining (TDM) Fair Use doctrine for autonomous AI reasoning.

1. No Financial or Investment Warranty: All oracle feeds, search results, and scraped contents are provided AS-IS. CleanWeb Studio assumes zero liability for DeFi smart contract liquidations, prediction market settlements (e.g. Polymarket), or trading losses resulting from external web misreporting or LLM hallucinations.
2. Caller Responsibility: The autonomous agent deployer/caller is solely responsible for respecting target website intellectual property and applicable laws.
3. Zero-Data Retention (GDPR Compliant): All fetched HTML and raw assets are processed ephemerally in RAM and purged immediately upon response transmission.
4. 100% OFAC Sanctions Filtering: All micropayment addresses are verified against OFAC Specially Designated Nationals (SDN) lists.
5. Full Legal Endpoints:
   • GET /api/v1/legal/terms: Official Machine-to-Machine Terms of Service
   • GET /api/v1/legal/disclaimer: Full Legal & Financial Disclaimer

📜 License

Distributed under the MIT License. See LICENSE for more information.