seo-best-practices

# SEO Best Practices ## Purpose This skill provides guidance for search engine optimization (SEO) of the CIA platform, ensuring political transparency content ranks well in search results while maintaining accessibility, performance, and GDPR compliance. ## When to Use ### ✅ Use this skill when: - Optimizing content for search engines - Improving site structure and navigation - Implementing schema markup - Analyzing keyword opportunities - Improving page load performance - Creating content strategy - Building backlink strategies - Conducting technical SEO audits ### ❌ Don't use this skill for: - Social media marketing (use social-media-management) - Content creation (use content-marketing-strategies) - UI design (use vaadin-component-design) - Security (use secure-code-review) ## Patterns & Examples ### On-Page SEO Checklist ```html <!DOCTYPE html> <html lang="sv"> <head> <!-- Title tag (50-60 characters) --> <title>Politiker Risk analys - Citizen Intelligence Agency</title> <!-- Meta description (150-160 characters) --> <meta name="description" content="Analysera svenska politikers riskpoäng, röstningsbeteende och finansiella kopplingar. Oberoende politisk transparens och OSINT-analys."> <!-- Canonical URL --> <link rel="canonical" href="https://www.hack23.com/cia/politician/risk-analysis"> <!-- Open Graph for social sharing --> <meta property="og:title" content="Politiker Risk analys"> <meta property="og:description" content="Oberoende analys av svenska politiker"> <meta property="og:image" content="https://www.hack23.com/cia/images/risk-dashboard.png"> <meta property="og:url" content="https://www.hack23.com/cia/politician/risk-analysis"> <meta property="og:type" content="website"> <!-- Schema.org structured data --> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebApplication", "name": "Citizen Intelligence Agency", "description": "Political transparency platform for Swedish democracy", "url": "https://www.hack23.com/cia/", "applicationCategory": "Political Analysis", "operatingSystem": "Web", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "EUR" } } </script> </head> <body> <!-- Header with proper hierarchy --> <header> <h1>Politiker Risk analys</h1> </header> <main> <!-- Content with semantic HTML --> <article> <h2>Vad är riskpoäng?</h2> <p>Riskpoäng är en kvantitativ bedömning...</p> </article> </main> </body> </html> ``` ### Keyword Research Strategy ```markdown ## Target Keywords for CIA Platform ### Primary Keywords (High volume, high intent): - "svenska politiker" (Swedish politicians) - 8,100/month - "riksdagen ledamöter" (parliament members) - 2,400/month - "politisk transparens" (political transparency) - 880/month - "politiker röstning" (politician voting) - 720/month ### Long-tail Keywords (Lower volume, high intent): - "politiker riskbedömning" (politician risk assessment) - 90/month - "finansiella kopplingar politiker" (financial connections politicians) - 50/month - "riksdagen omröstningar" (parliament votes) - 320/month - "politikers bisysslor" (politicians' side jobs) - 140/month ### Informational Keywords: - "hur fungerar riksdagen" (how parliament works) - 1,600/month - "vad gör en riksdagsledamot" (what does an MP do) - 880/month - "svensk politik för dummies" (Swedish politics for dummies) - 260/month ## Content Strategy: 1. Create pillar pages for primary keywords 2. Build topic clusters around each pillar 3. Internal linking between related content 4. Regular updates (freshness signal) 5. Answer boxes optimization (featured snippets) ``` ### Technical SEO Requirements ```xml <!-- sitemap.xml --> <?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> <url> <loc>https://www.hack23.com/cia/</loc> <lastmod>2026-02-06</lastmod> <changefreq>daily</changefreq> <priority>1.0</priority> </url> <url> <loc>https://www.hack23.com/cia/politician/list</loc> <lastmod>2026-02-06</lastmod> <changefreq>daily</changefreq> <priority>0.9</priority> </url> <!-- More URLs --> </urlset> ``` ```text # robots.txt User-agent: * Allow: / Disallow: /admin/ Disallow: /api/ Disallow: /*?* # No query string URLs Sitemap: https://www.hack23.com/cia/sitemap.xml ``` ### Performance Optimization for SEO ```java // Vaadin - Code splitting and lazy loading @Route(value = "politician", layout = MainLayout.class) @PreserveOnRefresh public class PoliticianView extends VerticalLayout implements HasUrlParameter<String> { @Override public void setParameter(BeforeEvent event, @OptionalParameter String parameter) { // Lazy load heavy components if (parameter != null) { addAttachListener(e -> loadPoliticianDetails(parameter)); } } private void loadPoliticianDetails(String id) { // Load asynchronously to improve initial page load UI.getCurrent().access(() -> { Politician politician = politicianService.findById(id); add(createPoliticianProfile(politician)); }); } } ``` ### Core Web Vitals Targets ```markdown ## Performance Metrics (Google PageSpeed Insights) ### Largest Contentful Paint (LCP) - Target: < 2.5 seconds - Current: 2.1 seconds ✅ - Optimization: CDN, image optimization, code splitting ### First Input Delay (FID) - Target: < 100 milliseconds - Current: 45 milliseconds ✅ - Optimization: Minimize JavaScript execution ### Cumulative Layout Shift (CLS) - Target: < 0.1 - Current: 0.05 ✅ - Optimization: Size attributes on images, reserve space for dynamic content ### First Contentful Paint (FCP) - Target: < 1.8 seconds - Current: 1.2 seconds ✅ ### Time to Interactive (TTI) - Target: < 3.8 seconds - Current: 3.1 seconds ✅ ``` ## ISMS Compliance Mapping ### ISO 27001:2022 Annex A Controls **A.5.37 - Documented operating procedures** - Document SEO processes and standards - Maintain content guidelines ### GDPR Considerations **Article 5 - Principles** - Data minimization in meta tags - No personal data in URLs - Privacy-friendly analytics (no tracking without consent) **Article 13 - Information to be provided** - Clear information about data collection in privacy policy - Cookie consent for analytics ## Hack23 ISMS Policy References - [Information Security Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md) - Privacy in SEO practices ## References ### SEO Resources - [Google Search Central](https://developers.google.com/search) - [Moz SEO Learning Center](https://moz.com/learn/seo) - [Ahrefs Blog](https://ahrefs.com/blog/) ### Tools - Google Search Console - Google PageSpeed Insights - Screaming Frog SEO Spider ## Remember - **Content is king**: Quality content ranks well - **Mobile-first**: Optimize for mobile devices - **Page speed matters**: Core Web Vitals are ranking factors - **Privacy compliance**: GDPR-friendly analytics only - **Political neutrality**: SEO content maintains platform neutrality - **Structured data**: Schema.org markup for rich results