last_edit / README.md
Alinabil1's picture
feat: switch to Docker SDK with complete backend integration
d5f16a7
metadata
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

# 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

πŸ™ 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