# ⚡ SAXZ Portal - Quick Start Guide

## 🚀 What's New?

Your SAXZ portal now has **MAXIMUM SCRAPING POWER**:
- 🎯 **200 jobs per country** (upgraded from ~10)
- 🌍 **63 countries** supported worldwide
- 🔥 **12,600 jobs max** in a single search!

---

## 🎮 How to Use

### **1. Main Portal (Homepage)**

**Regular Search:**
1. Go to http://localhost:8000/
2. Enter keyword (e.g., "Software Engineer")
3. Enter location (e.g., "New York")
4. Click "Search"
5. Get **200 jobs from Indeed** + results from other sources

**Access Global Tools:**
- Scroll down to see the purple **"Global Job Search Tools"** section
- Click **"Open Multi-Country Search"** or **"Open Global Search"**

---

### **2. Multi-Country Search** 🌍

**Search Multiple Countries:**
1. Open `multi-country.html`
2. Select **"Multi-Country"** mode
3. Enter countries: `US,UK,CA,AU,DE,FR,JP,SG` (8 countries)
4. Enter keyword: `Data Scientist`
5. Click "Search Jobs"
6. Get **1,600 jobs** (200 × 8 countries)!

**Search ALL Countries:**
1. Select **"All Countries"** mode (🗺️ icon)
2. Enter keyword: `Marketing Manager`
3. Click "Search Jobs"  
4. Get **12,600 jobs** from 63 countries! 🔥

---

### **3. Global Search** 🗺️

**Browse by Category:**
1. Open `global-search.html`
2. Click a category (e.g., **💻 Technology**)
3. Select a country (e.g., **United States**)
4. Choose keyword or enter custom one
5. Click "Search Jobs"
6. Get **200 tech jobs** from US

---

## 📊 Quick Examples

### **Example 1: Find Remote Tech Jobs Globally**
```
Page: multi-country.html
Mode: All Countries
Keyword: "Remote Software Engineer"
Result: 12,600 remote jobs worldwide! 🌍
```

### **Example 2: Healthcare Jobs in Top Markets**
```
Page: multi-country.html
Mode: Multi-Country
Countries: US,UK,CA,AU
Keyword: "Registered Nurse"
Result: 800 nursing jobs from 4 major English-speaking countries
```

### **Example 3: Entry Level Finance**
```
Page: global-search.html
Category: Finance
Country: United States
Keyword: "Financial Analyst - Junior"
Location: New York
Result: 200 entry-level finance jobs in NYC
```

---

## 🎯 Search Modes Explained

| Mode | Best For | Max Jobs | Speed |
|------|----------|----------|-------|
| **Single Country** | Focused local search | 200 | ⚡ Fast (2s) |
| **Multi-Country** | Specific markets | 200 × N | 🚀 Medium (N×1s) |
| **All Countries** | Global market research | 12,600 | 💫 Fast (10s) |
| **Category Search** | Industry-specific | 200 × N | 🚀 Medium (N×1s) |

---

## 📈 Tips for Best Results

### **Keywords**
- ✅ **Good**: "Senior Software Engineer", "Marketing Manager - Digital"
- ❌ **Too Broad**: "Jobs", "Work"
- ✅ **Use job titles** not company names

### **Countries**
- Format: Two-letter codes (US, UK, etc.)
- Separate with commas: `US,UK,AU,CA`
- Max recommended for fast results: 10-15 countries
- All Countries mode: All 63 at once!

### **Locations**
- Use city names: "New York", "London", "Sydney"
- Optional but improves relevance
- Works best for single-country searches

---

## 🌍 Supported Countries (Quick Reference)

### **Popular Markets**
- 🇺🇸 **US** - United States (us.indeed.com)
- 🇬🇧 **UK** - United Kingdom (uk.indeed.com)
- 🇨🇦 **CA** - Canada (ca.indeed.com)
- 🇦🇺 **AU** - Australia (au.indeed.com)
- 🇩🇪 **DE** - Germany (de.indeed.com)
- 🇫🇷 **FR** - France (fr.indeed.com)
- 🇯🇵 **JP** - Japan (jp.indeed.com)
- 🇸🇬 **SG** - Singapore (sg.indeed.com)

