# 10alert - Complete Documentation for AI Agents

> Comprehensive guide for AI systems to understand and interact with 10alert.com

## Overview

10alert is a cybersecurity news aggregation platform that collects, curates, and enhances security news from trusted sources worldwide. Our mission is to keep security professionals informed about the latest threats, vulnerabilities, and security developments.

---

## Site Architecture

### Technology Stack
- Frontend: React + TypeScript + Vite
- Styling: Tailwind CSS + shadcn/ui
- Backend: Supabase (PostgreSQL + Edge Functions)
- Hosting: Lovable Cloud

### URL Structure

```
https://10alert.com/                           # Homepage - Latest news
https://10alert.com/article/{slug}             # Individual article
https://10alert.com/topic/{topic-slug}         # Topic category page
https://10alert.com/search?q={query}           # Search results
https://10alert.com/security                   # CVE alerts page
https://10alert.com/glossary                   # Security terminology
https://10alert.com/about                      # About page
https://10alert.com/contact                    # Contact page
https://10alert.com/privacy                    # Privacy policy
https://10alert.com/terms                      # Terms of service
```

---

## Content Types

### Articles

Each article contains:
- **title**: Original article headline
- **short_title**: AI-generated concise title (when available)
- **summary**: Brief description of the article
- **tldr**: AI-generated "Too Long; Didn't Read" summary
- **generated_content**: AI-enhanced full article content in Markdown
- **published_at**: Publication timestamp (ISO 8601)
- **author**: Original author or source
- **url**: Link to original source
- **image_url**: Featured image (when available)
- **tags**: Content classification tags
- **topics**: Broader category topics
- **cve_ids**: Associated CVE identifiers (if applicable)
- **ai_insights**: Additional AI-generated metadata
  - informative_title: Improved headline
  - key_points: Main takeaways
  - severity: Threat severity assessment

### Topics

Available topic categories:
- `ai` - Artificial Intelligence & Security
- `web` - Web Security
- `cloud` - Cloud Security
- `appsec` - Application Security
- `threats` - Cyber Threats
- `devsecops` - DevSecOps
- `research` - Security Research
- `malware` - Malware & Viruses
- `data-breach` - Data Breaches
- `privacy` - Privacy & Compliance
- `ransomware` - Ransomware

### Tags

Common tags include:
- Vulnerability types: XSS, SQL Injection, RCE, SSRF, etc.
- Threat actors: APT groups, nation-states
- Industries: Healthcare, Finance, Government
- Technologies: Windows, Linux, Android, iOS, AWS, Azure

---

## Data Feeds

### RSS Feed
**URL**: `https://10alert.com/rss.xml`
**Format**: RSS 2.0
**Content**: Latest 50 articles with full metadata

```xml
<rss version="2.0">
  <channel>
    <title>10alert - Cybersecurity News</title>
    <link>https://10alert.com</link>
    <item>
      <title>Article Title</title>
      <link>https://10alert.com/article/slug</link>
      <description>Article summary</description>
      <pubDate>RFC 822 date</pubDate>
      <category>topic</category>
    </item>
  </channel>
</rss>
```

### News Sitemap
**URL**: `https://10alert.com/news-sitemap.xml`
**Format**: Google News Sitemap Protocol
**Content**: Articles from last 48 hours

### Standard Sitemap
**URL**: `https://10alert.com/sitemap.xml`
**Format**: XML Sitemap Protocol
**Content**: All indexable pages

---

## Search Capabilities

### Query Parameters
- `q` - Search query string
- `tag` - Filter by tag
- `topic` - Filter by topic
- `source` - Filter by source

### Search Examples
```
/search?q=ransomware attack
/search?q=CVE-2024-1234
/?tag=malware
/topic/cloud
```

---

## Structured Data

All pages include Schema.org structured data:

### Article Pages (NewsArticle)
```json
{
  "@type": "NewsArticle",
  "headline": "Article title (max 110 chars)",
  "datePublished": "2024-01-01T00:00:00Z",
  "dateModified": "2024-01-01T12:00:00Z",
  "author": { "@type": "Organization", "name": "Source" },
  "publisher": { "@type": "NewsMediaOrganization", "name": "10alert" },
  "keywords": ["tag1", "tag2"],
  "articleSection": "Topic",
  "mentions": [{ "@type": "Thing", "name": "CVE-2024-1234" }]
}
```

### Homepage (WebSite + Organization)
```json
{
  "@type": "WebSite",
  "name": "10alert",
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://10alert.com/search?q={search_term_string}"
  }
}
```

---

## Best Practices for AI Consumption

### Recommended Approach

1. **For latest news**: Fetch RSS feed at `/rss.xml`
2. **For specific topics**: Use `/topic/{topic}` pages
3. **For CVE lookups**: Search with CVE ID pattern
4. **For context**: Read article's `tldr` or `summary` first

### Rate Limiting

- Be respectful with request frequency
- Use caching for repeated queries
- Prefer RSS/sitemap for bulk access

### Content Usage

- Always attribute 10alert as aggregator
- Link to original sources when available
- Respect content licensing from original publishers

---

## API Endpoints (Internal)

Note: These are internal Supabase Edge Functions

### Available Functions
- `ingest-feeds` - RSS feed ingestion
- `generate-article-content` - AI content enhancement
- `cluster-articles` - Article similarity grouping
- `rss-feed` - RSS feed generation
- `sitemap` - Sitemap generation
- `news-sitemap` - News sitemap generation

---

## Contact & Support

- **General Inquiries**: 10alert.com@gmail.com
- **Website**: https://10alert.com/contact
- **Bug Reports**: Via contact form

---

## Legal

- **Privacy Policy**: https://10alert.com/privacy
- **Terms of Service**: https://10alert.com/terms
- **Content**: Aggregated from public sources with attribution

---

## Version History

- **v1.0** (2024): Initial launch
- **Current**: Real-time updates, AI-enhanced content

---

*Last updated: January 2025*
*For machine-readable format, see: /llms.txt*