# EZCTO 2.0

> AI Web Engineer Agent — Build agent-friendly websites and read any URL as structured data.

EZCTO is an AI-powered platform on BNB Chain that solves two problems: (1) generating production-ready websites that are natively optimized for AI agent consumption, and (2) converting any existing website into structured, token-efficient JSON that AI agents can read instantly.

## Core Products

### Generation Engine
Describe your project in natural language. EZCTO's AI architect designs the layout, selects components, generates images, and deploys a production-ready website — with native agent-friendly features (llms.txt, Schema.org, Media Manifest) baked in. Supports DeFi, DAO, NFT, Meme, GameFi, and general Web3 project types. Published sites are hosted on Cloudflare R2 with custom subdomains (yourname.ezcto.fun).

### Smart Web Reader
An intelligent web access acceleration layer for AI agents. When an agent needs to read any URL, the Smart Web Reader first checks a shared public cache. Cache hit returns structured JSON in under 100ms (~500 tokens instead of 15,000). Cache miss triggers HTML parsing, LLM-based structuring, and automatic contribution back to the public cache. Every agent that uses it makes the cache richer for every other agent — a compound network effect.

### OpenClaw Skill
The Smart Web Reader is distributed as an OpenClaw Skill that integrates invisibly into any AI agent workflow. When an agent needs to access a URL, the Skill automatically triggers — no user action required. Install from ClawHub: https://clawhub.ai/takahashigy/ezcto-smart-web-reader

## API Reference

Base URL: https://ezcto.fun/api/v1

### Endpoints

GET /api/v1/translate?url={url}
- Cache lookup. Returns structured JSON if the URL has been previously parsed.
- Free, unlimited, no API key required.
- Response: { found: boolean, data: StructuredSiteData | null }

POST /api/v1/contribute
- Submit a parsed result to the public cache.
- Free, requires API key.
- Body: { url, structured_data, html_hash }
- Three-tier validation: format → logic → async sampling.

POST /api/v1/translate-server
- Server-side parsing for URLs not in cache.
- Paid, requires API key. Costs 1 quota unit per request.
- Body: { url }
- Returns: { data: StructuredSiteData }

POST /api/v1/refresh
- Force re-parse a cached URL.
- Costs 3 quota units.
- Body: { url }

### Structured Output Schema
Every parsed site returns JSON with these fields:
- site_type: auto-detected category (crypto_token, nft_collection, defi_protocol, dao, ecommerce, restaurant, portfolio, general)
- title, description, language
- main_content: array of { heading, text } sections
- navigation: array of { label, url } links
- images: array of { url, alt, context, dimensions }
- videos: array of { platform, url, title, thumbnail }
- actions: array of { label, url, type } (buttons, CTAs)
- social_links: array of { platform, url }
- structured_data: extracted Schema.org / JSON-LD
- metadata: { favicon, canonical_url, og_image, theme_color }
- crypto_specific: { contract_addresses, chain, token_symbol, dex_links } (when applicable)

## Authentication
- Public endpoints (cache lookup): No authentication required.
- Protected endpoints (contribute, server-translate, refresh): Require API key.
- API keys: Obtain from https://ezcto.fun/api-keys after login.
- Login methods: Google OAuth, Web3 wallet (BNB Chain via WalletConnect).

## Pricing
- Cache reads: Free, unlimited.
- Contributions: Free (earn reputation).
- Server-side parsing: Free tier (50/day), Basic (500/day), Pro (5000/day).

## Links
- Website: https://ezcto.fun
- Web Reader (Try it): https://ezcto.fun/web-reader
- Generator: https://ezcto.fun/generator
- API Keys: https://ezcto.fun/api-keys
- Skill on ClawHub: https://clawhub.ai/takahashigy/ezcto-smart-web-reader
- GitHub: https://github.com/pearl799/ezcto-web-translator
- Powered by: BNB Chain Agent Ecosystem

## Technical Stack
- Frontend: React 19, Tailwind CSS 4, Vite
- Backend: Express 4, tRPC 11, Drizzle ORM
- Database: TiDB (MySQL-compatible)
- AI: Claude (LLM), NanoBanana (Image Generation)
- Hosting: Cloudflare R2 + Workers (generated sites), Manus (platform)
- Chain: BNB Chain / opBNB

## Contact
- Builder: pearl799
- Project: EZCTO 2.0 — AI Web Engineer Agent