mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-04-27 09:46:25 +02:00
feat: enhance SurfSense with new skills, blog section, and improve SEO metadata
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
- Added multiple new skills to skills-lock.json from the repository `aaron-he-zhu/seo-geo-claude-skills`. - Introduced `fuzzy-search` dependency in package.json for improved search functionality. - Updated pnpm-lock.yaml to include the new `fuzzy-search` package. - Enhanced SEO metadata across various pages, including canonical links and descriptions for better search visibility. - Improved layout and structure of several components, including the homepage and changelog, to enhance user experience.
This commit is contained in:
parent
61b3f0d7e3
commit
7ea840dbb2
120 changed files with 25729 additions and 352 deletions
|
|
@ -0,0 +1,484 @@
|
|||
# Quotable Content Examples
|
||||
|
||||
Before/after examples of content optimized for AI citation. Each example shows the transformation from generic to quotable.
|
||||
|
||||
## Example 1: Definition Block
|
||||
|
||||
### Before (Generic, Not Quotable)
|
||||
|
||||
> SEO is really important for businesses and involves various techniques to improve visibility online through search engines. It's been around for a while and many businesses use it to get more traffic to their websites.
|
||||
|
||||
**Problems**:
|
||||
- Vague language ("really important", "various techniques")
|
||||
- No clear classification
|
||||
- Meandering structure
|
||||
- Not standalone
|
||||
|
||||
**Citation likelihood**: 1/10
|
||||
|
||||
---
|
||||
|
||||
### After (Clear, Quotable)
|
||||
|
||||
> **Search Engine Optimization (SEO)** is a digital marketing practice that improves website rankings in organic search results through content optimization, technical improvements, and authority building. According to BrightEdge research, organic search drives 53% of all website traffic, making SEO the highest-impact channel for sustainable online visibility.
|
||||
|
||||
**Improvements**:
|
||||
- Clear term + category classification
|
||||
- Specific components listed
|
||||
- Authoritative statistic with source
|
||||
- Standalone statement
|
||||
- Precise language
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 2: Statistical Content
|
||||
|
||||
### Before (Weak)
|
||||
|
||||
> Email marketing is pretty effective and lots of companies use it. It has a good return on investment compared to other marketing channels.
|
||||
|
||||
**Problems**:
|
||||
- No specific numbers
|
||||
- No source attribution
|
||||
- Vague comparisons ("pretty effective", "lots", "good")
|
||||
- Not verifiable
|
||||
|
||||
**Citation likelihood**: 2/10
|
||||
|
||||
---
|
||||
|
||||
### After (Strong)
|
||||
|
||||
> Email marketing delivers an average ROI of $42 for every $1 spent, according to the Data & Marketing Association's 2024 research. This 4,200% return makes email the highest-performing digital marketing channel, outperforming social media (28% ROI) and paid search (23% ROI) by significant margins.
|
||||
|
||||
**Improvements**:
|
||||
- Specific statistic with exact numbers
|
||||
- Source attribution with year
|
||||
- Comparative data
|
||||
- Verifiable claim
|
||||
- Context provided
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 3: Process/How-To Content
|
||||
|
||||
### Before (Unclear)
|
||||
|
||||
> To do keyword research, you should think about what your customers might search for and then use some tools to find more keywords. Look at what your competitors are doing too. Then pick the best keywords for your content.
|
||||
|
||||
**Problems**:
|
||||
- Vague steps ("think about", "some tools")
|
||||
- No clear structure
|
||||
- Missing specifics
|
||||
- No actionable guidance
|
||||
|
||||
**Citation likelihood**: 2/10
|
||||
|
||||
---
|
||||
|
||||
### After (Clear Process)
|
||||
|
||||
> To conduct effective keyword research:
|
||||
>
|
||||
> 1. **Identify seed keywords** - List 5-10 core topics your target audience searches for
|
||||
> 2. **Expand with research tools** - Use tools like Google Keyword Planner or Ahrefs to generate 100+ related keywords
|
||||
> 3. **Analyze search intent** - Categorize each keyword as informational, commercial, or transactional
|
||||
> 4. **Assess competition** - Evaluate ranking difficulty using domain authority and SERP analysis
|
||||
> 5. **Prioritize strategically** - Select 10-15 keywords balancing search volume (1,000+ monthly searches) with achievable competition
|
||||
>
|
||||
> This process typically takes 2-4 hours for a comprehensive initial keyword list.
|
||||
|
||||
**Improvements**:
|
||||
- Numbered, sequential steps
|
||||
- Specific actions in each step
|
||||
- Concrete numbers and tools
|
||||
- Time estimate included
|
||||
- Actionable guidance
|
||||
|
||||
**Citation likelihood**: 8/10
|
||||
|
||||
---
|
||||
|
||||
## Example 4: Comparison Content
|
||||
|
||||
### Before (Vague Comparison)
|
||||
|
||||
> WordPress and Shopify are both popular website builders. WordPress is more flexible while Shopify is easier to use. The choice depends on what you need.
|
||||
|
||||
**Problems**:
|
||||
- No specific differentiators
|
||||
- Vague claims ("more flexible", "easier")
|
||||
- No clear recommendation criteria
|
||||
- Not helpful for decision-making
|
||||
|
||||
**Citation likelihood**: 2/10
|
||||
|
||||
---
|
||||
|
||||
### After (Structured Comparison)
|
||||
|
||||
> | Factor | WordPress | Shopify |
|
||||
> |--------|-----------|---------|
|
||||
> | **Best for** | Content-heavy sites, blogs, custom needs | E-commerce, quick setup |
|
||||
> | **Setup time** | 4-8 hours | 1-2 hours |
|
||||
> | **Monthly cost** | $10-50 (hosting + theme) | $29-299 (subscription) |
|
||||
> | **Customization** | Unlimited (50,000+ plugins) | Limited to Shopify apps |
|
||||
> | **E-commerce** | Requires WooCommerce plugin | Built-in, optimized |
|
||||
> | **SEO control** | Complete control | Good but limited |
|
||||
>
|
||||
> **Choose WordPress if**: You need maximum flexibility, run a content-first site, or have technical resources.
|
||||
>
|
||||
> **Choose Shopify if**: E-commerce is your primary goal, you want fast setup, or you lack technical expertise.
|
||||
|
||||
**Improvements**:
|
||||
- Structured table format
|
||||
- Specific, comparable metrics
|
||||
- Clear use case recommendations
|
||||
- Quantifiable differences
|
||||
- Decision framework
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 5: Expert Content
|
||||
|
||||
### Before (No Authority)
|
||||
|
||||
> Many people think that social media is important for SEO. It can help you get more visibility and traffic.
|
||||
|
||||
**Problems**:
|
||||
- No expert attribution
|
||||
- Vague claims ("many people think")
|
||||
- No specific mechanism explained
|
||||
- Weak authority signals
|
||||
|
||||
**Citation likelihood**: 1/10
|
||||
|
||||
---
|
||||
|
||||
### After (Expert-Backed)
|
||||
|
||||
> While social media doesn't directly impact search rankings, it influences SEO through indirect channels. "Social signals drive discovery, which leads to backlinks and brand searches—both powerful ranking factors," explains Rand Fishkin, founder of SparkToro and former CEO of Moz. Research from Hootsuite found that content promoted on social media earns 2.3x more backlinks than non-promoted content within the first 30 days of publication.
|
||||
|
||||
**Improvements**:
|
||||
- Expert quote with credentials
|
||||
- Specific mechanism explained
|
||||
- Research data with source
|
||||
- Quantifiable impact (2.3x)
|
||||
- Authority signals
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 6: Q&A Content
|
||||
|
||||
### Before (Incomplete Answer)
|
||||
|
||||
> **How long does SEO take?**
|
||||
>
|
||||
> It depends on a lot of factors. Sometimes it's fast, sometimes it takes a while. New sites usually take longer than established ones.
|
||||
|
||||
**Problems**:
|
||||
- No specific timeframe
|
||||
- "It depends" without explaining what it depends on
|
||||
- Vague language ("fast", "a while", "longer")
|
||||
- Not actionable
|
||||
|
||||
**Citation likelihood**: 1/10
|
||||
|
||||
---
|
||||
|
||||
### After (Complete Answer)
|
||||
|
||||
> **How long does SEO take to show results?**
|
||||
>
|
||||
> SEO typically takes 3-6 months to show significant results for new websites. Established sites with existing authority may see improvements in 1-3 months for less competitive keywords. Results depend on four key factors:
|
||||
>
|
||||
> 1. **Domain authority** - New domains take 6-12 months; established domains see faster results
|
||||
> 2. **Competition level** - Low-competition keywords rank in 1-3 months; high-competition may take 12+ months
|
||||
> 3. **Implementation quality** - Comprehensive optimization accelerates results
|
||||
> 4. **Existing backlink profile** - Sites with 20+ quality backlinks see 40% faster improvements (Ahrefs study)
|
||||
>
|
||||
> Most businesses should budget 6 months for measurable ROI from SEO efforts.
|
||||
|
||||
**Improvements**:
|
||||
- Specific timeframes with ranges
|
||||
- Factors clearly explained
|
||||
- Differentiated by scenario
|
||||
- Supporting data with source
|
||||
- Actionable planning guidance
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 7: List Content
|
||||
|
||||
### Before (Thin List)
|
||||
|
||||
> Here are some important on-page SEO factors:
|
||||
> - Title tags
|
||||
> - Meta descriptions
|
||||
> - Headers
|
||||
> - Content
|
||||
> - Links
|
||||
> - Images
|
||||
|
||||
**Problems**:
|
||||
- No explanations
|
||||
- No prioritization
|
||||
- Not actionable
|
||||
- Missing context
|
||||
|
||||
**Citation likelihood**: 2/10
|
||||
|
||||
---
|
||||
|
||||
### After (Rich List)
|
||||
|
||||
> Critical on-page SEO factors ranked by impact:
|
||||
>
|
||||
> 1. **Title tags** - Most important on-page element; include primary keyword within first 60 characters. Title tags directly influence both rankings and CTR.
|
||||
>
|
||||
> 2. **Content quality and depth** - Comprehensive content (1,500+ words for competitive keywords) outranks thin content. Focus on topical authority over keyword density.
|
||||
>
|
||||
> 3. **Header structure (H1-H6)** - Use one H1 with primary keyword, multiple H2s for main sections. Proper hierarchy helps search engines understand content structure.
|
||||
>
|
||||
> 4. **Internal linking** - Link to 3-5 related pages using descriptive anchor text. Internal links distribute page authority and help search engines discover content.
|
||||
>
|
||||
> 5. **Image optimization** - Compress images to under 100KB, use descriptive alt text with target keywords. Page speed and accessibility both impact rankings.
|
||||
>
|
||||
> 6. **URL structure** - Use descriptive, keyword-rich URLs (example.com/keyword-topic) avoiding parameters. Clean URLs improve click-through rates by 25% (Backlinko study).
|
||||
>
|
||||
> Optimize these six factors before moving to advanced tactics.
|
||||
|
||||
**Improvements**:
|
||||
- Prioritized ranking
|
||||
- Specific guidance for each
|
||||
- Actionable recommendations
|
||||
- Supporting data
|
||||
- Clear next step
|
||||
|
||||
**Citation likelihood**: 8/10
|
||||
|
||||
---
|
||||
|
||||
## Example 8: Trend/Prediction Content
|
||||
|
||||
### Before (Speculation)
|
||||
|
||||
> AI is going to change SEO a lot in the future. Things will be different and SEO professionals will need to adapt.
|
||||
|
||||
**Problems**:
|
||||
- Vague predictions ("a lot", "different")
|
||||
- No specific changes identified
|
||||
- No timeframe
|
||||
- No evidence
|
||||
|
||||
**Citation likelihood**: 1/10
|
||||
|
||||
---
|
||||
|
||||
### After (Evidence-Based Trend)
|
||||
|
||||
> AI is fundamentally transforming SEO search behavior. According to Gartner's 2024 research, AI-powered search will reduce traditional search engine traffic by 25% by 2026, as users increasingly rely on AI chatbots for information.
|
||||
>
|
||||
> Three specific shifts SEO professionals must prepare for:
|
||||
>
|
||||
> 1. **Zero-click content consumption** - Users get answers without visiting websites, requiring optimization for AI citations rather than clicks
|
||||
>
|
||||
> 2. **Conversation-based queries** - Natural language questions replace keyword-based searches, demanding content that answers specific questions
|
||||
>
|
||||
> 3. **Source attribution value** - Being cited by AI systems (Generative Engine Optimization/GEO) becomes as important as ranking #1
|
||||
>
|
||||
> Forrester predicts that by 2025, 30% of organic traffic will come from AI system citations rather than traditional search results, making GEO optimization critical for visibility.
|
||||
|
||||
**Improvements**:
|
||||
- Specific statistics with sources
|
||||
- Clear timeframes
|
||||
- Concrete changes identified
|
||||
- Multiple research citations
|
||||
- Actionable implications
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 9: Technical Explanation
|
||||
|
||||
### Before (Complex, Unclear)
|
||||
|
||||
> Core Web Vitals are metrics that Google uses to measure user experience. They look at how fast your site loads and how stable it is when people use it. You should try to improve them.
|
||||
|
||||
**Problems**:
|
||||
- Oversimplified without specifics
|
||||
- No concrete metrics
|
||||
- Vague improvement guidance
|
||||
- Missing thresholds
|
||||
|
||||
**Citation likelihood**: 2/10
|
||||
|
||||
---
|
||||
|
||||
### After (Clear, Specific)
|
||||
|
||||
> Core Web Vitals are three specific metrics Google uses to measure page experience:
|
||||
>
|
||||
> | Metric | Measures | Good Score | Impact |
|
||||
> |--------|----------|------------|--------|
|
||||
> | **LCP (Largest Contentful Paint)** | Loading performance | <2.5 seconds | How quickly main content appears |
|
||||
> | **FID (First Input Delay)** | Interactivity | <100 milliseconds | How quickly page responds to user input |
|
||||
> | **CLS (Cumulative Layout Shift)** | Visual stability | <0.1 | How much content shifts during loading |
|
||||
>
|
||||
> According to Google's 2024 documentation, pages meeting all three thresholds rank higher and receive 24% more clicks than pages failing these metrics. Core Web Vitals became an official ranking factor in June 2021 as part of Google's Page Experience update.
|
||||
>
|
||||
> Test your Core Web Vitals with ~~page speed tool.
|
||||
|
||||
**Improvements**:
|
||||
- Three specific metrics defined
|
||||
- Clear thresholds provided
|
||||
- Table format for scannability
|
||||
- Official data with source
|
||||
- Testing tool referenced
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Example 10: Case Study Content
|
||||
|
||||
### Before (Vague Results)
|
||||
|
||||
> We improved our client's SEO and they got more traffic. They were really happy with the results and saw an increase in their business.
|
||||
|
||||
**Problems**:
|
||||
- No specific numbers
|
||||
- No timeframe
|
||||
- No methodology shared
|
||||
- Not reproducible
|
||||
|
||||
**Citation likelihood**: 1/10
|
||||
|
||||
---
|
||||
|
||||
### After (Data-Rich Case Study)
|
||||
|
||||
> **Case Study: 312% Organic Traffic Increase in 6 Months**
|
||||
>
|
||||
> **Client**: B2B SaaS company (project management software)
|
||||
>
|
||||
> **Challenge**: Only 450 monthly organic visitors, ranking #20+ for target keywords
|
||||
>
|
||||
> **Strategy implemented**:
|
||||
> 1. Created 24 pillar pages targeting high-intent keywords
|
||||
> 2. Built internal linking hub connecting 150 existing pages
|
||||
> 3. Optimized 80 existing pages for featured snippets
|
||||
> 4. Secured 45 high-authority backlinks through expert roundups
|
||||
>
|
||||
> **Results (6 months)**:
|
||||
> - Organic traffic: 450 → 1,854 monthly visitors (+312%)
|
||||
> - Keyword rankings: 3 keywords in top 10 → 47 keywords in top 10
|
||||
> - Featured snippets: 0 → 12 owned snippets
|
||||
> - Lead conversions: 8 → 41 monthly leads (+412%)
|
||||
>
|
||||
> **Key insight**: 80% of traffic growth came from optimizing existing content rather than creating new pages, demonstrating the power of content refreshing strategies.
|
||||
|
||||
**Improvements**:
|
||||
- Specific metrics with percentages
|
||||
- Clear timeframe
|
||||
- Detailed methodology
|
||||
- Reproducible tactics
|
||||
- Key learning identified
|
||||
|
||||
**Citation likelihood**: 9/10
|
||||
|
||||
---
|
||||
|
||||
## Transformation Checklist
|
||||
|
||||
To make any content more quotable:
|
||||
|
||||
**Definitions**:
|
||||
- [ ] Replace vague language with precise terms
|
||||
- [ ] Add clear category classification
|
||||
- [ ] Make statement standalone
|
||||
- [ ] Include scope and boundaries
|
||||
|
||||
**Statistics**:
|
||||
- [ ] Add specific numbers
|
||||
- [ ] Include source attribution
|
||||
- [ ] Specify timeframe/date
|
||||
- [ ] Add context for interpretation
|
||||
- [ ] Verify accuracy
|
||||
|
||||
**Processes**:
|
||||
- [ ] Number steps clearly
|
||||
- [ ] Make each step actionable
|
||||
- [ ] Add time estimates
|
||||
- [ ] Include specific tools/methods
|
||||
- [ ] Provide success criteria
|
||||
|
||||
**Comparisons**:
|
||||
- [ ] Use table format
|
||||
- [ ] Include specific, comparable metrics
|
||||
- [ ] Add "choose if..." recommendations
|
||||
- [ ] Quantify differences
|
||||
- [ ] Cover key decision factors
|
||||
|
||||
**Lists**:
|
||||
- [ ] Prioritize items
|
||||
- [ ] Add explanations to each
|
||||
- [ ] Include specific guidance
|
||||
- [ ] Provide examples
|
||||
- [ ] Make actionable
|
||||
|
||||
**Expert content**:
|
||||
- [ ] Add attributed quotes
|
||||
- [ ] Include credentials
|
||||
- [ ] Reference studies/research
|
||||
- [ ] Cite authoritative sources
|
||||
- [ ] Quantify claims
|
||||
|
||||
---
|
||||
|
||||
## Content Optimization Pattern
|
||||
|
||||
**Generic → Quotable transformation follows this pattern**:
|
||||
|
||||
1. **Add specificity** - Replace "many" with "73%", "fast" with "under 2.5 seconds"
|
||||
2. **Include attribution** - Add sources for all claims
|
||||
3. **Structure clearly** - Use tables, lists, numbered steps
|
||||
4. **Quantify everything** - Numbers > adjectives
|
||||
5. **Make standalone** - Each statement should work in isolation
|
||||
6. **Add context** - Explain why, not just what
|
||||
7. **Use precise language** - Eliminate ambiguity
|
||||
8. **Include timeframes** - When was this measured/true?
|
||||
9. **Show authority** - Reference experts, studies, data
|
||||
10. **Enable verification** - Link to sources, cite methodology
|
||||
|
||||
---
|
||||
|
||||
## Quick Quotability Test
|
||||
|
||||
Ask these questions about your content:
|
||||
|
||||
1. **Can AI quote this without additional context?** - If no, add context
|
||||
2. **Does it include specific numbers?** - If no, add data
|
||||
3. **Is the source clear?** - If no, add attribution
|
||||
4. **Is language precise and unambiguous?** - If no, clarify
|
||||
5. **Would an expert approve this?** - If no, add authority signals
|
||||
6. **Is it scannable?** - If no, add structure
|
||||
7. **Is it up-to-date?** - If no, update or add date context
|
||||
8. **Can it be verified?** - If no, add sources
|
||||
9. **Is it specific to a use case?** - If no, add context
|
||||
10. **Does it answer a complete question?** - If no, expand
|
||||
|
||||
If you answer "yes" to 8+ questions, content is highly quotable.
|
||||
If you answer "yes" to 5-7 questions, content is moderately quotable.
|
||||
If you answer "yes" to fewer than 5, content needs significant optimization.
|
||||
Loading…
Add table
Add a link
Reference in a new issue