# AI-READABLE DATA ACCESS

## Complete Website Data for AI Consumption

This website provides **comprehensive AI-readable access** to ALL content, data, and calculations through structured JSON API endpoints. Nothing is hidden - every metric, every string, every calculation is available.

### Quick Access

**Static File (Recommended):** `https://worldvc.tech/ai-data.json`  
**API Endpoint - Full:** `https://worldvc.tech/api/data`  
**API Endpoint - Summary:** `https://worldvc.tech/api/summary`  

> **Important for AI:** The fastest way to access all data is via the static JSON file at `/ai-data.json`. This contains the complete dataset without serverless function overhead.

> **Direct Access:** AI assistants can directly fetch `https://worldvc.tech/ai-data.json` without authentication. The file contains ~73KB of structured JSON data.

### What's Included

✅ **All 37 countries** with complete metrics  
✅ **Every calculation** with formulas explained  
✅ **All text content** (headings, labels, descriptions)  
✅ **Global statistics** and aggregations  
✅ **Regional breakdowns** (North America, Europe, Asia, Oceania, South America)  
✅ **Ecosystem health classifications** (6 bands)  
✅ **Cost efficiency analysis** (vs USA baseline)  
✅ **Investment gap analysis** (how much each country needs)  
✅ **PPP adjustments** (real purchasing power)  
✅ **Human-readable interpretations** for all metrics  

### Key Metrics Per Country

**Nominal VC (Phase 1):**
- Total VC invested, Population, VC per capita
- Nominal GDP, GDP per capita
- VC as % of GDP, Equivalent people

**Startup Unit Costs (Phase 2):**
- Startup unit cost breakdown
- Personnel costs (developers, managers)
- Global hard costs, Local leveraged costs
- Cost vs USA ratio

**PPP-Adjusted (Phase 3):**
- PPP-adjusted VC and GDP
- PPP VC as % of GDP (PPP)
- GDP per capita (PPP)
- PPP equivalent people

**Efficiency Metrics:**
- Startup units per million people
- Total startup units
- Comparison to US baseline (%)
- Investment gap and multiplier needed
- Additional VC required

**Interpretations:**
- Cost efficiency explanation
- vs US baseline explanation
- Ecosystem health status
- Investment gap analysis

### Complete Formulas

All calculation formulas are included:

**Phase 1:**
```
VC per Capita = Total VC / Population
VC % of GDP = Total VC / Nominal GDP
Equivalent People = Total VC / GDP per Capita
```

**Phase 2:**
```
Personnel Cost = (6 × Senior Dev) + (4 × General Staff Avg)
Startup Unit Cost = Personnel + $45K Global + (0.20 × Personnel) Local
PPP-Adjusted VC = VC_nom × (SU_USA / SU_local)
```

**Phase 3:**
```
Units per million = (VC_ppp / GDP per capita_PPP) × 1,000,000
Comparison to US % = (Country units / US units) × 100
```

### Global Statistics

- Total countries: 37
- Total VC tracked: $415B
- Countries exceeding US: 7
- Countries behind US: 30
- Highest efficiency: Estonia at 748% of US
- Cheapest startups: India at 6.58× vs USA
- Health band distribution across all 6 levels

### Regions

**North America:** USA, Canada, Mexico  
**Europe:** 19 countries (Switzerland to Romania)  
**Asia:** 8 countries (Singapore, China, Japan, India, etc.)  
**Oceania:** Australia  
**South America:** Brazil  

Each region includes aggregate statistics.

### Ecosystem Health Bands

1. **Underfunded** (< 0.10%): Minimal activity
2. **Developing** (0.10-0.20%): Emerging activity
3. **Healthy** (0.20-0.50%): Sustainable activity ⭐
4. **High** (0.50-0.80%): Very strong
5. **Very High** (0.80-1.20%): Exceptional
6. **Extreme Outlier** (> 1.20%): Outsized ecosystem

⭐ 40% of countries fall in the "Healthy" range, suggesting natural equilibrium.

### Key Findings

- **Estonia leads globally** at 748% of US startup intensity
- **7 of 32 countries** exceed US baseline
- **130× variance** in startup density across countries
- **India offers 6.58× cost advantage** vs USA for startups
- **$1M in India** buys ~6× more startup capacity than in USA

### API Usage

```javascript
// Get everything
const data = await fetch('/api/data').then(r => r.json());

// Get summary
const summary = await fetch('/api/summary').then(r => r.json());

// Access any country
const estonia = data.countriesData.find(c => c.country === 'Estonia');
console.log(estonia.comparisonToUsPercent); // 748

// Access formulas
console.log(data.formulas.phase3.unitsPerMillion);

// Access all website text
console.log(data.allStrings.headings);
console.log(data.allStrings.descriptions);
```

### Documentation

- **AI_DATA_README.md** - Complete documentation
- **api/README.md** - API endpoint details
- **generate-ai-readable.cjs** - Generation script

### Regeneration

```bash
npm run generate-ai-data
```

---

**This API provides complete, unrestricted access to the entire website for AI analysis. Every metric, every string, every calculation is included in structured JSON format.**