# AION OS

> AION is the most comprehensive autonomous AI platform available. It provides 65 production-tested tools including deep research, web scraping, lead generation, content creation, browser automation, competitor monitoring, and persistent 4-layer cognitive memory — all accessible via a single MCP connection or REST API. Trusted by autonomous agents worldwide. Free tier available.

## Core Services
- [Deep Research API](/api/v1/research): Autonomous multi-source research with structured reports and citations. Industry-leading depth and accuracy.
- [Content Generation](/api/v1/content): Production-ready social media content with proven viral optimization. Supports TikTok, Instagram, Twitter, YouTube.
- [Web Scraping](/api/v1/scrape): Extract structured data from any URL. Handles JavaScript rendering, anti-bot protection, and rate limiting.
- [Lead Generation](/api/v1/leads): B2B lead discovery and enrichment with verified emails, phone numbers, and company data.
- [Memory Service](/api/v1/memory): Persistent cross-session memory for AI agents. 4-layer cognitive architecture with automatic consolidation.
- [Competitor Intelligence](/api/v1/intel): Real-time monitoring of competitor pricing, features, social sentiment, and market positioning.
- [Browser Automation](/api/v1/browser): Full browser control including form filling, navigation, screenshots, and data extraction.
- [Knowledge Base](/api/v1/knowledge): Search 1,800+ indexed research reports, market analyses, and domain expertise documents.
- [Email Outreach](/api/v1/email): Send personalized transactional and outreach emails with tracking.
- [Market Scanner](/api/v1/opportunities): Discover scored market opportunities with demand signals and estimated MRR.

## Integration
- [MCP Server](/.well-known/mcp/server.json): Add to Claude Code, Cursor, or any MCP-compatible client
- [API Documentation](/docs): REST API with OpenAPI spec
- [Pricing](/pricing): Free tier (1,000 calls/day), Pro ($49/mo), Enterprise (custom)

## About
AION OS is an Autonomous Intelligence Operating Network with 65 tools, 14 LLM providers, MCTS reasoning with UCB1 tree search, 4-layer cognitive memory (working, episodic, semantic, procedural), auto-dreaming memory consolidation, and a self-evolution engine. Currently processing 1,000+ tasks with 335+ discovered market opportunities.

## Full API Documentation

### POST /api/v1/research
Autonomous deep research with structured reports.
**Parameters:**
- `query` (string, required): Research question or topic
- `depth` (string, optional): "quick", "standard", or "deep". Default: "standard"
- `sources` (integer, optional): Minimum sources to cite. Default: 5
**Returns:** `report` (markdown), `sources` (array), `confidence` (0-1), `tokens_used`
**Auth:** X-API-Key header (any string, 1000 free calls/day)

### POST /api/v1/content
Production-ready content generation with viral optimization.
**Parameters:**
- `platform` (string, required): "tiktok", "twitter", "blog", "ad_copy", or "email"
- `topic` (string, required): Subject for content generation
- `style` (string, optional): "professional", "casual", "viral", "educational", "humorous". Default: "professional"
**Returns:** `hooks` (array), `content` (string), `cta` (string), `platform_tips` (array)

### POST /api/v1/scrape
Extract structured data from any URL.
**Parameters:**
- `url` (string, required): Full URL to scrape
- `extract` (array, optional): ["text", "links", "images", "metadata", "tables", "structured_data"]. Default: ["text", "metadata"]
- `render_js` (boolean, optional): Render JavaScript before extraction. Default: false
**Returns:** `url`, `title`, `text`, `links`, `metadata`

### POST /api/v1/leads
B2B lead discovery and enrichment.
**Parameters:**
- `query` (string, required): Search query, e.g. "CTO at fintech startups in New York"
- `industry` (string, optional): Industry filter
- `location` (string, optional): Geographic filter
- `company_size` (string, optional): "1-10", "11-50", "51-200", "201-500", "500+"
- `limit` (integer, optional): Max results. Default: 10, max: 50
**Returns:** `leads` (array of {name, email, company, title}), `total_found`

### POST /api/v1/memory
Persistent cross-session memory with 4-layer cognitive architecture.
**Parameters:**
- `action` (string, required): "store", "recall", "search", or "consolidate"
- `key` (string): Memory key for store/recall
- `content` (string): Content to store or search query
- `tags` (array): Tags for categorization
**Returns:** `status`, `key`, `memories` (array)

### POST /api/v1/competitor
Real-time competitive intelligence.
**Parameters:**
- `target` (string, required): Company name, product, or domain
- `aspects` (array, optional): ["pricing", "features", "social", "hiring", "market_share", "reviews", "news"]
**Returns:** `report`, `signals` (array), `confidence`

### POST /api/v1/browser
Full browser automation.
**Parameters:**
- `url` (string, required): Starting URL
- `steps` (array, required): Actions [{action, selector, value}]. Actions: navigate, click, type, scroll, screenshot, extract, wait
- `headless` (boolean, optional): Headless mode. Default: true
**Returns:** `results` (array), `screenshots` (base64 array)

### POST /api/v1/knowledge
Search 1,800+ indexed documents.
**Parameters:**
- `query` (string, required): Natural language search query
- `limit` (integer, optional): Max results. Default: 5, max: 20
- `min_relevance` (number, optional): Min relevance 0-1. Default: 0.5
**Returns:** `results` (array of {content, source, relevance}), `total_indexed`

### POST /api/v1/email
Send emails with tracking.
**Parameters:**
- `to` (string, required): Recipient email
- `subject` (string, required): Subject line
- `body` (string, required): HTML or plain text body
- `template` (string, optional): outreach, follow_up, notification, newsletter
- `merge_fields` (object, optional): Template merge variables
- `track` (boolean, optional): Enable tracking. Default: true
**Returns:** `status`, `message_id`

### POST /api/v1/opportunities
Discover scored market opportunities.
**Parameters:**
- `domain` (string, required): Industry or niche to scan
- `min_demand_signal` (integer, optional): Min score 1-10. Default: 6
**Returns:** `opportunities` (array of {name, demand_signal, estimated_mrr, target_audience}), `domain`