rss-feedmonitor/README.md

129 lines
4.6 KiB
Markdown

# Canadian Repair Lead Monitor
**Canadian-First Strategy:** Monitor local Canadian communities for repair opportunities before global subreddits. Focus on where your customers actually live and seek local repair services.
## ⚠️ START HERE
**🎯 Canadian Communities First - NOT Global Subreddits**
**Why Canadian-First?** Global subreddits dilute local repair opportunities with international discussions. Target Canadian users seeking local repair services in their own communities.
**Key Features:**
- **Canadian Priority**: 15+ major Canadian cities (Toronto, Vancouver, Calgary, Montreal, etc.)
- **Search RSS Feeds**: Targeted keyword searches within Canadian subreddits
- **Local Focus**: Users seeking local repair shops and services
- **Conversation Tracking**: Subscribe to repair-related thread discussions
## 📁 Files
### RSS Generation System ✨ **START HERE**
- **`scripts/generate_modular_rss_feeds.py`** - Generate fresh RSS feeds from source files
- **`data/repair_keywords.json`** - Source file: All repair keywords/keyphrases
- **`data/canadian_subreddits.json`** - Source file: Canadian subreddits with metadata
- **Latest Output:** [feeds/rss_feeds_20260119_135812.md](feeds/rss_feeds_20260119_135812.md) + [OPML](feeds/rss_feeds_20260119_135812.opml)
### Core Resources
- **`docs/canadian-subreddits.md`** - Complete list of Canadian cities/provinces
- **`docs/canadian-repair-searches.md`** - Keyword search strategies and RSS URL templates
- **`feeds/rss-feeds.json`** - Your active Canadian search RSS feeds
### Documentation
- `docs/WORKFLOW.md` - Canadian-first strategy and implementation steps
- `docs/QUICK_CREATE_GUIDE.md` - Fast reference for creating search RSS feeds
- `README.md` - This overview
### Legacy Files
- `data/remaining_queries.txt` - Old reference (being phased out)
## 🚀 Quick Start
### Canadian-First Setup
1. **Choose 2-3 Canadian cities** to start with (see `canadian-subreddits.md`)
2. **Create keyword search RSS feeds** using templates in `canadian-repair-searches.md`
3. **Subscribe to feeds** in your RSS reader
4. **Monitor daily** for repair opportunities
5. **Engage in conversations** of relevant threads
### Example Search RSS URLs
```
# Toronto iPhone repairs
https://www.reddit.com/r/toronto/search.rss?q=iPhone+repair+OR+"screen+broken"&sort=new&type=link
# Vancouver laptop repairs
https://www.reddit.com/r/vancouver/search.rss?q=laptop+repair+OR+"won't+turn+on"&sort=new&type=link
# Calgary general repairs
https://www.reddit.com/r/calgary/search.rss?q="looking+for+repair"+OR+"need+repair"&sort=new&type=link
```
## 🏙️ Canadian Communities Covered
### Priority Cities (Start Here)
- **Toronto** (r/toronto) - Highest repair volume ⭐⭐⭐
- **Vancouver** (r/vancouver) - Major metro area ⭐⭐⭐
- **Calgary** (r/calgary) - Large city ⭐⭐
- **Edmonton** (r/edmonton) - Provincial capital ⭐⭐
- **Montreal** (r/montreal) - Quebec's largest ⭐⭐
- **Ottawa** (r/ottawa) - National capital ⭐⭐
### Medium Priority Cities
- **Hamilton, Kitchener, London** (Ontario)
- **Victoria, Kelowna** (BC)
- **Winnipeg, Saskatoon** (Prairies)
- **Quebec City** (Quebec)
- **Halifax** (Atlantic)
### Provincial Communities
- **r/Ontario** - Province-wide discussions
- **r/BritishColumbia** - BC-wide discussions
- **r/Alberta** - Alberta-wide discussions
- **r/Quebec** - Quebec-wide discussions
## 🔍 RSS Feed Types
### Search RSS Feeds (Primary Method)
Target repair keywords within Canadian subreddits:
```
https://www.reddit.com/r/[subreddit]/search.rss?q=[keywords]&sort=new&type=link
```
**Examples:**
- Toronto iPhone repairs: `q=iPhone+repair+OR+"screen+broken"`
- Vancouver laptops: `q=laptop+repair+OR+"won't+turn+on"`
- General repairs: `q="looking+for+repair"+OR+"need+repair"`
### Standard Subreddit RSS (Supplemental)
Full subreddit feeds (use sparingly to avoid overload):
```
https://www.reddit.com/r/[subreddit]/new/.rss
```
**Feed options:**
- `new/.rss` - Latest posts
- `hot/.rss` - Popular/trending posts
## Troubleshooting
**RSS feed not loading?**
1. Verify the subreddit name is correct
2. Check if the subreddit is private or restricted
3. Try accessing the subreddit directly in a browser first
4. Some subreddits may have RSS disabled
**Too many/few results?**
1. Consider using `hot/.rss` instead of `new/.rss` for higher quality posts
2. Monitor multiple related subreddits for better coverage
3. Focus on regional subreddits for local repair opportunities
## Technical Notes
- Reddit RSS feeds update in real-time
- Feeds include post titles, content, and metadata
- No API keys or authentication required
- Feeds are free and publicly accessible
- Monitor feed activity to identify active repair communities