last_edit / README.md
Alinabil1's picture
feat: switch to Docker SDK with complete backend integration
d5f16a7
---
title: Moharek GEO Platform
emoji: πŸš€
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
---
# πŸš€ Ω…Ψ­Ψ±Ωƒ β€” Moharek GEO Platform
Ω…Ω†Ψ΅Ψ© ΨͺΨ­Ψ³ΩŠΩ† Ω…Ψ­Ψ±ΩƒΨ§Ψͺ Ψ§Ω„Ψ¨Ψ­Ψ« Ψ¨Ψ§Ω„Ψ°ΩƒΨ§Ψ‘ Ψ§Ω„Ψ§Ψ΅Ψ·Ω†Ψ§ΨΉΩŠ β€” AI-Powered Generative Engine Optimization Platform
## 🎯 Overview
Moharek GEO Platform is a comprehensive **Search Growth System** that combines 5 powerful engines to dominate every stage of the customer journey:
### The 5 Engines
1. **πŸ“ˆ SEO Engine** β€” Traditional search optimization (Google, Bing, Maps)
2. **πŸ€– AI Visibility Engine** β€” AI search optimization (ChatGPT, Gemini, Perplexity)
3. **🎯 Ads Engine** β€” Smart advertising & conversion optimization
4. **πŸ“ Content Engine** β€” Multi-channel content creation (TikTok, Instagram, YouTube)
5. **⭐ Trust Engine** β€” Reputation & review management
## ✨ Features
- πŸ” **Website Crawler & Auditor** β€” Deep analysis of your entire website
- πŸ“Š **GEO Score** β€” AI visibility scoring system
- πŸ”‘ **Keyword Extraction** β€” Smart keyword analysis with AI
- πŸ€– **AI Content Generation** β€” Powered by Groq & OpenAI
- πŸ’° **Paid Ads Dashboard** β€” Complete campaign management
- πŸ“‹ **JSON-LD Schema** β€” Automatic structured data generation
- πŸ“± **Mobile-Friendly Check** β€” PageSpeed & responsive analysis
- 🎯 **SERP Analysis** β€” Competitor ranking intelligence
- πŸ“ˆ **Action Plans** β€” Prioritized growth roadmaps
## πŸš€ Quick Start
### Using the Gradio Interface
1. Enter your website URL
2. Provide your organization name
3. Select number of pages to analyze
4. Click "Ψ§Ψ¨Ψ―Ψ£ Ψ§Ω„ΨͺΨ­Ω„ΩŠΩ„" (Start Analysis)
5. View results in real-time
### Accessing Full Dashboard
Click on **"افΨͺΨ­ Ω„ΩˆΨ­Ψ© Ψ§Ω„ΨͺΨ­ΩƒΩ…"** (Open Dashboard) to access the complete platform with:
- Real-time job monitoring
- Detailed analytics
- Content generation tools
- Competitor analysis
- Regional targeting
- And much more...
## πŸ› οΈ Technology Stack
- **Backend**: FastAPI + Python 3.12
- **Frontend**: HTML5 + CSS3 + Vanilla JS
- **AI**: Groq (Llama), OpenAI (GPT-4)
- **Search**: Tavily API, SerpAPI, Google Custom Search
- **Database**: SQLite + JSON storage
- **Deployment**: Hugging Face Spaces
## πŸ“‘ API Endpoints
### Core Endpoints
- `POST /api/jobs` β€” Create new analysis job
- `GET /api/jobs` β€” List all jobs
- `GET /api/jobs/{job_id}` β€” Get job details
- `GET /api/jobs/{job_id}/status` β€” Check job status
### Analysis Endpoints
- `POST /api/analyze` β€” Run full analysis
- `POST /api/keywords/extract` β€” Extract keywords
- `POST /api/content/generate` β€” Generate AI content
- `POST /api/schema/generate` β€” Generate JSON-LD schema
### Intelligence Endpoints
- `POST /api/tavily/search` β€” Deep search with Tavily
- `POST /api/competitor/analyze` β€” Competitor analysis
- `POST /api/serp/analyze` β€” SERP ranking analysis
### Full API Documentation
Visit `/api/docs` for complete interactive API documentation (Swagger UI)
## 🌍 Supported Languages
- Arabic (Ψ§Ω„ΨΉΨ±Ψ¨ΩŠΨ©) β€” Primary
- English β€” Full support
## 🎨 Design System
- **Primary Color**: Dark Teal (#0F4246)
- **Accent Color**: Neon Green (#c8f04e)
- **Secondary**: Cyan (#5fd4dc)
- **Typography**: Cairo (Arabic), Tajawal (Arabic)
## πŸ“Š Use Cases
### For Businesses
- πŸ₯ Medical clinics & healthcare
- πŸ” Restaurants & F&B
- 🏒 Real estate agencies
- πŸŽ“ Education & consulting
- πŸ›’ E-commerce stores
- πŸ’Ό B2B services
### For Agencies
- Complete white-label solution
- Multi-client management
- Automated reporting
- Scalable infrastructure
## πŸ” Environment Variables
```bash
# AI Services
GROQ_API_KEY=your_groq_key
OPENAI_API_KEY=your_openai_key
# Search Services
TAVILY_API_KEY=your_tavily_key
SERPAPI_KEY=your_serpapi_key
GOOGLE_API_KEY=your_google_key
GOOGLE_CSE_ID=your_cse_id
# Optional Services
DATAFORSEO_LOGIN=your_login
DATAFORSEO_PASSWORD=your_password
```
## πŸ“ˆ Performance
- ⚑ **Setup Time**: 48 hours
- πŸ“Š **Average Growth**: +320% in leads
- 🎯 **Success Rate**: 95%+ client satisfaction
- πŸš€ **Processing Speed**: 50+ pages/minute
## 🀝 Contributing
We welcome contributions! Please see our contributing guidelines.
## πŸ“„ License
MIT License - See LICENSE file for details
## πŸ“ž Contact
- 🌐 Website: [moharek.com](https://moharek.com)
- πŸ“§ Email: hello@moharek.com
- πŸ’¬ WhatsApp: [Contact Us](https://wa.me/201012345678)
## πŸ™ Acknowledgments
Built with ❀️ by the Moharek team
Powered by:
- Hugging Face Spaces
- Groq AI
- OpenAI
- Tavily Search
- And many other amazing open-source projects
---
**Β© 2025 Ω…Ψ­Ψ±Ωƒ β€” Moharek GEO Platform | Search Growth System**