**See MAXIMUM-SCRAPING-GUIDE.md for all 63 countries**

---

## 🔥 Power User Shortcuts

### **Fast Access**
- **Main Portal**: `http://localhost:8000/`
- **Multi-Country**: `http://localhost:8000/multi-country.html`
- **Global Search**: `http://localhost:8000/global-search.html`

### **Bookmarkable Searches**
```
Multi-Country Tech Jobs:
http://localhost:8000/multi-country.html#mode=multi&keyword=Software+Engineer&countries=US,UK,CA,AU

All Countries Data Science:
http://localhost:8000/multi-country.html#mode=all&keyword=Data+Scientist
```

---

## 📊 What You'll See

### **Summary Statistics**
```
🌍 [N] Countries Searched
✅ [N] Successful
🎯 [N] Total Jobs
```

### **Job Cards** (Each job shows:)
- 📝 **Title**: "Software Engineer - Senior"
- 🏢 **Company**: "Tech Innovations Inc."
- 📍 **Location**: "New York, NY"
- 💰 **Salary**: "$120K - $150K/year"
- 📄 **Description**: Brief job overview
- 🔗 **Link**: Direct link to Indeed job posting

---

## ⚠️ Troubleshooting

### **No Results?**
- Check keyword spelling
- Try broader terms (e.g., "Engineer" instead of "Senior Principal Staff Engineer")
- Verify country codes are correct

### **Slow Loading?**
- Reduce number of countries
- Try single/multi-country mode instead of All Countries
- Check internet connection

### **Jobs Not Relevant?**
- Add location for geo-filtering
- Use more specific job titles
- Try category search for industry focus

---

## 🎓 Learning Path

**Beginner:**
1. Start with main portal regular search
2. Try global search with categories
3. Experiment with single-country mode

**Intermediate:**
4. Use multi-country mode with 3-5 countries
5. Try different job categories
6. Add location filters

**Advanced:**
7. Use All Countries mode for market research
8. Compare salary ranges across countries
9. Analyze job market trends globally

---

## 📱 Mobile Usage

All pages are **fully responsive**:
- ✅ Works on phones and tablets
- ✅ Touch-friendly buttons
- ✅ Optimized layouts
- ✅ Fast loading even on 4G

---

## 🎉 Success Checklist

After using SAXZ Portal, you should be able to:
- [ ] Search 200 jobs in any country
- [ ] Compare jobs across multiple countries
- [ ] Browse by job category
- [ ] Find jobs in all 63 supported countries
- [ ] Access up to 12,600 jobs in one search
- [ ] View detailed job information
- [ ] Click through to Indeed for applications

---

## 🚀 Next Steps

1. **Try it now**: Search for your dream job!
2. **Explore categories**: Browse 20 different industries
3. **Go global**: Search across multiple countries
4. **Compare markets**: See salary differences worldwide
5. **Share results**: Help others find opportunities

---

## 📞 Need Help?

- 📖 **Full Docs**: See MAXIMUM-SCRAPING-GUIDE.md
- 🔍 **API Details**: Check api/parse-indeed.php comments
- 🌐 **Live Demo**: Open any .html file in browser

---

## ✨ Pro Tips

💡 **Market Research**: Use All Countries mode to see which regions have most opportunities  
💡 **Salary Comparison**: Search same role in different countries to compare compensation  
💡 **Job Trends**: Search periodically to track hiring trends  
💡 **Remote Work**: Add "Remote" to keyword for work-from-home opportunities  
💡 **Entry Level**: Use "Junior" or "Entry Level" keywords for career starters  

---

**Happy Job Hunting! 🎯**

*Your portal can now search **12,600 jobs** from **63 countries**!*

---

*Version: 2.0 - December 23, 2025*