# FindNews.ai

> Find news that hasn't been written yet. Every search becomes a sourced, cited, permanent article.

## About

FindNews.ai is a public, permanent, agent-native newspaper. It generates real news articles from real-time web searches using Firecrawl and AI (Claude / Grok). Every article is sourced with inline citations, structured with JSON-LD schema, and designed to be cited by both humans and AI systems.

## Key Features

- Real-time article generation from any news query
- Every claim backed by numbered inline citations to source URLs
- Permanent, SEO-optimized article pages at /answer/{slug}
- Structured data: NewsArticle, FAQPage, BreadcrumbList JSON-LD on every page
- FreshnessBadge showing article age (LIVE / FRESH / AGING / STALE)
- Full REST API for programmatic access
- MCP tool definitions for AI agent integration

## API Endpoints

- **Search**: `POST /api/search` — Real-time article generation. Send `{"query": "your question"}`. Returns streaming SSE with sources, answer text, and article slug.
- **List Articles**: `GET /api/articles` — Returns published articles. Supports `?tag=` filter and `?limit=` param.
- **Get Article**: `GET /api/answer/{slug}` — Full article JSON with content, sources, schema, and metadata.
- **MCP Tools**: `GET /api/mcp/tools` — Tool definitions for AI agents (findnews_search, findnews_get_article, findnews_list_articles).
- **Health**: `GET /api/health` — Service status and secret availability.

## Article Structure

Each article follows a GEO-optimized structure:
1. Headline (H1)
2. TL;DR summary (2-3 sentences, standalone)
3. Key Takeaways (3-5 cited bullet points)
4. Body sections with question-format headings
5. Why This Matters (context and significance)
6. FAQ (3-5 Q&A pairs)
7. Sources (numbered list matching inline citations)

## Schema

Every article page includes:
- `NewsArticle` JSON-LD (headline, dates, author, publisher, citations, wordCount)
- `FAQPage` JSON-LD (when FAQ section is present)
- `BreadcrumbList` JSON-LD (site hierarchy)
- `Organization` JSON-LD (site-wide)

## Sitemap

XML sitemap available at: https://findnews.ai/sitemap.xml

## Contact

- Website: https://findnews.ai
- Email: findnews@pearlstreetventures.com