Add sales automation stack: strategy docs, MCP scripts, PWA refinements

- SALES_STRATEGY.md: $1K/day plan (37 orders @ $27.50 AOV, 1,700 visits) - TRIPWIRE_FUNNEL.md: 7-email Mautic sequence + lead scoring - MONETIZATION.md: 9 monetization options for Nūr PWA (no ads, no registration) - EXECUTABLE_PLAN.md: MCP-executable automation plan - DAILY_OPS.md: daily KPI checklist (visits, orders, sends, recoveries) - scripts/: automation.py, mautic_setup.py, gumroad_setup.py, scout_scrape.py, analytics.py, crontab - quality_leads.json/.csv: 12 enriched Islamic-tech leads for Mautic import - content_queue.json: 10 SEO blog posts for Ghost - PWA: icons, sw.js, e2e + vitest coverage, generator scripts
2026-08-06 23:33:21 +08:00
parent 05991c893f
commit a440160249
40 changed files with 7195 additions and 173 deletions
@@ -0,0 +1,92 @@
+# FalahOS Sales Automation Scripts
+
+## Setup (One-Time)
+
+### 1. Install dependencies
+```bash
+cd /Users/wmj24/Desktop/nur-muslim-companion
+pip install requests beautifulsoup4 lxml PyJWT
+```
+
+### 2. Set environment variables
+```bash
+# Mautic (web session auth)
+export MAUTIC_BASE_URL=https://mautic.falahos.my
+export MAUTIC_ADMIN_USER=admin
+export MAUTIC_ADMIN_PW=<your-password>
+
+# Gumroad (API access)
+export GUMROAD_ACCESS_TOKEN=<from gumroad.com/applications>
+
+# Ghost (Admin API)
+export GHOST_ADMIN_API_KEY=<id:secret from ghost.falahos.my/ghost/settings/integrations>
+```
+
+### 3. One-time setup (run each once)
+```bash
+# Create Gumroad products
+python scripts/gumroad_setup.py
+
+# Create Mautic segment + emails + import contacts
+python scripts/mautic_setup.py
+
+# Verify content queue exists
+cat content_queue.json  # should have 10 posts
+```
+
+### 4. Install crontab
+```bash
+crontab scripts/crontab
+crontab -l  # verify
+```
+
+### 5. Test automation
+```bash
+python scripts/automation.py
+```
+
+## Scripts Reference
+
+| Script | Purpose | When to Run |
+|--------|---------|-------------|
+| `automation.py` | Main daily automation (mautic, gumroad, ghost, analytics) | Every 6 hours (cron) |
+| `mautic_setup.py` | Create segment, import contacts, create 7 emails | One-time |
+| `gumroad_setup.py` | Create 3 Gumroad products | One-time |
+| `scout_scrape.py` | Scrape 10 new GitHub leads weekly | Sunday (cron) |
+| `analytics.py` | Capture daily revenue/order snapshot | Daily (cron) |
+
+## MCP Usage
+
+| MCP | Used By | How |
+|-----|---------|-----|
+| **scout** | `scout_scrape.py` | Python `sys.path` import → direct function calls |
+| **mautic** | `mautic_setup.py`, `automation.py` | Python `sys.path` import → direct function calls |
+| **ghost** | `automation.py` | Ghost Admin API (HTTP) |
+| **gumroad** | `gumroad_setup.py`, `automation.py` | Gumroad REST API (HTTP) |
+| **openhands** | Manual | `npm run build && npm run preview` |
+
+## What's NOT Automated (Manual)
+
+| Task | Why | Frequency |
+|------|-----|-----------|
+| Social content creation | Requires creative judgment | 3x/day |
+| Community engagement (DMs, comments) | Requires human relationship | Daily |
+| B2B outreach to 12 quality leads | Requires personal touch | Weekly |
+| Product page copywriting | Requires marketing judgment | As needed |
+| Strategy review & adjustment | Requires human decision-making | Weekly |
+
+## Monitoring
+
+```bash
+# Check daily metrics
+tail -1 daily_metrics.jsonl | python -m json.tool
+
+# Check automation logs
+tail -f logs/automation.log
+
+# Check content queue remaining posts
+python -c "import json; q=json.load(open('content_queue.json')); print(f'{len(q)} posts remaining')"
+
+# Check quality leads count
+python -c "import json; l=json.load(open('quality_leads.json')); print(f'{len(l)} leads')"
+```