block-detector

Detect and catalog web page content blocks using Puppeteer automation.

3|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/paolomoz/skills --skill block-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: block-detector
Source: https://github.com/paolomoz/skills/tree/main/skills/block-detector
Command: npx skills add https://github.com/paolomoz/skills --skill block-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires puppeteer, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps understand the layout and content hierarchy of web pages by automatically identifying and cataloging distinct content blocks.

Core Features & Use Cases

  • Block Detection: Identifies semantic sections, class-based patterns, and CMS-specific data attributes to find content blocks.
  • Selector Generation: Creates stable CSS selectors for each detected block for easy referencing.
  • Use Case: When analyzing a competitor's website, use this Skill to identify all hero sections, feature grids, and call-to-action blocks to understand their page composition.

Quick Start

Analyze the page structure of the provided URL to detect and catalog all content blocks.

Frequently Asked Questions about block-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect content blocks on a web page using Puppeteer?

You can detect content blocks on a web page using Puppeteer by applying semantic analysis, bounding box capture, and CSS selector generation to identify discrete page elements. This process catalogs distinct sections by analyzing semantic sections, class-based patterns, and CMS-specific data attributes.

What is the best way to analyze web page structure for content migration?

The best way to analyze web page structure for content migration is to automate browser control to identify semantic sections and generate stable CSS selectors. This catalogs the content hierarchy by capturing bounding boxes and detecting class-based patterns within the DOM.

How does CSS selector generation work for detected page elements?

CSS selector generation works by analyzing the DOM during browser automation to create stable references for each detected content block. It identifies semantic sections and CMS-specific data attributes, ensuring each discrete page element has a reliable selector for easy referencing.

Do I need Puppeteer to identify content blocks and semantic sections?

Yes, you need Puppeteer to identify content blocks because it provides the required browser control and DOM analysis capabilities. This dependency allows the tool to perform bounding box capture and semantic analysis to accurately catalog distinct page elements.

Can I use this approach to extract a competitor's hero sections and feature grids?

Yes, you can use this approach to extract a competitor's hero sections, feature grids, and call-to-action blocks. By analyzing web page structure and detecting semantic sections, it catalogs page composition to help you understand their layout and content hierarchy.

What are the limitations of using bounding box capture for web scraping?

A limitation of using bounding box capture for web scraping is that it relies on visual rendering through Puppeteer, which may miss dynamically loaded content or fail if page elements lack distinct semantic sections, class-based patterns, or CMS-specific data attributes.