Update README.md

README.md

@@ -1,12 +1,212 @@
 ---
-title: Content Funnel Strategist
-emoji: 🦀
-colorFrom: purple
-colorTo: blue
+title: B2B Content Strategy Planner
+emoji: 🚀
+colorFrom: indigo
+colorTo: purple
 sdk: gradio
-sdk_version: 6.5.1
+sdk_version: 4.44.0
 app_file: app.py
 pinned: false
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🚀 B2B Content Strategy Planner
+
+A comprehensive tool for analyzing website content, identifying funnel gaps, and generating AI-powered content ideas.
+
+## ✨ Features
+
+### 1. **Sitemap Analysis**
+- Import sitemaps from any website
+- Automatic content categorization
+- Support for sitemap indexes and nested sitemaps
+- CORS proxy fallback for accessibility
+
+### 2. **Advanced Topic Matching**
+- **Three Matching Modes:**
+  - **Exact**: Precise URL matching
+  - **Fuzzy**: Balanced scoring with variants (recommended)
+  - **Semantic**: Expanded matching with topic packs
+- **Synonym Support**: Add alternative terms for comprehensive coverage
+- **Negative Keywords**: Exclude unwanted content
+- **Topic Packs**: Pre-defined libraries for 14+ tech domains
+
+### 3. **Funnel Gap Analysis**
+- Classify content into TOFU/MOFU/BOFU stages
+- Visual distribution percentages
+- Identify weakest funnel stages
+- Actionable recommendations
+- Category breakdown by stage
+
+### 4. **AI Content Generation**
+- Stage-specific content ideas
+- Multiple format suggestions (Blog, Whitepaper, Case Study, etc.)
+- Performance predictions
+- SEO-optimized titles and descriptions
+
+## 🎯 How to Use
+
+### Step 1: Import Sitemap
+1. Enter your website's sitemap URL (e.g., `https://example.com/sitemap.xml`)
+2. Alternatively, just enter the domain (e.g., `example.com`)
+3. Click **"🔍 Fetch Sitemap"**
+4. Wait for automatic categorization
+
+### Step 2: Select Topic & Filters
+1. **Choose a Category** from the dropdown (auto-populated from sitemap)
+2. **Select a Topic** within that category
+3. **OR** enter **Custom Keywords** to override
+4. **Set Funnel Stage** filter (ALL, TOFU, MOFU, BOFU)
+5. **Choose Matching Strategy**:
+   - **Exact**: Strict matching, fewer results
+   - **Fuzzy**: Balanced (recommended)
+   - **Semantic**: Comprehensive, more results
+
+#### Advanced Options
+- **Synonyms**: Add alternative terms (one per line)
+- **Negative Keywords**: Exclude terms (comma-separated)
+- **Strict Mode**: Only match within category path
+
+### Step 3: Analyze Content
+1. Click **"📊 Analyze Content Distribution"**
+2. Review funnel breakdown (TOFU/MOFU/BOFU percentages)
+3. Check recommendations for weak stages
+4. View matched URLs in the accordion
+
+### Step 4: Generate Ideas
+1. Click **"✨ Generate AI Content Ideas"**
+2. Review stage-specific content suggestions
+3. Note formats, topics, and implementation tips
+4. Export ideas for your content team
+
+## 📊 Funnel Classification
+
+### TOFU (Top of Funnel - Awareness)
+- Blog posts
+- General educational content
+- Trend articles
+
+### MOFU (Middle of Funnel - Consideration)
+- Whitepapers
+- Webinars
+- Guides
+- eBooks
+
+### BOFU (Bottom of Funnel - Decision)
+- Case studies
+- Customer success stories
+- Product comparisons
+- Demos
+
+## 🔍 Matching Strategies
+
+### Exact Mode
+- Matches only exact keyword occurrences
+- Best for: Specific, well-defined topics
+- Example: "azure-devops" matches only `/azure-devops/` paths
+
+### Fuzzy Mode (Recommended)
+- Balanced scoring with keyword variants
+- Handles hyphens, spaces, compound terms
+- Best for: Most use cases
+- Example: "data analytics" matches "data-analytics", "dataanalytics", "analytics"
+
+### Semantic Mode
+- Expands to related terms from topic packs
+- Partial matching with scoring
+- Best for: Comprehensive topic coverage
+- Example: "cloud" matches "aws", "azure", "gcp", "cloud-computing", "saas"
+
+## 🎯 Topic Packs
+
+Pre-configured keyword libraries for:
+
+- **Data & Analytics**: analytics, BI, dashboards, data visualization
+- **Data Engineering**: ETL, pipelines, data warehouses, Spark, Kafka
+- **Cloud**: AWS, Azure, GCP, cloud migration, multi-cloud
+- **DevOps**: CI/CD, Docker, Kubernetes, Terraform, Ansible
+- **Mobile & Web**: iOS, Android, React, Vue, Node.js
+- **AI & ML**: machine learning, deep learning, NLP, computer vision
+- **Industry**: FinTech, HealthTech, AdTech, IoT
+
+## 💡 Example Use Cases
+
+### 1. Content Gap Analysis
+Find missing content in your marketing funnel:
+1. Import sitemap
+2. Analyze major topics
+3. Identify weak stages
+4. Generate ideas for gaps
+
+### 2. Topic Research
+Discover what content exists for new topics:
+1. Enter custom keywords
+2. Use Semantic matching
+3. Review matched URLs
+4. Identify coverage gaps
+
+### 3. SEO Content Planning
+Build a comprehensive content strategy:
+1. Analyze all major topics
+2. Compare funnel distributions
+3. Prioritize BOFU content
+4. Create content calendar
+
+## 🚀 Quick Start Examples
+
+### Example 1: Analyze Cloud Computing Content
+```
+Sitemap: yourcompany.com
+Category: Blog
+Topic: Cloud Computing
+Matching: Fuzzy
+Result: 28 URLs (64% TOFU, 25% MOFU, 11% BOFU)
+Action: Create 3 case studies (BOFU gap)
+```
+
+### Example 2: Advanced DevOps Search
+```
+Keywords: kubernetes
+Synonyms: k8s, container orchestration
+Negative: careers, jobs
+Matching: Semantic
+Result: 31 URLs with comprehensive coverage
+```
+
+## 🛠️ Technical Stack
+
+- **Framework**: Gradio 4.44.0
+- **Language**: Python 3.8+
+- **Dependencies**: requests (HTTP client)
+- **Deployment**: Hugging Face Spaces
+
+## 📈 Roadmap
+
+- [ ] Real AI model integration (GPT-4, Claude)
+- [ ] Competitor analysis
+- [ ] Export to CSV/PDF
+- [ ] Content performance tracking
+- [ ] Advanced visualizations
+- [ ] Database persistence
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - feel free to use for commercial purposes.
+
+## 🔗 Links
+
+- **GitHub**: [View Source Code](#)
+- **Demo**: Try it on Hugging Face Spaces
+- **Documentation**: See About tab in app
+
+## 💬 Feedback
+
+Found a bug or have a feature request? Please open an issue on GitHub.
+
+---
+
+**Built with ❤️ for B2B marketers**