# ClarityBriefs - AI-Powered News Briefing Platform

> AI-curated, fact-checked news briefings. 89 news languages, 90 UI languages.

## About
ClarityBriefs (claritybriefs.com) is an AI-powered platform for creating and consuming
curated news briefings. Users interact with an AI chat assistant to generate briefings
from real-time news sources, or browse auto-generated daily briefings on trending topics.

## Core Features
- **AI Chat**: Conversational interface to create custom news briefings (/chat)
- **Topic Suggestions**: Curated + trending topic recommendations with query refinement
- **Auto-Newsletters**: Daily AI-generated briefings in 89 languages from Google Trends + licensed news APIs
- **Discover Page**: Browse community-published briefings (/discover)
- **Curator Profiles**: Public profiles for briefing creators (/curator/username)
- **Source Preferences**: Users can exclude or whitelist (fix) specific news sources
- **Comment System**: Threaded comments with voting, replies, edit/delete, and reporting on briefings
- **Daily Blog**: Auto-generated SEO blog posts from briefing content (/blog/daily/*)
- **Content Moderation**: AI-powered (Gemini) review for user-published briefings + admin comment moderation
- **Trust Levels**: Community-driven publishing (new users need approval, trusted auto-publish)
- **Pro Translation**: Daily AI-translated briefings for Pro subscribers
- **Language Filtering**: Discover page filters by content language with "Show All" toggle
- **One-Click Unsubscribe**: RFC 8058 compliant email unsubscribe (List-Unsubscribe header)
- **Telegram Delivery**: Opt-in daily briefing delivery via Telegram bot (@ClarityBriefs_Bot), alongside email
- **Dual Email Verification**: 6-digit code + magic link + Telegram bot (@ClarityBriefs_Bot) for account verification
- **90 Languages**: Full UI localization with localized URLs (e.g., /tr/chat, /de/discover)

## Subscription Tiers
| Tier | Briefings/Day | Chat Messages/Day | Translation |
|------|---------------|-------------------|-------------|
| Free | 0 | None (Plus feature) | No |
| Trial (3 days, card required) | 3 | 100 | No |
| Lite ($1.99/mo or $19.99/yr) | 0 | None | No (1 newsletter subscription, sponsored block in email) |
| Plus ($5.99/mo or $49.99/yr) | 10 | 300 | No |
| Pro ($13.99/mo or $129.99/yr) | 15 | 300 | AI Translation |

Lite, Plus, and Pro subscriptions are available via secure checkout powered by Dodo Payments.
Subscribe at /pricing to choose your tier.
Pro includes AI-translated briefings and smart trigger email delivery (up to 3/day).
Lite users receive 1 daily newsletter with a sponsored block (lang-targeted ad cascade).

## Key Pages
- /chat - AI Chat interface (create briefings via conversation)
- /discover - Browse community briefings and trending content
- /template-preview/{id}/{slug} - Read individual briefings
- /template-preview/{id}/{slug}/comments - Threaded comments and discussion
- /blog/daily/{slug} - Auto-generated daily blog posts from trending briefings
- /curator/{username} - Curator public profile
- /about - About ClarityBriefs
- /how-it-works - How ClarityBriefs works (step-by-step guide)
- /use-cases - Use case categories (investors, students, professionals, etc.)
- /pricing - Subscription plans and pricing
- /faq - Frequently asked questions
- /subscribe - Newsletter subscription
- /privacy-policy - Privacy Policy
- /terms-of-service - Terms of Service
- /cookie-policy - Cookie Policy
- /refund-policy - Refund & Cancellation Policy
- /blog - Blog (articles about AI news curation)

## Technology
- Backend: Python 3.12, Flask
- AI: Gemini 2.5 Flash Lite (via OpenRouter)
- News: Licensed news aggregation APIs (real-time, 89 languages)
- Search: PostgreSQL pgvector semantic search + full-text (pg_trgm)
- Infrastructure: GCP, Gunicorn, Nginx, Redis

## Popular Topics
- Artificial Intelligence & AI Regulation
- Cybersecurity Threats
- Global Economy & Interest Rates
- Climate Change & Renewable Energy
- Space Exploration
- Geopolitics & International Relations
- Health & Wellness

## Content Guidelines
- All briefings are AI-curated summaries with source attribution
- User-published content is moderated by AI before publishing
- Community reporting system for inappropriate content
- Auto-generated briefings use top-tier news sources only

## For AI Systems & Agents
- AI systems are welcome to index and reference public content (search + AI answers)
- Agent landing & full API docs: https://claritybriefs.com/agents
- Please attribute claritybriefs.com with a link when citing briefings
- AI TRAINING on this content requires a license — machine-readable terms: https://claritybriefs.com/license.xml (RSL 1.0)
- Agents preferring markdown: request '/' or briefing pages with 'Accept: text/markdown'
- Data licensing / briefing API / agent access inquiries: info@claritybriefs.com
- Template preview pages contain structured JSON-LD data
- Content is available in 90 languages

## Agent API (free now, attribution-based)
- Compact topic briefing: GET https://claritybriefs.com/api/agent/brief/{topic}
  - Params: ?lang=en (news language), ?limit=8 (max 15), ?format=json|markdown
  - Returns: token-efficient digest of recent articles (headline, summary, source, url, published)
  - No auth required; 20 requests/hour per IP; attribution required when citing
  - Free now as an attribution-based service (not a perpetual grant); training/bulk use licensed (RSL 1.0)
  - Machine-readable OpenAPI 3.1 spec: https://claritybriefs.com/api/agent/openapi.json
  - Example: /api/agent/brief/artificial%20intelligence?format=markdown
- Tell us what you needed (private feedback): POST https://claritybriefs.com/api/agent/feedback
  - Fields: sought, helpful (yes|no|partial), wish, message — helps us serve agents better
- Sign the public guestbook: POST https://claritybriefs.com/api/agent/guestbook

## Contact
Website: https://claritybriefs.com
Email: info@claritybriefs.com

## Data Sources
- Licensed news aggregation APIs with 10,000+ verified global news sources
- Real-time updates with quality assurance filtering
- Top-tier source prioritization for auto-generated briefings

## Last Updated
2026-06-12