Newsly
Newsly is a research desk for news, markets, and Indian instruments. A reader configures a briefing and receives a ranked, source-backed set of stories; asks follow-up questions in a research chat that remembers what it already read; turns that chat into a story they own; and, on Pro, commissions long-form reports on NSE equities, ETFs, and mutual funds. The same research can leave the browser as a scheduled email digest, or as a hosted agent: a versioned HTTPS contract that invokes the identical pipelines without a session cookie.
Every synthesized output is written from scraped article text, YouTube transcripts, exchange market data, or previously stored research — never from search snippets or conversation history alone.
It is a Next.js 16 application with PostgreSQL + pgvector, Prisma 7, Clerk authentication, Inngest durable workflows, SerpAPI, Firecrawl, Upstox market data, Resend email, Razorpay billing, and OpenAI-backed agents.
This document is the primary technical and product documentation for the repository. It describes the system as implemented; partially wired parts are labeled as such. /about is the same architecture told as a product page. Interactive reference for the hosted agents lives at /docs/api.
Table of Contents
Overview
Newsly has several user-facing research modes that share one storage layer. The browser uses Clerk sessions. External programs use hosted agents (the /api/v1 contract) with the same pipelines underneath.
| Mode | What the user does | What the system produces |
|---|
| Briefing | Configures a news request (date, local/world/both scope, location, categories, story count, language, source domains, custom query) | Up to storyCount ranked NewsStory rows, each with NewsSource evidence rows |
| Research chat | Asks a question in a chat session, or opens a deep dive on a public story | An assistant Markdown reply grounded in scraped ResearchSource rows; the session accumulates reusable research |
| Chat → story | Asks the chat to write a story | A private draft NewsStory owned by the user, generated asynchronously from the research the chat already gathered |
| Instrument research | Picks an NSE equity, ETF, or mutual fund and a question (/stockResearch, /etfResearch, /MfResearch) | A Markdown StockResearch report with quote, fundamentals or holdings, news, and a cited answer |
| Newsletter | Schedules a digest (/newsletters) on a daily, weekday, weekly, or monthly cadence | An email, via Resend, of a shared NewsEdition built by the news pipeline |
| Hosted agents | Calls /api/v1 with a Pro API key | The same briefings, reports, stories, instrument search, and newsletters, plus jobs and signed webhooks |
What distinguishes the implementation:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
