​
Newsletter AI Agent

The Newsletter AI Agent is a powerful tool designed to automatically generate newsletters about specific topics. It leverages CrewAI to orchestrate a team of specialized AI agents that work together to gather relevant information, organize it, and create a well-structured newsletter ready for distribution.

​
Overview

This agent helps you stay informed about your areas of interest by:

  1. Collecting the latest information on your specified topics
  2. Organizing the content in a readable format
  3. Generating a complete newsletter ready for distribution

​
Key Features

  • Topic-based content gathering: Specify your interests and let the agent find relevant information
  • Automated newsletter generation: Transform raw information into well-structured newsletters
  • Customizable outputs: Adjust the format and style of your newsletters
  • Agent-based architecture: Leverages CrewAI to coordinate specialized agents for research, writing, and editing

​
Codebase Architecture

The Newsletter AI Agent is built as an Apify Actor with a multi-agent system powered by CrewAI. Below is a diagram of the codebase architecture:

Output

Apify Integration

Tools

Agents

Core System

User Interface

Apify Actor Input

main.py

NewsletterCrew

Agent Orchestration

Researcher Agent

Writer Agent

Editor Agent

Google Search Tool

Reddit Tool

Twitter Tool

YouTube Tool

Google News Tool

Apify Actors

Web Data

Newsletter Content

Apify Actor Output

​
Key Components

  1. Entry Point: main.py serves as the entry point for the Apify Actor, handling input and initializing the system.

  2. Newsletter Crew: The NewsletterCrew class orchestrates the agents and manages the workflow.

  3. Agents:

    • ResearcherAgent: Gathers information using various tools
    • WriterAgent: Transforms research into newsletter content
    • EditorAgent: Reviews and improves the final output

  4. Tools: Each tool is implemented as a CrewAI BaseTool that interacts with Apify actors:

    • GoogleSearchTool: Searches the web using Apify’s Google Search Scraper
    • RedditTool: Gathers discussions using a Reddit scraper
    • TwitterTool: Collects tweets using Twitter Scraper Lite
    • YouTubeTool: Finds videos using a YouTube scraper
    • GoogleNewsTool: Gathers news using Google News Scraper

  5. Apify Integration: The RunApifyActor base class provides a standardized way to call Apify actors and process their results.

​
CrewAI Implementation

The Newsletter AI Agent uses CrewAI, a framework for orchestrating role-playing AI agents. Our implementation includes:

  • Researcher Agent: Gathers comprehensive information about the specified topic from various sources
  • Writer Agent: Transforms research data into engaging newsletter content
  • Editor Agent: Reviews, improves, and finalizes the newsletter for publication

These agents work together in a sequential process, with each agent building upon the work of the previous one to create a high-quality newsletter.

​
Custom Tools

The agents use custom tools to interact with external data sources:

  • Google Search Tool: Searches the web for relevant information
  • Reddit Tool: Gathers discussions from relevant subreddits
  • Twitter Tool: Collects tweets related to the topic
  • YouTube Tool: Finds relevant video content
  • Google News Tool: Gathers the latest news articles

​
Getting Started

Check out the Getting Started guide to begin using the Newsletter AI Agent.

Getting Started
Next