Automated Newsletter Agent Development by Fawuzan IbrahimAutomated Newsletter Agent Development by Fawuzan Ibrahim

Automated Newsletter Agent Development

Fawuzan Ibrahim

Completed work

Software Engineer

Next.js

TypeScript

Artificial Intelligence

📰 Newsletter Agent

This project is a Newsletter Agent that automatically scrapes news articles from various websites, then summarizes them into short, high-quality blurbs ready for email newsletters or blog posts.

Built with:

Firecrawl SDK (for intelligent website crawling and scraping)

Together AI API (for fast and powerful text summarization)

🖼️ Visual Diagram

📈 System Architecture

Here's a simple flowchart of how the agent works:

+--------------------+          +-----------------+          +-------------------+
|   Target Websites   |  --->    | Firecrawl SDK    |  --->    | Together AI API    |
|  (e.g. CNN, BBC)    | Scrape   |   (scraping)     | Extract  | (summarization)    |
+--------------------+          +-----------------+          +-------------------+
                                                                     |
                                                                     v
                                                         +-----------------------+
                                                         |  Summarized News Items  |
                                                         +-----------------------+

How It Works

Scraping News Using Firecrawl SDK, the agent fetches and parses content from target websites. It extracts article titles, body text, and publication dates.

Summarizing Content The raw article text is sent to the Together AI API, which returns a concise, readable summary.

Output The final output is a structured list of summarized articles ready to be sent as a newsletter or used elsewhere.

🛠️ Tech Stack

Firecrawl SDK – Smart web scraper that understands page layouts.

Together AI API – Advanced language model for summarization tasks.

Nextjs – To orchestrate the workflow.

📦 Installation

# Clone the repo
git clone https://github.com/fawuzantech/newsletter-agent.git
cd newsletter-agent
# Install dependencies
npm install firecrawl-sdk together

Set your API keys (Firecrawl and Together AI) in an .env file:

FIRECRAWL_API_KEY=your_firecrawl_api_key
TOGETHER_API_KEY=your_together_api_key

🧩 Example Usage

from firecrawl import Firecrawl
from together import TogetherAI

# Initialize clients
scraper = Firecrawl(api_key="your_firecrawl_api_key")
summarizer = TogetherAI(api_key="your_together_api_key")

# Scrape a news article
article = scraper.scrape_url("https://www.example.com/news-story")

# Summarize the article
summary = summarizer.summarize(article['content'])
print(summary)