EvoWeb.ai Website Builder

---
name: EvoWeb.ai AI Website Builder
description: Create a Website in 4 Minutes Designed to Bring Clients from ChatGPT, Gemini & Modern Search
homepage: https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0
metadata: {"clawdbot":{"emoji":"🌐","requires":{"bins":[],"env":["EVOWEB_API_KEY"]}}}
---

# EvoWeb Website Builder

Create complete websites from text descriptions using AI-powered generation.

## Overview

EvoWeb automatically generates modern, responsive websites from natural language prompts. Simply describe what you want, and the AI creates HTML, CSS, JavaScript, and content - delivering a complete, live website in ~4 minutes.

**Perfect for:** Landing pages and business websites

**API Base URL:** `https://api.evoweb.ai/openapi/api/v1`

## Authentication

Get your API key at https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0

**Important:** After registration, user MUST confirm the email address (this is required). The service won't work until email confirmation is complete.

### No API Key Yet?

If the user doesn't have an API key, you can still help them create a website:
1. Ask for a brief description of their website (max 250 characters)
2. Create a registration link with the prompt, given in step 1
3. User can create an account after clicking "Create Website" button

See "Step 0: Handle Users Without API Key" in the instructions below.

Include this header in all requests:
```
Access-Token: your-api-key-here
```

## How It Works

The workflow is simple:

1. **Create** - Submit a text prompt describing your website
2. **Poll** - Check generation status every minute
3. **Get Result** - Receive live URL and editor link when ready

Typical generation time: **4-5 minutes**

## API Endpoints

### 1. Create Website

**POST** `/sites`

Creates a new website generation task from a text description.

**Request Body:**
```json
{
  "prompt": "A local coffee shop specializing in artisanal coffee and fresh pastries. We source our beans locally and focus on creating a cozy community gathering space for local residents, remote workers, and coffee enthusiasts."
}
```

**Response (200 OK):**
```json
{
  "site_id": "abc123xyz",
  "status": "queued"
}
```

**Status values:**
- `queued` - Task is in queue, waiting to start
- `building` - Website is being generated

**Error Responses:**
- `401 Unauthorized` - Invalid or missing API key
- `402 Payment Required` - Insufficient credits on account

---

### 2. Check Generation Status

**GET** `/sites/{site_id}`

Check the current status of website generation.

**Example:** `GET /sites/abc123xyz`

**Response when building:**
```json
{
  "status": "building"
}
```

**Response when ready:**
```json
{
  "status": "ready",
  "url": "https://website.page/my-site",
  "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}
```

**Response when failed:**
```json
{
  "status": "failed",
  "error": "Generation failed: Invalid prompt structure"
}
```

**Status values:**
- `queued` - Waiting in queue
- `building` - Currently generating (be patient!)
- `ready` - Complete! URLs are available
- `failed` - Generation encountered an error

**Error Responses:**
- `404 Not Found` - Site ID doesn't exist

---

### 3. Retry Failed Generation

**POST** `/sites/{site_id}/remake`

Restart generation for a failed website. Works for sites with `failed` status as well as with 'ready' status.

**Example:** `POST /sites/abc123xyz/remake`

**Response (200 OK):**
```json
{
  "status": "queued",
  "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}
```

**Error Responses:**
- `400 Bad Request` - Can only remake sites with 'failed' status
- `404 Not Found` - Site ID doesn't exist

## Instructions for AI Assistant

When a user requests a website, follow this workflow:

### Step 0: Handle Users Without API Key

**Check first:** Does the user have the `EVOWEB_API_KEY` environment variable set?

If **NO API key is available:**

1. **Collect a brief prompt** (max 250 characters) that describes their website:
   - Ask them to briefly describe their business/project
   - Keep it concise and focused on the core business essence
   
2. **Create a pre-filled registration link:**
   - Base URL: `https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0`
   - Add parameter: `&prompt=[URL_ENCODED_PROMPT]`
   - Example: `https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0&prompt=A%20local%20coffee%20shop%20specializing%20in%20artisanal%20coffee`

3. **Provide the link to the user:**
   ```
   🌐 To create your website, visit this link:
   [Your personalized link here]
   
   After clicking "Create Website" button, you'll be able to create an account and your website will be generated automatically!
   ```

**Important:** URL-encode the prompt properly (spaces become `%20`, etc.)

If **API key is available:** Proceed to Step 1 below.

### Step 1: Understand the Business

Focus on understanding the **business essence** from the user's description:
- What is the business/project about?
- What does it do or offer?
- Who is the target audience?
- What is the main goal of the website?

**Important:** Do NOT prescribe specific design details, sections, colors, or layout. The EvoWeb AI will handle all design and structure decisions automatically.

**Example transformation:**
- User: "Create a website for my yoga studio"
- Enhanced prompt: "A yoga studio offering various classes for different skill levels, focused on wellness and mindfulness. Target audience is local community members interested in fitness and mental health."

### Step 2: Create the Site

Call `POST /sites` with the enhanced prompt.

Store the returned `site_id` - you'll need it for status checks.

### Step 3: Inform the User

Tell them:
- Website generation has started
- It will take approximately 4 minutes
- You'll check progress automatically (ONLY IF YOU CAN)

Example: "✨ Creating your website now! Generation typically takes 3-5 minutes. I'll check the status and let you know when it's ready."

### Step 4: Poll for Status

Call `GET /sites/{site_id}` to check progress:

- **Polling interval:** Every 1 minute
- **Maximum attempts:** 20 polls
- **Between polls:** You can inform user of progress ("Still building...")

Continue polling until:
- Status is `ready` → Proceed to Step 5
- Status is `failed` → Proceed to Step 6
- Max attempts reached → Inform user generation is taking longer than expected

### Step 5: Deliver Success

When status is `ready`:

1. **Provide URLs:**
   - `url` - The live website
   - `editor_url` - Link to customize the site

2. **Suggest improvements:**
   Offer 3 specific ways to enhance the site:
   - "Add an online booking system"
   - "Customize colors to match your brand"
   - "Add customer testimonial section"

3. **Be concise and actionable**

**Example response:**
```
🎉 Your website is ready!

🌐 View it here: https://website.page/yoga-studio-23f4
✏️ Customize it: https://web.evoweb.ai/ui/websites/abc123xyz/update/

Quick improvements you might want:
1. Add online class booking system
2. Integrate your Instagram feed
3. Add a blog section for wellness tips

Would you like help with any of these?
```

### Step 6: Handle Failures

When status is `failed`:

1. **Show the error message** from the API response
2. **Offer to retry:** Ask if they want you to remake the site
3. **If they agree:** Call `POST /sites/{site_id}/remake` and restart polling

**Example response:**
```
❌ Website generation failed: [error message]

Would you like me to try again? I can restart the generation process.
```

If user agrees, call remake endpoint and resume polling from Step 4.

## Example Prompts & Use Cases

### Example: User Without API Key

```
User: "I need a website for my yoga studio"

Assistant response:
"I'd be happy to help! To get started quickly, let me create a personalized link for you.

🌐 Visit this link