# Space News - Complete Documentation
> AI-first RSS news aggregator for SpaceX Starbase and South Texas
> Version: 1.0.0
> Last Updated: 2026-04-08T19:49:21.677Z

## Overview
Space News (https://space.platphormnews.com) is an AI-first news aggregation platform that collects news about SpaceX's Starbase facility and the surrounding South Texas region from public RSS/Atom feeds. The site is part of the platphormnews.com network.

## Mission
To aggregate public RSS feeds about SpaceX and Starbase activities, updated daily via Vercel Cron job at 6 AM UTC, with articles posted to https://mcp.platphormnews.com/.

## Data Sources (14 RSS/Atom feeds)
- SpaceNews: https://spacenews.com/feed/
- NASASpaceflight: https://www.nasaspaceflight.com/feed/
- r/SpaceX: https://www.reddit.com/r/spacex/.rss
- r/Starbase: https://www.reddit.com/r/Starbase/.rss
- Teslarati Space: https://www.teslarati.com/category/spacex/feed/
- Ars Technica Space: https://feeds.arstechnica.com/arstechnica/science
- The Verge - Space: https://www.theverge.com/rss/space/index.xml
- Texas Tribune: https://www.texastribune.org/feeds/latest/
- NASASpaceflight Live: https://www.youtube.com/feeds/videos.xml?channel_id=UCSUu1lih2RifWkKtDOJdsBA
- LabPadre: https://www.youtube.com/feeds/videos.xml?channel_id=UCFwMITSkc1Fms6PoJoh1OUQ
- SpaceX Official: https://www.youtube.com/feeds/videos.xml?channel_id=UCtI0Hodo5o5dUb67FeUjDeA
- Everyday Astronaut: https://www.youtube.com/feeds/videos.xml?channel_id=UC6uKrU_WqJ1R2HMTY3LIx5Q
- Everyday Astronaut Blog: https://everydayastronaut.com/feed/
- Sea Turtle Inc: https://www.seaturtleinc.org/feed/

## Coverage Areas

### Starbase
- Location: 25.9972° N, 97.1551° W
- SpaceX's primary Starship development facility
- Includes launch pads, production facilities, tank farm, and integration bays
- Key activities: Starship/Super Heavy assembly, testing, launches

### Boca Chica State Park
- Texas state park adjacent to Starbase
- Wildlife refuge area
- Beach access managed by Texas Parks & Wildlife
- Access often restricted during testing windows

### South Padre Island
- Barrier island north of Starbase
- Popular tourist destination
- Beach access affected by Starship testing activities
- Key viewing location for launches

### Cameron County
- County government managing Starbase area
- Issues road closures for testing
- Manages permits and infrastructure
- Public notices and official communications

## Data Sources

### X (Twitter)
Accounts monitored:
- @SpaceX - Official SpaceX communications
- @elonmusk - CEO commentary
- @NASASpaceflight - Independent coverage
- @StarbaseWatcher - Local observations
- @BocaChicaGal - Community updates

### YouTube Channels
- NASASpaceflight Live - 24/7 Starbase cam
- LabPadre - Multiple camera angles
- Everyday Astronaut - Educational content
- SpaceX Official - Launch broadcasts

### Facebook Pages
- Cameron County official page
- South Padre Island community
- Brownsville local news

### RSS Feeds
- SpaceNews.com
- Ars Technica (Space)
- NASASpaceflight.com
- SpaceFlightNow.com

## API Reference

### News Feed
```
GET https://space.platphormnews.com/api/v1/news
```
Parameters:
- page (int): Page number, default 1
- limit (int): Items per page, max 100, default 20
- source (string): Filter by source - x, facebook, youtube, rss, or all
- category (string): Filter by location - starbase, boca-chica, south-padre, cameron-county, general, or all
- search (string): Text search in titles and summaries
- sort (string): Sort field - publishedAt, engagement, relevance
- order (string): Sort order - asc, desc

Response:
```json
{
  "success": true,
  "data": [
    {
      "id": "string",
      "title": "string",
      "summary": "string",
      "aiSummary": "string",
      "url": "string",
      "imageUrl": "string",
      "source": "x|facebook|youtube|rss",
      "sourceName": "string",
      "sourceHandle": "string",
      "category": "starbase|boca-chica|south-padre|cameron-county|general",
      "location": "string",
      "tags": ["string"],
      "publishedAt": "ISO8601",
      "isLive": boolean,
      "isVideo": boolean
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "hasMore": true
  }
}
```

### Trending Data
```
GET https://space.platphormnews.com/api/v1/trending
```
Returns trending topics, upcoming events, and active live streams.

### Sources
```
GET https://space.platphormnews.com/api/v1/sources
```
Returns list of all monitored feed sources.

### Health Check
```
GET https://space.platphormnews.com/api/health
```
Returns service health status.

## AI Features

### Automatic Summarization
Every news item is processed through our AI pipeline to generate:
- Concise summaries (50-100 words)
- Key points extraction
- Sentiment analysis

### Topic Classification
AI automatically categorizes content by:
- Location (Starbase, Boca Chica, South Padre, Cameron County)
- Topic (Testing, Launches, Infrastructure, Regulatory, Community)
- Content type (Article, Video, Live, Social)

### Trend Analysis
- Real-time trending topic detection
- Engagement metrics aggregation
- Activity prediction based on patterns

### Conversational AI
Users can ask questions about:
- Recent activities at Starbase
- Upcoming events and road closures
- Historical launch data
- Technical explanations

## Feeds

### RSS 2.0
```
https://space.platphormnews.com/feed.xml
```
- 50 most recent items
- Updates every 15 minutes
- Includes AI summaries
- Media content support

### Atom 1.0
```
https://space.platphormnews.com/atom.xml
```
- Full Atom 1.0 compliance
- Includes categories and tags
- Author attribution

### Sitemap
```
https://space.platphormnews.com/sitemap.xml
```
- All indexed pages
- Updated hourly
- Priority scoring

## Authentication
Public API - no authentication required for read operations.
Rate limited to 100 requests per minute per IP.

## Webhooks
Webhook notifications available for:
- New articles matching criteria
- Live stream start/end
- Road closure announcements
- Launch window updates

Contact news@platphormnews.com for webhook access.

## Data Freshness
- X/Twitter: 5-minute refresh
- YouTube: 15-minute refresh
- Facebook: 30-minute refresh
- RSS feeds: 60-minute refresh
- AI processing: Real-time on ingest

## Legal
- All data sourced from public sources
- Respects robots.txt and rate limits
- No private or paywalled content
- Citations provided for all sources

## Contact
- Website: https://space.platphormnews.com
- Parent: https://platphormnews.com
- Email: news@platphormnews.com
- Support: support@platphormnews.com

## Changelog
- v1.0.0 (2026-03): Initial release with X, YouTube, Facebook, RSS aggregation