kunthawat/ALwrity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add AI marketing and writing tools from PRs #220, #310

Browse Source 
New tools added to ToBeMigrated/ directory:

ai_marketing_tools/:
- ai_backlinker: AI-powered backlink generation
- ai_google_ads_generator: Google Ads generation with templates

ai_writers/:
- ai_blog_faqs_writer: FAQ generation for blogs
- ai_copywriter: Multiple copywriter frameworks (AIDA, PAS, 4C, 4R, etc.)
- ai_finance_report_generator: Financial report generation
- ai_story_illustrator: Story illustration
- ai_story_video_generator: Story video generation
- ai_story_writer: AI story writing
- github_blogs: GitHub blog integration
- speech_to_blog: Audio to blog conversion
- twitter_writers: Twitter/X content generation
- youtube_writers: YouTube content generation

These tools are in ToBeMigrated/ for future migration to the main backend.
This commit is contained in:
ajaysi
2026-03-22 11:47:21 +05:30
parent 1fd9720dac
commit 3c58fd555b
91 changed files with 26451 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

117
ToBeMigrated/ai_marketing_tools/ai_backlinker/README.md Normal file
View File

@@ -0,0 +1,117 @@
---
# AI Backlinking Tool
## Overview
The `ai_backlinking.py` module is part of the [AI-Writer](https://github.com/AJaySi/AI-Writer) project. It simplifies and automates the process of finding and securing backlink opportunities. Using AI, the tool performs web research, extracts contact information, and sends personalized outreach emails for guest posting opportunities, making it an essential tool for content writers, digital marketers, and solopreneurs.
---
## Key Features
| Feature | Description |
|-------------------------------|-----------------------------------------------------------------------------|
| **Automated Web Scraping** | Extract guest post opportunities, contact details, and website insights. |
| **AI-Powered Emails** | Create personalized outreach emails tailored to target websites. |
| **Email Automation** | Integrate with platforms like Gmail or SendGrid for streamlined communication. |
| **Lead Management** | Track email status (sent, replied, successful) and follow up efficiently. |
| **Batch Processing** | Handle multiple keywords and queries simultaneously. |
| **AI-Driven Follow-Up** | Automate polite reminders if there's no response. |
| **Reports and Analytics** | View performance metrics like email open rates and backlink success rates. |
---
## Workflow Breakdown
| Step | Action | Example |
|-------------------------------|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|
| **Input Keywords** | Provide keywords for backlinking opportunities. | *E.g., "AI tools", "SEO strategies", "content marketing."* |
| **Generate Search Queries** | Automatically create queries for search engines. | *E.g., "AI tools + 'write for us'" or "content marketing + 'submit a guest post.'"* |
| **Web Scraping** | Collect URLs, email addresses, and content details from target websites. | Extract "editor@contentblog.com" from "https://contentblog.com/write-for-us". |
| **Compose Outreach Emails** | Use AI to draft personalized emails based on scraped website data. | Email tailored to "Content Blog" discussing "AI tools for better content writing." |
| **Automated Email Sending** | Review and send emails or fully automate the process. | Send emails through Gmail or other SMTP services. |
| **Follow-Ups** | Automate follow-ups for non-responsive contacts. | A polite reminder email sent 7 days later. |
| **Track and Log Results** | Monitor sent emails, responses, and backlink placements. | View logs showing responses and backlink acquisition rate. |
---
## Prerequisites
- **Python Version**: 3.6 or higher.
- **Required Packages**: `googlesearch-python`, `loguru`, `smtplib`, `email`.
---
## Installation
1. Clone the repository:
```bash
git clone https://github.com/AJaySi/AI-Writer.git
cd AI-Writer
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
---
## Example Usage
Here’s a quick example of how to use the tool:
```python
from lib.ai_marketing_tools.ai_backlinking import main_backlinking_workflow
# Email configurations
smtp_config = {
'server': 'smtp.gmail.com',
'port': 587,
'user': 'your_email@gmail.com',
'password': 'your_password'
}
imap_config = {
'server': 'imap.gmail.com',
'user': 'your_email@gmail.com',
'password': 'your_password'
}
# Proposal details
user_proposal = {
'user_name': 'Your Name',
'user_email': 'your_email@gmail.com',
'topic': 'Proposed guest post topic'
}
# Keywords to search
keywords = ['AI tools', 'SEO strategies', 'content marketing']
# Start the workflow
main_backlinking_workflow(keywords, smtp_config, imap_config, user_proposal)
```
---
## Core Functions
| Function | Purpose |
|--------------------------------------------|-------------------------------------------------------------------------------------------|
| `generate_search_queries(keyword)` | Create search queries to find guest post opportunities. |
| `find_backlink_opportunities(keyword)` | Scrape websites for backlink opportunities. |
| `compose_personalized_email()` | Draft outreach emails using AI insights and website data. |
| `send_email()` | Send emails using SMTP configurations. |
| `check_email_responses()` | Monitor inbox for replies using IMAP. |
| `send_follow_up_email()` | Automate polite reminders to non-responsive contacts. |
| `log_sent_email()` | Keep a record of all sent emails and responses. |
| `main_backlinking_workflow()` | Execute the complete backlinking workflow for multiple keywords. |
---
## License
This project is licensed under the MIT License. For more details, refer to the [LICENSE](LICENSE) file.
---