feat(seo): add cluster identity signal to hardware series pages

Author: TechStack Global

add_cluster_signal.py

@@ -0,0 +1,49 @@
+import os
+import re
+
+files_to_update = [
+    "posts/best-remote-work-setup-2026.html",
+    "posts/budget-laptops-under-1000.html",
+    "posts/best-laptops-for-students-2026.html",
+    "posts/best-premium-laptop-for-work-2026.html",
+    "posts/do-you-need-thunderbolt-dock.html",
+    "posts/is-a-4k-monitor-worth-it.html",
+    "posts/is-samsung-990-pro-worth-it.html",
+]
+
+cluster_signal = '\n<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>'
+
+for file_path in files_to_update:
+    if not os.path.exists(file_path):
+        print(f"Missing: {file_path}")
+        continue
+        
+    with open(file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+        
+    if "cluster-signal" in content:
+        print(f"Already injected in: {file_path}")
+        continue
+
+    # Regex to find <p class="post-meta">...</p> and insert right after it.
+    # We account for the fact that some pages might not have it exactly matching.
+    # We can also look for <span class="badge">...</span> and <h1 class="post-title">...</h1>
+    
+    # We will look for <p class="post-meta">....</p>
+    pattern = r'(<p class="post-meta">.*?</p>)'
+    
+    # In budget-laptops-under-1000.html, there's no post-meta!
+    # Let's check where to inject if post-meta is missing.
+    if re.search(pattern, content):
+        new_content = re.sub(pattern, r'\1' + cluster_signal, content, count=1)
+    else:
+        # If no post-meta, insert after post-title
+        pattern_title = r'(<h1 class="post-title">.*?</h1>)'
+        new_content = re.sub(pattern_title, r'\1' + cluster_signal, content, count=1)
+        
+    if new_content != content:
+        with open(file_path, "w", encoding="utf-8") as f:
+            f.write(new_content)
+        print(f"Injected in: {file_path}")
+    else:
+        print(f"Failed to inject in: {file_path}")

crawl_depth_test.py

@@ -0,0 +1,67 @@
+import os
+from bs4 import BeautifulSoup
+from collections import deque
+import urllib.parse
+
+def clean_link(link):
+    if not link:
+        return None
+    link = link.split('#')[0]
+    link = link.split('?')[0]
+    if link.startswith('http') or link.startswith('mailto:') or link.startswith('tel:'):
+        return None
+    return link
+
+def build_graph(root_dir='.'):
+    graph = {}
+    for root, dirs, files in os.walk(root_dir):
+        if '.git' in root or '.venv' in root:
+            continue
+        for file in files:
+            if file.endswith('.html'):
+                abs_path = os.path.abspath(os.path.join(root, file))
+                rel_path = os.path.relpath(abs_path, root_dir).replace('\\', '/')
+                graph[rel_path] = []
+                with open(abs_path, 'r', encoding='utf-8') as f:
+                    soup = BeautifulSoup(f.read(), 'html.parser')
+                    for a in soup.find_all('a', href=True):
+                        link = clean_link(a['href'])
+                        if not link:
+                            continue
+                        target_abs = os.path.normpath(os.path.join(root, link))
+                        target_rel = os.path.relpath(target_abs, root_dir).replace('\\', '/')
+                        if os.path.exists(target_abs) and target_rel.endswith('.html'):
+                            graph[rel_path].append(target_rel)
+    return graph
+
+def check_depth(graph, start='index.html'):
+    if start not in graph:
+        print(f"Start node {start} not found.")
+        return
+    
+    distances = {start: 0}
+    queue = deque([start])
+    
+    while queue:
+        current = queue.popleft()
+        for neighbor in graph.get(current, []):
+            if neighbor not in distances:
+                distances[neighbor] = distances[current] + 1
+                queue.append(neighbor)
+                
+    unreachable = [node for node in graph if node not in distances]
+    
+    print("=== CRAWL DEPTH REPORT (FROM index.html) ===")
+    for node, dist in sorted(distances.items(), key=lambda x: x[1]):
+        print(f"Depth {dist}: {node}")
+        
+    print("\n=== UNREACHABLE (ORPHAN) HTML PAGES ===")
+    if unreachable:
+        for u in unreachable:
+            print(f"- {u}")
+    else:
+        print("None! All HTML pages are reachable.")
+
+if __name__ == '__main__':
+    graph = build_graph()
+    check_depth(graph)

posts/best-laptops-for-students-2026.html

@@ -37,6 +37,7 @@
 </div>
 <span class="badge">Student Tech Hub</span>
 <h1 class="post-title">Best Laptops for Students 2026: From Budget to Premium</h1>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
 <div class="tldr-verdict glass-card" style="padding: 1.5rem; border-left: 4px solid var( accent); background: rgba(0,255,157,0.05); margin-bottom: 2rem;">
 <strong>Quick Summary:</strong> Choosing a student laptop in 2026 is about balancing 12+ hour battery
  life with the ability to handle AI-integrated coursework. For most students, the <strong>MacBook Air

posts/best-premium-laptop-for-work-2026.html

@@ -85,6 +85,7 @@ <h1 class="post-title">Best Premium Laptop for Work in 2026: MacBook vs Dell vs
 </p>
 
 <p class="post-meta">Published on <span id="date">February 27, 2026</span> • 7 min read</p>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
 <p>Choosing a reliable laptop used to mean picking whatever felt sturdy and had a decent enough keyboard.
  But today, the demands of remote work, software development, and digital creation require a machine that
  doesn't just survive the workday it actively enhances your workflow.</p>

posts/best-remote-work-setup-2026.html

@@ -75,6 +75,7 @@
       <span class="badge">Ecosystem Hub</span>
       <h1 class="post-title">The Best Remote Work Setup Formula for 2026</h1>
       <p class="post-meta">Published on <span id="date">February 27, 2026</span></p>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
       <p>Welcome to the ultimate guide for building a seamless, hyper-productive home office. You don’t need
         dozens of gimmicky gadgets to be productive. You need a concise, powerful core stack that "just works."
       </p>

posts/budget-laptops-under-1000.html

@@ -53,6 +53,7 @@
       </div>
       <span class="badge">Budget Picks 2026</span>
       <h1 class="post-title">Best Budget Laptops Under $1000: Real Value for Real Work</h1>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
       <div class="tldr-verdict glass-card"
         style="padding: 1.5rem; border-left: 4px solid var( accent); background: rgba(0,255,157,0.05); margin-bottom: 2rem;">
         <strong>TL;DR:</strong> You don't need to spend $2,000 for a pro-level experience. The <strong>MacBook

posts/do-you-need-thunderbolt-dock.html

@@ -86,6 +86,7 @@
       <span class="badge">Buying Guide</span>
       <h1 class="post-title">Do You Really Need a Thunderbolt Dock for Remote Work?</h1>
       <p class="post-meta">Published on <span id="date">February 27, 2026</span> • 6 min read</p>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
 
       <!-- Internal: top related links -->
       <p class="internal-top-links" style="margin-top:0.8rem;font-size:0.95rem;">

posts/is-a-4k-monitor-worth-it.html

@@ -78,6 +78,7 @@ <h1 class="post-title">Is a 4K Monitor Worth It for Remote Work in 2026?</h1>
 </p>
 
 <p class="post-meta">Published on <span id="date">February 27, 2026</span> • 6 min read</p>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
 <p>If you've spent the last few years hunching over a 14-inch laptop screen, or squinting at a decade-old
  1080p monitor, you've probably felt the daily fatigue setting in. You might be considering an upgrade as
  part of your <a href="best-remote-work-setup-2026.html" style="color:var( accent)">Remote Work

posts/is-samsung-990-pro-worth-it.html

@@ -96,6 +96,7 @@ <h1 class="post-title">Is Samsung 990 PRO Worth It? Gen4 SSD vs Standard NVMe Ex
       </p>
 
       <p class="post-meta">Published on <span id="date">February 27, 2026</span> • 5 min read</p>
+<p class="cluster-signal" style="font-style: italic; font-size: 0.92rem; color: #a1a1aa; margin-top: -0.5rem; margin-bottom: 1.5rem;">This guide is part of our <a href="/posts/best-remote-work-setup-2026.html" style="color: var(--accent); text-decoration: underline;">Remote Work Hardware Series</a>.</p>
       <p>If you've been looking to upgrade your computer’s storage, you’ve probably stared at the <a
           href="samsung-990-pro-ssd-review.html" style="color:var( accent)">Samsung 990 PRO</a> and wondered:
         "Is it really worth paying a premium for extreme speeds?"</p>